GSP
Quick Navigator

Search Site

Unix VPS
A - Starter
B - Basic
C - Preferred
D - Commercial
MPS - Dedicated
Previous VPSs
* Sign Up! *

Support
Contact Us
Online Help
Handbooks
Domain Status
Man Pages

FAQ
Virtual Servers
Pricing
Billing
Technical

Network
Facilities
Connectivity
Topology Map

Miscellaneous
Server Agreement
Year 2038
Credits
 

USA Flag

 

 

Man Pages
CIDCALL(1) User Contributed Perl Documentation CIDCALL(1)

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

 cidcall [--help       | -h]
         [--list-years | -l]
         [--man        | -m]
         [--format     | -f <0>]
         [--version    | -V]

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

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, MWI, OUT, PID, PUT, RID and WID lines in a human readable format.

-h, --help
Displays the help message and exits.
-m, --man
Displays the manual page and exits.
-D, --debug
Debug mode. Always enabled, reserved for future use.
-v, --verbose <1-9>
Output information while processing is occurring. Set the level to a higher number for more information. Levels range from 1 to 9, but not all levels are used.

Default: verbose = 1

-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 (",").

-l, --list-years
Lists all the yearly call logs.
-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, --MWI, --NOT, --OUT, --PID, --PUT, --RID 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.
--MWI
Displays MWI lines (voicemail message waiting) in the call file.

Note: There is no short option for --MWI.

-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.
-p, --PUT
Displays PID lines (smartphone outgoing calls) in the call file.
-R, --RID
Displays RID lines (ringback calls) in the call file.
-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.

cidlog
The NCID call file.

Default: /var/log/cidcall.log

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

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

ncidd.conf.5
2022-04-08 perl v5.32.1

Search for    or go to Top of page |  Section 1 |  Main Index

Powered by GSP Visit the GSP FreeBSD Man Page Interface.
Output converted with ManDoc.