cidalias man page

cidalias — view alias definitions in the NCID alias, blacklist, and whitelist files

Synopsis

cidalias [--help|-h] [--man|-m] [--version|-V]
cidalias [--alias     |-a <file>] 
         [--blacklist |-b <file>] 
         [--whitelist |-w <file>] 
         [--format    |-f <0-2>]
         [--delimiter |-d <text>]
         [--strip-one |-1]

Description

The cidalias tool displays aliases in the alias file in one of three different formats: raw, human readable, and delimited.

Options

-h, --help
Displays the help message and exits.
-m, --man
Displays the manual page and exits.
-V, --version
Displays the version and exits.
-f <0-2>, --format <0-2>
Determines the output format used.

Output format 0 displays the alias file as-is. The blacklist and whitelist files are ignored.

Output format 1 displays the aliases in human readable text and includes blacklist and whitelist info if applicable.

Output format 2 displays the alias, blacklist, and whitelist files with field delimiters for easy parsing by another program. Uses options -d|--delimiter and -1|--strip-one.

The default output format is 1 (human readable).
-d <text>, --delimiter <text>
Used when output format is 2 (delimited). Fields will be delimited by <text>.

For pipe-delimited output, surround the pipe symbol with single or double quotes: '|' or "|".

For tab-delimited output, specify only the letter "t".

For comma-delimited output, fields containing an embedded comma will automatically be surrounded by double-quotes.

Default delimiter is a comma (",").
-1, --strip-one
Used when output format is 2 (delimited). If a number is exactly 11 digits and it begins with "1", strip the "1" before outputting it. This is to facilitate consistent sorting of the output for 10 digit numbers.
-a <file>, --alias <file>
Sets the name of the alias file.

Default: /etc/ncid/ncidd.alias
-b <file>, --blacklist <file>
Sets the name of the blacklist file.

Default: /etc/ncid/ncidd.blacklist
-w <file>, --whitelist <file>
Sets the name of the whitelist file

Default: /etc/ncid/ncidd.whitelist

Examples

Output as tab-delimited, changing 11-digit numbers beginning with "1" to be 10-digits:
cidalias -f 2 -d t -1
Output as pipe-delimited, changing 11-digit numbers beginning with "1" to be 10-digits, then sorting numerically on the phone number column:
cidalias -f 2 -d '|' -1 | sort -t '|' -k3,3 -n

See Also

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

Info

2016-09-13 perl v5.24.0 User Contributed Perl Documentation