ncidutil man page

ncidutil — manipulate entries in the alias, blacklist, and whitelist files

Synopsis

ncidutil [--help|-h] [--man|-m] [--version|-V]
ncidutil [--multi "<blacklist and/or whitelist file names>"]
         [--regex|-R] [--ignore1|-i] <arguments>

Description

The ncidutil script is designed to be called by the NCID server in response to client requests. Five arguments are required.

The ncidutil script can add, modify or remove an alias from the alias file. If an alias is modified or removed and if the hangup option of the server is enabled, ncidutil will add or remove the alias entry in the blacklist and/or whitelist files.

The "--multi" option is used to determine if the blacklist and whitelist files should be searched for an alias or if an entry should be added or removed from the files. The entry can be an alias in the alias file.

Options

-h, --help
Displays the help message and exits.
-m, --man
Displays the manual page and exits.
-V, --version
Displays the version and exits.
-i, --ignore1
This is a US/Canada option only.

A leading one in an alias definition and in the calling number is ignored.

Normally an alias requires the calling number as it appears in the cidcall.log. In the US a leading 1 may or may not be provided in incoming or outgoing calls.

Default: The number for the alias entry must match the calling number.
--multi "<blacklist> <whitelist>"
Specifies the names of the blacklist and whitelist files to update when an alias is modified. If both are specified, separate each with a space.

Default: ""
-R, --regex
Regular expressions are used instead of simple expressions.

Arguments

<filename>
Name of the alias, blacklist, or whitelist file.
<list>
The case-sensitive type of list: Alias, Blacklist, Whitelist
<action>

add, modify, remove

for list = Alias:     add, remove, or modify
for list = Blacklist: add or remove
for list = Whitelist: add or remove
<item>
For list = Alias,     item = "number&&alias".
For list = Blacklist, item = "number|name&&".
For list = Whitelist, item = "number|name&&".

Quotes are required.

number is the number in the call file
alias is from the user
name is the name in the call file
<extra>
For list = Alias,     extra is "type&&name".
For list = Blacklist, extra is a optional "comment".
For list = Whitelist, extra is a optional "comment".

Quotes are required.

name is the name in the call file
type is the uppercase alias type or NOALIAS:
   NAMEDEP, NMBRDEP, NMBRNAME, NMBRONLY, NAMEONLY, LINEONLY

See Also

ncidd.conf.5, ncidd.alias.5, ncidd.blacklist.5, ncidd.whitelist.5, cidalias.1, cidcall.1, cidupdate.1

Info

2016-06-26 perl v5.24.0 User Contributed Perl Documentation