1CIDCALL(1) User Contributed Perl Documentation CIDCALL(1)
2
3
4
6 cidcall - view calls, hangups, messages and end of calls in the NCID
7 call file
8
10 cidcall [--help | -h]
11 [--list-years | -l]
12 [--man | -m]
13 [--format | -f <0>]
14 [--version | -V]
15
16 cidcall [--all-types | -a]
17 [--format | -f <1-2>]
18 [--delimiter | -d <text>]
19 [--strip-one | -1]
20 [--verbose | -v <1-9>]
21 [--thisyear | -t]
22 [--yearlog | -y <4 digit year>]
23 [--BLK | -B]
24 [--CID | -C]
25 [--END | -E]
26 [--HUP | -H]
27 [--MSG | -M]
28 [--MWI]
29 [--NOT | -N]
30 [--OUT | -O]
31 [--PID | -P]
32 [--PUT | -p]
33 [--RID | -R]
34 [--WID | -W]
35 [cidlog]
36
38 The cidcall tool displays the cidcall.log file in one of three
39 different formats: raw, human readable and delimited.
40
41 The default is to display BLK, CID, HUP, MWI, OUT, PID, PUT, RID and
42 WID lines in a human readable format.
43
44 Options
45 -h, --help
46 Displays the help message and exits.
47
48 -m, --man
49 Displays the manual page and exits.
50
51 -D, --debug
52 Debug mode. Always enabled, reserved for future use.
53
54 -v, --verbose <1-9>
55 Output information while processing is occurring. Set the level
56 to a higher number for more information. Levels range from 1 to
57 9, but not all levels are used.
58
59 Default: verbose = 1
60
61 -V, --version
62 Displays the version and exits.
63
64 -f <0-2>, --format <0-2>
65 Determines the output format used.
66
67 Output format 0 displays the call log file as-is. All other
68 options are ignored.
69
70 Output format 1 displays the call log in human readable text.
71
72 Output format 2 displays the call log with field delimiters for
73 easy parsing by another program. Uses options -d|--delimiter
74 and -1|--strip-one.
75
76 The default output format is 1 (human readable).
77
78 -d <text>, --delimiter <text>
79 Used when output format is 2 (delimited). Fields will be
80 delimited by <text>.
81
82 For pipe-delimited output, surround the pipe symbol with single
83 or double quotes: '|' or "|".
84
85 For tab-delimited output, specify only the letter "t".
86
87 For comma-delimited output, fields containing an embedded comma
88 will automatically be surrounded by double-quotes.
89
90 Default delimiter is a comma (",").
91
92 -l, --list-years
93 Lists all the yearly call logs.
94
95 -1, --strip-one
96 Used when output format is 2 (delimited). If a number is exactly
97 11 digits and it begins with "1", strip the "1" before
98 outputting it. This is to facilitate consistent sorting of the
99 output for 10 digit numbers.
100
101 If the leading "1" is stripped, the "Exception" column will so
102 indicate.
103
104 -i, --lineid <text>
105 Output only those lines where the lineid matches <text>.
106
107 -a, --all-types
108 Equivalent to typing --BLK, --CID, --END, --HUP, --MSG, --MWI,
109 --NOT, --OUT, --PID, --PUT, --RID and --WID on the command line.
110
111 -B, --BLK
112 Displays BLK lines (blocked calls) in the call file.
113
114 -C, --CID
115 Displays CID lines (incoming calls) in the call file.
116
117 -E, --END
118 Displays END lines (gateway end of call) in the call file.
119
120 -H, --HUP
121 Displays HUP lines (terminated calls) in the call file.
122
123 -M, --MSG
124 Displays MSG lines (messages) in the call file.
125
126 --MWI Displays MWI lines (voicemail message waiting) in the call file.
127
128 Note: There is no short option for --MWI.
129
130 -N, --NOT
131 Displays NOT lines (smartphone note (message)) in the call file.
132
133 -O, --OUT
134 Displays OUT lines (outgoing calls) in the call file.
135
136 -P, --PID
137 Displays PID lines (smartphone Caller ID) in the call file.
138
139 -p, --PUT
140 Displays PID lines (smartphone outgoing calls) in the call file.
141
142 -R, --RID
143 Displays RID lines (ringback calls) in the call file.
144
145 -W, --WID
146 Displays WID lines ("call waiting" calls) in the call file.
147
148 -t, --thisyear
149 Obtains data from $HOME/NCID/log/cidcall-<thisyear>.log instead
150 of the default. This overrides a call log given on the command
151 line.
152
153 -y, --yearlog <4 digit year>
154 Obtains data from $HOME/NCID/log/cidcall-<year>.log instead of
155 the default. This overrides a call log given on the command
156 line.
157
158 Arguments
159 cidlog The NCID call file.
160
161 Default: /var/log/cidcall.log
162
164 Output as tab-delimited, changing 11-digit numbers beginning with "1"
165 to be 10-digits:
166 cidcall -f 2 -d t -1
167
168 Output as pipe-delimited, changing 11-digit numbers beginning with "1"
169 to be 10-digits, then sorting numerically on the phone number column:
170 cidcall -f 2 -d '|' -1 | sort -t '|' -k4,4 -n
171
173 /var/log/cidcall.log
174 $HOME/NCID/log/cidcall-<year>.log
175
177 ncidd.conf.5
178
179
180
181perl v5.34.0 2021-08-19 CIDCALL(1)