1NCIDUTIL(1) User Contributed Perl Documentation NCIDUTIL(1)
2
3
4
6 ncidutil - manipulate entries in the alias, blacklist and whitelist
7 files
8
10 ncidutil [--help|-h] [--man|-m] [--version|-V]
11
12 ncidutil [--multi "<blacklist and/or whitelist file names>"]
13 [--regex|-R] [--ignore1|-i] <arguments>
14
16 The ncidutil script is designed to be called by the NCID server in
17 response to client requests. Five arguments are required.
18
19 The ncidutil script can add, modify or remove an alias from the alias
20 file. If an alias is modified or removed and if the hangup option of
21 the server is enabled, ncidutil will add or remove the alias entry in
22 the blacklist and/or whitelist files.
23
24 The "--multi" option is used to determine if the blacklist and
25 whitelist files should be searched for an alias or if an entry should
26 be added or removed from the files. The entry can be an alias in the
27 alias file.
28
29 Options
30 -h, --help Displays the help message and exits.
31
32 -m, --man Displays the manual page and exits.
33
34 -V, --version
35 Displays the version and exits.
36
37 -i, --ignore1
38 This is a US/Canada option only.
39
40 A leading one in an alias definition and in the calling
41 number is ignored.
42
43 Normally an alias requires the calling number as it appears
44 in the cidcall.log. In the US a leading 1 may or may not be
45 provided in incoming or outgoing calls.
46
47 Default: The number for the alias entry must match the
48 calling number.
49
50 --multi "<blacklist> <whitelist>"
51 Specifies the names of the blacklist and whitelist files to
52 update when an alias is modified. If both are specified,
53 separate each with a space.
54
55 Default: ""
56
57 -R, --regex <0-2>
58 If regex = 0, uses Simple Expressions.
59
60 If regex = 1, uses Posix Regular Expressions.
61
62 If regex = 2, uses Perl-compatible Expressions.
63
64 Default: Uses Simple Expressions.
65
66 Arguments
67 <filename> Name of the alias, blacklist, or whitelist file.
68
69 <list> The case-sensitive type of list: Alias, Blacklist, Whitelist
70
71 <action> add, modify, remove
72
73 for list = Alias: add, remove, or modify
74 for list = Blacklist: add or remove
75 for list = Whitelist: add or remove
76
77 <item>
78 For list = Alias, item = "number&&alias"
79 For list = Blacklist, item = "number|name&&"
80 For list = Whitelist, item = "number|name&&"
81
82 Quotes are required.
83
84 number is the number in the call file
85 alias is from the user
86 name is the name in the call file
87
88 <extra>
89 For list = Alias, extra is "type&&name"
90 For list = Blacklist, extra is a optional "comment"
91 For list = Whitelist, extra is a optional "comment"
92
93 Quotes are required.
94
95 name is the name in the call file
96 type is the uppercase alias type or NOALIAS:
97 NAMEDEP, NMBRDEP, NMBRNAME, NMBRONLY, NAMEONLY, LINEONLY
98
100 ncidd.conf.5, ncidd.alias.5, ncidd.blacklist.5, ncidd.whitelist.5,
101 cidalias.1, cidcall.1, cidupdate.1
102
103
104
105perl v5.38.0 2023-10-03 NCIDUTIL(1)