CIDALIAS(1)

💖 CIDALIAS(1) 💖

okay bestie, welcome to cidalias, a lil tool from the User Contributed Perl Documentation corner of the world that lets you peek at all your alias definitions across the NCID alias, blacklist and whitelist files. it's giving very much "let me see who's who in my call log" energy and honestly? we're obsessed. 💅

---

✨ NAME ✨

cidalias — view alias definitions in the NCID alias, blacklist and whitelist files 🦋

---

🌸 SYNOPSIS 🌸

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

cidalias [--alias     | -a <file>]
         [--blacklist | -b <file>]
         [--whitelist | -w <file>]
         [--format    | -f <0-2>]
         [--delimiter | -d <text>]
         [--strip-one | -1]

---

💜 DESCRIPTION 💜

so the cidalias tool shows you the aliases sitting in the alias file, and it can do it in three whole different formats: raw, human readable, and delimited. pick your fighter. 🎀

---

👑 Options 👑

• -h, --help — shows you the help message and then dips out. bye! 👋
• -m, --man — pulls up the manual page and exits. it's literally this, but nerdier. 📖
• -V, --version — tells you the version and exits. short, sweet, iconic. ⭐
• -f <0-2>, --format <0-2> — decides which output format you're getting, bestie. here's the tea:
  • Output format 0 displays the alias file as-is. the blacklist and whitelist files are ignored, no cap. 🙈
  • Output format 1 displays the aliases in human readable text, and it includes blacklist and whitelist info if it applies. so thoughtful. 🥰
  • Output format 2 displays the alias, blacklist and whitelist files with field delimiters, for easy parsing by another program. this one uses the -d|--delimiter and -1|--strip-one options. nerdy main character energy. 🤓

The default output format is 1 (human readable). 💅

• -d <text>, --delimiter <text> — only used when output format is 2 (delimited). your fields get delimited by <text>. some notes because delimiters are lowkey tricky:
  • 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. it's protecting you fr fr.
  • Default delimiter is a comma (,). 🍓
• -1, --strip-one — only used when output format is 2 (delimited). if a number is exactly 11 digits and it begins with "1", it strips the "1" before outputting it. the whole point is to facilitate consistent sorting of the output for 10 digit numbers. slay. 💅
• -a <file>, --alias <file> — sets the name of the alias file.

Default: prefix3=/etc/ncid/ncidd.alias 📁

• -b <file>, --blacklist <file> — sets the name of the blacklist file.

Default: prefix3=/etc/ncid/ncidd.blacklist 🖤

• -w <file>, --whitelist <file> — sets the name of the whitelist file

Default: prefix3=/etc/ncid/ncidd.whitelist 🤍

---

🌈 EXAMPLES 🌈

output as tab-delimited, changing 11-digit numbers beginning with "1" to be 10-digits:

cidalias -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:

cidalias -f 2 -d '|' -1 | sort -t '|' -k3,3 -n

---

🦋 SEE ALSO 🦋

ncidd.conf.5, ncidd.alias.5, ncidd.blacklist.5, ncidd.whitelist.5, cidcall.1, cidupdate.1

---

and that's the whole vibe check, bestie! this page came from perl v5.42.0 and it's dated 2025-08-06. go forth and alias responsibly. 💖✨🎀