Content-type: text/html Manpage of CIDCALL

CIDCALL

Section: User Contributed Perl Documentation (1)
Updated: 2016-10-02
Index Return to Main Contents
 

NAME

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

SYNOPSIS

 cidcall [--help|-h] [--man|-m] [--version|-V]

 cidcall [--format   |-f <0-2>]
         [--delimiter|-d <text>]
         [--strip-one|-1]
         [--all-types|-a]
         [--yearlog  |-y <4 digit year>]
         [--BLK      |-B]
         [--CID      |-C]
         [--END      |-E]
         [--HUP      |-H]
         [--MSG      |-M]
         [--NOT      |-N]
         [--OUT      |-O]
         [--PID      |-P]
         [--WID      |-W]
         [cidlog]

 

DESCRIPTION

The cidcall tool displays the cidcall.log file in one of three different formats: raw, human readable, and delimited.

The default is to display BLK, CID, HUP, OUT, PID, and WID lines in a human readable format.  

Options

-h, --help
Displays the help message and exits.
-m, --man
Displays the manual page and exits.
-V, --version
Displays the version and exits.
-f <0-2>, --format <0-2>
Determines the output format used.

Output format 0 displays the call log file as-is. All other options are ignored.

Output format 1 displays the call log in human readable text.

Output format 2 displays the call log with field delimiters for easy parsing by another program. Uses options -d|--delimiter and -1|--strip-one.

The default output format is 1 (human readable).

-d <text>, --delimiter <text>
Used when output format is 2 (delimited). Fields will be delimited by <text>.

For pipe-delimited output, surround the pipe symbol with single or double quotes: '|' or ``|''.

For tab-delimited output, specify only the letter ``t''.

For comma-delimited output, fields containing an embedded comma will automatically be surrounded by double-quotes.

Default delimiter is a comma (``,'').

-1, --strip-one
Used when output format is 2 (delimited). If a number is exactly 11 digits and it begins with ``1'', strip the ``1'' before outputting it. This is to facilitate consistent sorting of the output for 10 digit numbers.

If the leading ``1'' is stripped, the ``Exception'' column will so indicate.

-i, --lineid <text>
Output only those lines where the lineid matches <text>.
-a, --all-types
Equivalent to typing --BLK, --CID, --END, --HUP, --MSG, --NOT, --OUT, --PID, and --WID on the command line.
-B, --BLK
Displays BLK lines (blocked calls) in the call file.
-C, --CID
Displays CID lines (incoming calls) in the call file.
-E, --END
Displays END lines (gateway end of call) in the call file.
-H, --HUP
Displays HUP lines (terminated calls) in the call file.
-M, --MSG
Displays MSG lines (messages) in the call file.
-N, --NOT
Displays NOT lines (smartphone note (message)) in the call file.
-O, --OUT
Displays OUT lines (outgoing calls) in the call file.
-P, --PID
Displays PID lines (smartphone Caller ID) in the call file. Obsolete.
-W, --WID
Displays WID lines (``call waiting'' calls) in the call file.
-y, --yearlog <4 digit year>
Obtains data from $HOME/NCID/log/cidcall-<year>.log instead of the default. This overrides a call log given on the command line.
 

Arguments

cidlog
The NCID call file.

Default: /var/log/cidcall.log

 

EXAMPLES

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

FILES

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

 

SEE ALSO

ncidd.conf.5


 

Index

NAME
SYNOPSIS
DESCRIPTION
Options
Arguments
EXAMPLES
FILES
SEE ALSO

This document was created by man2html, using the manual pages.
Time: 13:26:52 GMT, October 04, 2016