HANGUP-FAKENUM(1)

💖 HANGUP-FAKENUM 💖

okay bestie, welcome to hangup-fakenum, a lil script from the NCID fam (that's the manual, section 1) that is lowkey a bouncer for your phone line. she checks your caller ID and if the number is giving fake, she hangs up on it. no cap. 💅

---

✨ NAME ✨

hangup-fakenum — the script that catches fake callers and tells ncidd to hang up on them 🫶

---

🌸 SYNOPSIS 🌸

hangup-fakenum [-h]
hangup-fakenum [-v] <string>

and <string> has gotta be in this exact format, no freestyling:

*DATE*<mmddyyyy>*TIME*<hhmm>*LINE*<lineid>\
*NMBR*<number>*NAME*<name>*MODE*<hupmode>\
*FNMBR*<formatted number>*NTYPE*<type of device>\
*CTRY*<country code>*LOCA*<location>*CARI*<carrier>\
*NAME*<name>*

---

💜 DESCRIPTION 💜

so hangup-fakenum checks for valid North American number plan callers, exactly as described by the North Americal Numbering Plan (yes that's how it's spelled in the original, we keep it 💀) over at https://en.wikipedia.org/wiki/North_American_Numbering_Plan.

✨ important: the script is not called if the caller number or name is in ncidd.whitelist. whitelist besties are safe, periodt.

bad callers get hung up on by ncidd. here's the tea on the hangup modes:

• the CannotBeCompleted.rmd recording is played before the hangup if you're using hupmode 3 🔇
• FAX tones are sent before the hangup if you're using hupmode 2 📠

hangup-fakenum expects a 10 digit or 1+10 caller ID, and has ncidd hang up on everybody else, including private callers. 🙈 she also side-eyes stupid caller names that telemarketers provide, like V12345678901234 and 321-555-1212 and +1-321-555-1212. it's giving fake, it's giving scammer, it's getting hung up on. 💀

if prefix3=/etc/ncid/valid-area-codes exists, hangup-fakenum has ncidd hang up on areacodes that are not valid. area code vibe check failed? bye. 👋

🎀 make sure you set hupmode = 1|2|3 in ncidd.conf. and fr fr, ncidd does not call this script if the caller number or name is in ncidd.whitelist.

server hangup extensions are only executed by the server unless testing. (iykyk ✨)

---

🎀 OPTIONS 🎀

• -h — show the help message, queen of documentation 🫶
• -v — turn on verbose mode and send additional data to STDOUT for troubleshooting 🔍

---

🌈 REQUIREMENTS 🌈

• Set hupname to the name of this script in ncidd.conf.
• Set hupmode to 1, 2 or 3 in ncidd.conf.
• Set huprmd to a unique voice file in ncidd.conf, if hupmode is set to 3.

like... do the setup bestie, she can't work without it 😭

---

🦋 FILES 🦋

• /usr/share/ncid/extensions/hangup-fakenum
• /usr/share/ncid/recording/*.rmd
• prefix3=/etc/ncid/ncidd.whitelist
• prefix3=/etc/ncid/valid-area-codes

---

👑 SEE ALSO 👑

ncidd.8, ncidd.whitelist.5, get-areacodes-list.1, hangup-calls.1, hangup-closed-skel.1, hangup-skel.1

---

💖 that's the whole page bestie. go forth, hang up on fake numbers, be the main character of your own phone line. no notes. ⭐

NCID · 2022-11-8 — mwah, slay, bye 💅🌸🫶