1GET-FCC-LIST(1)                      NCID                      GET-FCC-LIST(1)
2
3
4

NAME

6       get-fcc-list  -  fetch  the  latest fcc.blacklist derived from FCC Com‐
7       plaints data
8

SYNOPSIS

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

DESCRIPTION

13       The get-fcc-list script uses wget to fetch the fcc.blacklist file  from
14       http://ncid-utils.ca/fcc.blacklist.   The  fcc.blacklist  is  a list of
15       phone numbers taken from the Unwanted Calls - FCC Complaints open data‐
16       base.
17
18       You  will  want  to  call  it  as  often  as  once  a  day from cron on
19       Linux/Unix/Mac OS X.
20
21
22       Once downloaded, fcc.blacklist can be used with  NCID  in  one  of  two
23       ways:
24
25       1: hangup-fcc
26              The   External  Hangup  Extension  script  hangup-fcc  can  read
27              fcc.blacklist directly.
28
29       2: ncidd.blacklist
30              The contents of fcc.blacklist are  reformatted  by  get-fcc-list
31              and  appended  to  ncidd.blacklist.   Before  being  modified, a
32              backup of the current ncidd.blacklist  is  saved  to  /var/back‐
33              ups/ncid.
34

OPTIONS

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

REQUIREMENTS

47       NCID:  release 1.7 or newer
48
49       wget:  fetches files using http
50
51       pkill: send signal to all running ncidd servers to reload alias, black‐
52              list and whitelist
53
54       root crontab:
55              Runs get-fcc-list at specific times and days.  The root  crontab
56              can  be  edited  with  sudo crontab -e to add something like the
57              following examples which write a log file to /tmp:
58
59              Internal Hangup - append (-a) FCC Data to `ncidd.blacklist`
60              # run each day at 08:15
61              15 08 * * * /usr/share/ncid/sys/get-fcc-list -a > /tmp/get-fcc-list.log 2>&1
62
63              Hangup Extension - do not append (-n), use `fcc.blacklist` as-is
64              # run each day at 08:15
65              15 08 * * * /usr/share/ncid/sys/get-fcc-list -n > /tmp/get-fcc-list.log 2>&1
66

FILES

68       /usr/share/ncid/sys/get-fcc-list
69       /etc/ncid/fcc.blacklist
70       /etc/ncid/ncidd.blacklist
71       /var/backups/ncid/
72

SEE ALSO

74       hangup-fcc.1, wget.1, ncidd.8, crontab.5
75       https://consumercomplaints.fcc.gov/hc/en-us/articles/115002234203-Unwanted-Calls
76
77
78
79NCID                              2019-08-17                   GET-FCC-LIST(1)
Impressum