1NCIDUTIL(1)           User Contributed Perl Documentation          NCIDUTIL(1)
2
3
4

NAME

6       ncidutil - manipulate entries in the alias, blacklist and whitelist
7       files
8

SYNOPSIS

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

DESCRIPTION

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

SEE ALSO

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)
Impressum