get-fcc-list - Man Page
fetch the latest fcc.blacklist derived from FCC Complaints data
Synopsis
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/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/share/ncid/sys/get-fcc-list -n > /tmp/get-fcc-list.log 2>&1
Files
/usr/share/ncid/sys/get-fcc-list prefix3=/etc/ncid/fcc.blacklist prefix3=/etc/ncid/ncidd.blacklist /var/backups/ncid/
See Also
hangup-fcc(1), wget(1), ncidd(8), crontab(5)
https://consumercomplaints.fcc.gov/hc/en-us/articles/115002234203-Unwanted-Calls