HANGUP-GREYLIST(1)

💅 hangup-greylist — the NCID manual page (section 1, bestie) 💅

okay so you know how robocallers are literally the worst? this is the script that fights back. it lives in the NCID family, it's a section 1 manual page, and it's giving "unknown callers must prove themselves" energy. no cap. 🎀

---

✨ NAME ✨

hangup-greylist — the greylisting hangup extension, aka the bouncer at the door of your phone line 🫶

---

🌸 SYNOPSIS 🌸

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

and the string? bestie it has a format and it is very specific. here it is, exactly, backslashes and all:

*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>*

so it's all *KEY*<value> pairs strung together, and yes the <...> bits are placeholders for the actual values. slay. ✨

---

💖 DESCRIPTION 💖

okay so here's the whole vibe: hangup-greylist blocks most robocalls by requiring an unknown caller to hang up and call again from the same number. the whole assumption? automated calls are unlikely to call back. it's giving "if you're real, prove it." 💅

also important: this script is not called if the caller number or name is in ncidd.whitelist. so if you're already whitelisted you're literally fine, no vibe check needed. 👑

callers from unknown numbers will optionally have a recording played to them, and after that ncidd hangs up. if you're using a recording, you (the user, the icon, the main character) should provide a customized one, and it should instruct the caller to call again from the same number within the user-defined time limit. Hupmode 3 is required for the recording to be played, periodt. if Hupmode is 1, ncidd will hang up without playing a recording. if Hupmode is 2, the extension will abort and allow the call.

the goal here is to encourage a human caller to call again. let's break down the hupmodes because this matters:

• Hupmode 1 causes an immediate hangup, and ngl the caller may just assume there was a problem and call right back. 😬
• Hupmode 3 uses a recording to give the caller explicit instructions — this is the good one. 🎀
• Hupmode 2 would play a FAX tone. not appropriate for greylisting, because it would make the caller think they had the wrong number. so like, don't.

hangup-greylist adds the unknown number to a "greylist" file along with an expiration time. ✨

incoming calls from numbers that are in the greylist are accepted if the expiration time has not been reached. the expiration time may optionally be extended each time a call is accepted. and an incoming call from a number in the list where the expiration time has been reached? treated as an unknown call. rip. 💀

entries in the greylist file with expired time limits are removed from the file whenever a call is processed. the user should occasionally review the greylist file and add numbers to the whitelist or blacklist files as appropriate. also (saying it again because it's real) ncidd does not call this script if the caller number or name is in ncidd.whitelist.

one more thing: server hangup extensions are only executed by the server unless testing. 🦋

---

✨ OPTIONS ✨

• -h — show the help message 🫶
• -v — turn on verbose 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, all three of these are non-negotiable if you want it to work. iykyk. 💜

---

🎀 FILES 🎀

• /usr/share/ncid/extensions/hangup-greylist
• /usr/share/ncid/recording/*.rmd
• prefix3=/etc/ncid/ncidd.conf
• prefix3=/etc/ncid/ncidd.whitelist
• /var/cache/ncid/ncidd.greylist

---

👑 SEE ALSO 👑

ncidd.8, ncidd.whitelist.5, ncidd.greylist.5, hangup-calls.1, hangup-closed-skel.1, hangup-skel.1

---

okay that's the whole page bestie, you ate that read. this one's from NCID, dated 2022-11-8, and it's HANGUP-GREYLIST(1) — go forth and greylist those robocallers 💅✨🦋