NCIDUTIL(1)

💖 NCIDUTIL(1) 💖

okay bestie, gather round, because this is ncidutil from the User Contributed Perl Documentation section of your friendly neighborhood manual, and she is so much more than she looks. 💅

---

✨ NAME ✨

ncidutil — the lil script that manipulates entries in the alias, blacklist and whitelist files. that's it. that's the whole job. and she eats every time. 🎀

---

🌸 SYNOPSIS 🌸

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

 ncidutil [--multi "<blacklist and/or whitelist file names>"]
          [--regex|-R] [--ignore1|-i] <arguments>

---

🦋 DESCRIPTION 🦋

so, ncidutil is designed to be called by the NCID server whenever a client asks for something. she's not out here freelancing, she's on call. and heads up: five arguments are required. five. no more, no less, no skipping. 🫶

what does she do? she can add, modify or remove an alias from the alias file. iconic behavior honestly.

and here's the tea: if an alias gets modified or removed, and if the hangup option of the server is enabled, then ncidutil will go ahead and add or remove that alias entry in the blacklist and/or whitelist files too. she does the extra credit. she does the group project by herself. 😭

the --multi option is what decides whether the blacklist and whitelist files get searched for an alias, or whether an entry gets added or removed from those files. and plot twist — the entry in question can be an alias in the alias file. iykyk. 💜

👑 Options

• -h, --help — shows you the help message and then dips. bye! ✨
• -m, --man — shows you the manual page and exits. meta, right? you're reading the thing that the thing shows you. 🌈
• -V, --version — shows the version and exits. short, sweet, slay. ⭐
• -i, --ignore1 — okay this one is a US/Canada option only, so if that's not your region, no shade, just skip it.

what it does: a leading one in an alias definition and in the calling number gets ignored. like, forgotten. not invited to the party.

normally an alias requires the calling number to appear exactly as it shows up in the cidcall.log. but in the US, a leading 1 may or may not be there in incoming or outgoing calls — it's giving chaos, it's giving inconsistent, and this flag is how you deal with it. 🙈

Default: the number for the alias entry must match the calling number. no leading-one forgiveness. strict queen. 💅

• --multi "<blacklist> <whitelist>" — tells ncidutil the names of the blacklist and whitelist files to update when an alias is modified. if you're specifying both, separate each one with a space. yes, inside the quotes. yes, it matters.

Default: "" — empty, nothing, crickets. 🦗

• -R, --regex <0-2> — the regex dial. turn it and see what happens:
  • if regex = 0, it uses Simple Expressions.
  • if regex = 1, it uses Posix Regular Expressions.
  • if regex = 2, it uses Perl-compatible Expressions.

Default: Uses Simple Expressions. she's keeping it simple until you tell her otherwise. 🌸

🎀 Arguments

• <filename> — Name of the alias, blacklist, or whitelist file. just point at the file bestie. 📁
• <list> — The case-sensitive type of list: Alias, Blacklist, Whitelist. case-sensitive means alias is not Alias, so don't do that. 😤
• <action> — add, modify, remove.

but here's the breakdown by list type:

• for list = Alias: add, remove, or modify
• for list = Blacklist: add or remove
• for list = Whitelist: add or remove

so blacklist and whitelist don't get to modify. they get add or remove. that's the rule, periodt. ✋

• <item> — the actual content, and it looks different depending on which list you're in:
  • For list = Alias, item = "number&&alias"
  • For list = Blacklist, item = "number|name&&"
  • For list = Whitelist, item = "number|name&&"

Quotes are required. do not forget the quotes. the quotes are the whole vibe.

and what do those words mean?

• number is the number in the call file
• alias is from the user
• name is the name in the call file

• <extra> — the bonus content:
  • For list = Alias, extra is "type&&name"
  • For list = Blacklist, extra is a optional "comment"
  • For list = Whitelist, extra is a optional "comment"

Quotes are required. again!! 🔥

and the vocabulary:

• name is the name in the call file
• type is the uppercase alias type or NOALIAS:

NAMEDEP, NMBRDEP, NMBRNAME, NMBRONLY, NAMEONLY, LINEONLY

yes, all caps. she's shouting them for a reason. 👑

---

🌟 SEE ALSO 🌟

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

go read those too, they're all in the family, they all ate. 🫶

---

quick vibe check: the synopsis says --multi and --regex come before your arguments, and --regex wants a number from 0 to 2. the defaults live where they live, and --multi defaults to empty. don't fight it, just work with her. 💖

---

and that's the page bestie!! this one is from perl v5.42.0, dated 2025-08-06, and it's the NCIDUTIL(1) manual — go forth and manipulate those entries, you absolute main character. 💜🦋✨