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
38       -V     Displays the version and exits.
39
40       -a     Download  fcc.blacklist and add to ncidd.blacklist.  This is the
41              default action.
42
43       -n     Download fcc.blacklist but do not add to  ncidd.blacklist.   The
44              downloaded file is ready to use with hangup-fcc.
45
46       -r     Same  as  -n  but is a special remove-only option to remove "FCC
47              bad list" lines from ncidd.blacklist.  Use this option once when
48              you are transitioning from ncidd.blacklist to hangup-fcc.
49

REQUIREMENTS

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

FILES

72       /usr/share/ncid/sys/get-fcc-list
73       /etc/ncid/fcc.blacklist
74       /etc/ncid/ncidd.blacklist
75       /var/backups/ncid/
76

SEE ALSO

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