1CIDALIAS(1) User Contributed Perl Documentation CIDALIAS(1)
2
3
4
6 cidalias - view alias definitions in the NCID alias, blacklist and
7 whitelist files
8
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
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
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
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)