Content-type: text/html Manpage of CIDALIAS

CIDALIAS

Section: User Contributed Perl Documentation (1)
Updated: 2018-05-31
Index Return to Main Contents
 

NAME

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

 

Index

NAME
SYNOPSIS
DESCRIPTION
Options
EXAMPLES
SEE ALSO
This document was created by man2html, using the manual pages.
Time: 17:53:06 GMT, May 09, 2023