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

NAME

6       cidcall - view calls, hangups, messages and end of calls in the NCID
7       call file
8

SYNOPSIS

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

DESCRIPTION

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 as-is.
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       -t, --thisyear
148              Obtains data from $HOME/NCID/log/cidcall-<thisyear>.log instead
149              of the default.  This overrides a call log given on the command
150              line.
151
152       -y, --yearlog <4 digit year>
153              Obtains data from $HOME/NCID/log/cidcall-<year>.log instead of
154              the default.  This overrides a call log given on the command
155              line.
156
157   Arguments
158       cidlog The NCID call file.
159
160              Default: /var/log/cidcall.log
161

EXAMPLES

163       Output as tab-delimited, changing 11-digit numbers beginning with "1"
164       to be 10-digits:
165         cidcall -f 2 -d t -1
166
167       Output as pipe-delimited, changing 11-digit numbers beginning with "1"
168       to be 10-digits, then sorting numerically on the phone number column:
169         cidcall -f 2 -d '|' -1 | sort -t '|' -k4,4 -n
170

FILES

172        /var/log/cidcall.log
173        $HOME/NCID/log/cidcall-<year>.log
174

SEE ALSO

176       ncidd.conf.5
177
178
179
180perl v5.38.0                      2023-10-03                        CIDCALL(1)
Impressum