hangup-fcc - Man Page

Synopsis

hangup-fcc [-h]
hangup-fcc [-v] <string>

where string is in this format:
*DATE*<mmddyyyy>*TIME*<hhmm>*LINE*<lineid>\
*NMBR*<number>*NAME*<name>*MODE*<hupmode>\
*FNMBR*<formatted number>*NTYPE*<type of device>\
*CTRY*<country code>*LOCA*<location>*CARI*<carrier>\
*NAME*<name>*

Description

hangup-fcc hangs up on calls where the number can be found in the FCC's open data list of "Unwanted Calls".

Script is not called if caller number or name is in ncidd.whitelist.

The blacklist is stored locally in prefix3=/etc/ncid/fcc.blacklist and is typically updated daily by a cron job that calls get-fcc-list hangup-fcc to fetch the latest version from a web site.

Make sure you 'set hupmode = 1|2|3' in ncidd.conf.  The ncidd server does not call this script if the caller number or name is in ncidd.whitelist.

Server hangup extensions are only executed by the server unless testing.

Options

-h

show help message

-v

turn on verbose and send additional data to STDOUT for troubleshooting

Requirements

Set hupname to the name of this script ncidd.conf.
Set hupmode to 1, 2 or 3 in ncidd.conf.
Set huprmd to a unique voice file in ncidd.conf, if hupmode set to 3.

Create the fcc.blacklist file, which has the list of numbers, from the FCC "Unwanted Calls" complaints data.

The fcc.blacklist file can be kept up-to-date by adding a daily call to get-fcc-list hangup-fcc in the root user's crontab. (See the documentation for get-fcc-list for more information.)

Files

/usr/share/ncid/extensions/hangup-fcc
/usr/share/ncid/recording/*.rmd
prefix3=/etc/ncid/ncidd.conf
prefix3=/etc/ncid/ncidd.whitelist
prefix3=/etc/ncid/fcc.blacklist
:fi

See Also

ncidd(8), get-fcc-list(1), ncidd.whitelist(5), hangup-calls(1), hangup-closed-skel(1), hangup-skel(1)

Referenced By

get-fcc-list(1), hangup-combo(1), hangup-nohangup(1), ncid_extensions(7).

2021-05-11 NCID