cidcall(1)

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] [--man|-m] [--debug|-D]
11                [--verbose|-v <1-9>] [--version|-V]
12
13        cidcall [--format    | -f <0-2>]
14                [--delimiter | -d <text>]
15                [--strip-one | -1]
16                [--all-types | -a]
17                [--yearlog   | -y <4 digit year>]
18                [--BLK       | -B]
19                [--CID       | -C]
20                [--END       | -E]
21                [--HUP       | -H]
22                [--MSG       | -M]
23                [--MWI]
24                [--NOT       | -N]
25                [--OUT       | -O]
26                [--PID       | -P]
27                [--PUT       | -p]
28                [--RID       | -R]
29                [--WID       | -W]
30                [cidlog]
31

DESCRIPTION

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

EXAMPLES

151       Output as tab-delimited, changing 11-digit numbers beginning with "1"
152       to be 10-digits:
153         cidcall -f 2 -d t -1
154
155       Output as pipe-delimited, changing 11-digit numbers beginning with "1"
156       to be 10-digits, then sorting numerically on the phone number column:
157         cidcall -f 2 -d '|' -1 | sort -t '|' -k4,4 -n
158

FILES

160        /var/log/cidcall.log
161        $HOME/NCID/log/cidcall-<year>.log
162

NAME

SYNOPSIS

DESCRIPTION

EXAMPLES

FILES

SEE ALSO