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