NAME

get-fcc-list - fetch the latest fcc.blacklist derived from FCC Complaints data

SYNOPSIS

get-fcc-list [-h] [-V] [-a|-n|-r]

DESCRIPTION

The get-fcc-list script uses wget to fetch the fcc.blacklist file from http://ncid-utils.ca/fcc.blacklist. The fcc.blacklist is a list of phone numbers taken from the Unwanted Calls - FCC Complaints open database.

You will want to call it as often as once a day from cron on Linux/Unix/Mac OS X.

Once downloaded, fcc.blacklist can be used with NCID in one of two ways:

1: hangup-fcc: The External Hangup Extension script hangup-fcc can read fcc.blacklist directly.
2: ncidd.blacklist: The contents of fcc.blacklist are reformatted by get-fcc-list and appended to ncidd.blacklist. Before being modified, a backup of the current ncidd.blacklist is saved to /var/backups/ncid.

OPTIONS

-h: Prints this help and exits.
-V: Displays the version and exits.
-a: Download fcc.blacklist and add to ncidd.blacklist. This is the default action.
-n: Download fcc.blacklist but do not add to ncidd.blacklist. The downloaded file is ready to use with hangup-fcc.
-r: Same as -n but is a special remove-only option to remove "FCC bad list" lines from ncidd.blacklist. Use this option once when you are transitioning from ncidd.blacklist to hangup-fcc.

REQUIREMENTS

NCID:: release 1.7 or newer
wget:: fetches files using http
pkill:: send signal to all running ncidd servers to reload alias, blacklist and whitelist
root crontab:: Runs get-fcc-list at specific times and days. The root crontab can be edited with sudo crontab -e to add something like the following examples which write a log file to /tmp:

Internal Hangup - append (-a) FCC Data to `ncidd.blacklist`

# run each day at 08:15
15 08 * * * /usr/local/share/ncid/sys/get-fcc-list -a > /tmp/get-fcc-list.log 2>&1

Hangup Extension - do not append (-n), use `fcc.blacklist` as-is

# run each day at 08:15
15 08 * * * /usr/local/share/ncid/sys/get-fcc-list -n > /tmp/get-fcc-list.log 2>&1

FILES