Content-type: text/html Manpage of GET-FCC-LIST

GET-FCC-LIST

Section: NCID (1)
Updated: 2019-08-17
Index Return to Main Contents
 

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/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
/etc/ncid/fcc.blacklist
/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


 

Index

NAME
SYNOPSIS
DESCRIPTION
OPTIONS
REQUIREMENTS
FILES
SEE ALSO

This document was created by man2html, using the manual pages.
Time: 18:17:41 GMT, November 12, 2022