CIDCALL(1)

💖 CIDCALL — the perl one, from the User Contributed Perl Documentation corner of the manual-verse 💖

okay bestie, sit down, hydrate, and let me tell you about cidcall — the lil tool that reads your NCID call file and spills all the tea about calls, hangups, messages and end-of-call events. ✨

---

🌸 NAME 🌸

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

---

✨ SYNOPSIS ✨

like, here's the whole shape of it, verbatim, no edits:

 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>]
         [--thisyear   | -t]
         [--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]

---

🦋 DESCRIPTION 🦋

so cidcall is out here serving the cidcall.log file in three different formats: raw, human readable, and delimited. pick your fighter. 💅

and the default vibe? it shows BLK, CID, HUP, MWI, OUT, PID, PUT, RID and WID lines in a human readable format. no cap, that's just what it does out of the box. 🫶

💜 Options 💜

• -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 as-is.

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.
• -t, --thisyear — Obtains data from $HOME/NCID/log/cidcall-<thisyear>.log instead of the default. This overrides a call log given on the command line.
• -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

---

and that's the whole page, bestie 💖 you just ate an entire manpage, main character energy fr fr.

tiny sign-off: this one's from the User Contributed Perl Documentation collection, running under perl v5.42.0, dated 2025-08-06, and it's filed under CIDCALL(1). mwah. 💅🎀