1HANGUP-FAKENUM(1)                    NCID                    HANGUP-FAKENUM(1)
2
3
4

NAME

6       hangup-fakenum
7

SYNOPSIS

9       hangup-fakenum [-h]
10       hangup-fakenum [-v] <string>
11
12              where string is in this format:
13              *DATE*<mmddyyyy>*TIME*<hhmm>*LINE*<lineid>\
14              *NMBR*<number>*NAME*<name>*MODE*<hupmode>\
15              *FNMBR*<formatted number>*NTYPE*<type of device>\
16              *CTRY*<country code>*LOCA*<location>*CARI*<carrier>\
17              *NAME*<name>*
18

DESCRIPTION

20       hangup-fakenum  checks  for valid North American number plan callers as
21       described     by     the     North     Americal     Numbering      Plan
22       ⟨https://en.wikipedia.org/wiki/North_American_Numbering_Plan⟩.
23
24       Script is not called if caller number or name is in ncidd.whitelist.
25
26       Bad  callers  have  ncidd  hangup  on  them.  The CannotBeCompleted.rmd
27       recording is played before the hangup if using hupmode  3.   FAX  tones
28       are sent before the hangup if using hupmode 2.
29
30       hangup-fakenum  expects 10 digit or 1+10 caller ID and has ncidd hangup
31       on others including private callers.  There is also a check for  stupid
32       caller  names  provided  by  telemarketers, such as V12345678901234 and
33       321-555-1212 and +1-321-555-1212
34
35       If /etc/ncid/valid-area-codes exists, hangup-fakenum has  ncidd  hangup
36       on areacodes that are not valid.
37
38       Make sure you 'set hupmode = 1|2|3' in ncidd.conf.  ncidd does not call
39       this script if the caller number or name is in ncidd.whitelist.
40
41       Server hangup extensions are only executed by the server  unless  test‐
42       ing.
43

OPTIONS

45       -h     show help message
46
47       -v     turn  on  verbose  and  send additional data to STDOUT for trou‐
48              bleshooting
49

REQUIREMENTS

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

FILES

56       /usr/share/ncid/extensions/hangup-fakenum
57       /usr/share/ncid/recording/*.rmd
58       /etc/ncid/ncidd.whitelist
59       /etc/ncid/valid-area-codes
60

SEE ALSO

62       ncidd.8,   ncidd.whitelist.5,   get-areacodes-list.1    hangup-calls.1,
63       hangup-closed-skel.1, hangup-skel.1
64
65
66
67NCID                               2022-11-8                 HANGUP-FAKENUM(1)
Impressum