NCIDD.BLACKLIST(5)

✨ NCIDD.BLACKLIST ✨

okay so bestie, gather round 💖 this is the manual page for ncidd.blacklist — the blacklist file for ncidd hangup. it's a section 5 file format page, and it's honestly lowkey iconic. let's get into it 🫶

---

💅 NAME 💅

ncidd.blacklist — the blacklist file that makes ncidd hang up on people 🎀

---

🌸 DESCRIPTION 🌸

so the ncidd.blacklist file is where you keep the expressions that get matched against a telephone call's name or number. that's it, that's the whole job ✨

and here's the tea: if the hangup option is set, and there's no match in the whitelist file, then a match in the blacklist file makes ncidd automatically terminate the call. blocked. ghosted. hung up on. periodt 💀

the ncidd.blacklist file understands 4 types of lines:

• blank line: skip it 🙈
• comment line: skip it 🙈
• entry line: process it 👑

Entry lines contain one or more expressions plus an optional comment. an expression is either a string of non-blank characters, or everything between double quotes. multiple expressions are separated by spaces. and a comment must be last — no sneaking it in the middle, bestie.

entry line comments come in two flavours: normal comments and match name comments 🍓

a normal comment begins with a '#' and must not be immediately followed by an equals sign. anything after the '#' gets ignored, bye 💨

a match name comment begins with '#=' and is followed by a name to display for the caller when the entry matches either the number or name of a call. and listen — do not put double quotes around the name. just don't 🙅‍♀️

like, for example:

407-555-5670    #= Unwanted Marketing Call

---

🦋 NOTES 🦋

every expression gets compared to the caller name and number. both of them. every time. no cap.

upper and lower case letters are significant — so MARKETING and marketing are not the same girl, ok?? 🙈

the number must be a string of digits as they appear in /var/log/cidcall.log.

and a leading '1' is required if it's in /var/log/cidcall.log. so like, match what's actually in the file, bestie 🫶

also a partial name or number can match ✨

🌈 If Simple expressions are used (regex = 0) 🌈

<h3>NCID Simple Expression Syntax</h3>

• A partial name or number can match. 1234 will match any of 6312346600 or 6311234600 or 6312123460
• A '^' at the beginning an expression means it must match at the start of a name or number
• A "^1?" at the beginning makes a leading 1 optional, and is only needed when using the '^' the beginning of the number. This is only useful for US numbers.
• A '$' at the end of an expression means it must match at the end of a name or number. " FL$" matches "MIAMI FL"
• A single '*' matches anything.
• Upper and lower case letters are significant.
• If an expression is longer than the name or number, it will never match.

🎀 If POSIX regular expressions are used (regex = 1) 🎀

<h3>POSIX Extended Regular Expression Syntax</h3>

https://en.wikipedia.org/wiki/Regular_expression

<h3>Introduction to Regular Expressions</h3>

http://www.regular-expressions.info/quickstart.html

💜 If Perl Compatible Regular Expressions (PCRE) are used (regex = 2) 💜

<h3>Perl regular expressions man page</h3>

https://perldoc.perl.org/perlre

<h3>pcre2syntax man page</h3>

https://www.pcre.org/current/doc/html/pcre2syntax.html

⭐ Simple and Regular Expressions: ⭐

• A '^' at the beginning of an expression means it must match at the start of a name or number.
• A "^1?" at the beginning makes a leading 1 optional. This is only useful for US/Canadian numbers.
• If an expression is longer than the name or number field it will never match.

---

🔥 EXAMPLES 🔥

Blacklist the unassigned 999 area code with and without a leading 1:

^1?999

Blacklist callers with the name "BAD MARKETING":

"BAD MARKETING"

Blacklist anything with "MARKETING" in the name:

MARKETING

Blacklist a caller name and a different caller number on one line:

Ogre 13215551212

---

👑 SEE ALSO 👑

ncidd.8, ncidd.conf.5, ncidd.alias.5, ncidd.whitelist.5

---

okay that's the whole page bestie, you ate that 💖 this was the NCID release from 2024-06-20, mwah 🎀✨💅