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

NAME

6       cidalias - view alias definitions in the NCID alias, blacklist and
7       whitelist files
8

SYNOPSIS

10        cidalias [--help|-h] [--man|-m] [--version|-V]
11
12        cidalias [--alias     | -a <file>]
13                 [--blacklist | -b <file>]
14                 [--whitelist | -w <file>]
15                 [--format    | -f <0-2>]
16                 [--delimiter | -d <text>]
17                 [--strip-one | -1]
18

DESCRIPTION

20       The cidalias tool displays aliases in the alias file in one of three
21       different formats: raw, human readable and delimited.
22
23   Options
24       -h, --help
25              Displays the help message and exits.
26
27       -m, --man
28              Displays the manual page and exits.
29
30       -V, --version
31              Displays the version and exits.
32
33       -f <0-2>, --format <0-2>
34              Determines the output format used.
35
36              Output format 0 displays the alias file as-is. The blacklist and
37              whitelist files are ignored.
38
39              Output format 1 displays the aliases in human readable text and
40              includes blacklist and whitelist info if applicable.
41
42              Output format 2 displays the alias, blacklist and whitelist
43              files with field delimiters for easy parsing by another program.
44              Uses options -d|--delimiter and -1|--strip-one.
45
46              The default output format is 1 (human readable).
47
48       -d <text>, --delimiter <text>
49              Used when output format is 2 (delimited). Fields will be
50              delimited by <text>.
51
52              For pipe-delimited output, surround the pipe symbol with single
53              or double quotes: '|' or "|".
54
55              For tab-delimited output, specify only the letter "t".
56
57              For comma-delimited output, fields containing an embedded comma
58              will automatically be surrounded by double-quotes.
59
60              Default delimiter is a comma (",").
61
62       -1, --strip-one
63              Used when output format is 2 (delimited). If a number is exactly
64              11 digits and it begins with "1", strip the "1" before
65              outputting it. This is to facilitate consistent sorting of the
66              output for 10 digit numbers.
67
68       -a <file>, --alias <file>
69              Sets the name of the alias file.
70
71              Default: /etc/ncid/ncidd.alias
72
73       -b <file>, --blacklist <file>
74              Sets the name of the blacklist file.
75
76              Default: /etc/ncid/ncidd.blacklist
77
78       -w <file>, --whitelist <file>
79              Sets the name of the whitelist file
80
81              Default: /etc/ncid/ncidd.whitelist
82

EXAMPLES

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

SEE ALSO

93       ncidd.conf.5, ncidd.alias.5, ncidd.blacklist.5, ncidd.whitelist.5,
94       cidcall.1, cidupdate.1
95
96
97
98perl v5.38.0                      2023-10-03                       CIDALIAS(1)
Impressum