GET-FCC-LIST(1)

💖 GET-FCC-LIST(1) 💖

okay bestie, welcome to the NCID manual, page one of the get-fcc-list saga ✨

---

🌸 NAME 🌸

get-fcc-list — grab the freshest fcc.blacklist, derived from FCC Complaints data. it's giving phone-number menace list, no cap 🫶

---

✨ SYNOPSIS ✨

get-fcc-list [-h] [-V] [-a|-n|-r]

---

🦋 DESCRIPTION 🦋

So. The get-fcc-list script uses wget to fetch the fcc.blacklist file from http://ncid-utils.ca/fcc.blacklist. and what even is fcc.blacklist? it's literally a list of phone numbers pulled straight out of the Unwanted Calls - FCC Complaints open database. iconic of them to publish it, honestly.

You're gonna want to call it like, as often as once a day from cron on Linux/Unix/Mac OS X. daily vibe check on the scammers, periodt 💅

Once it's downloaded, fcc.blacklist can be used with NCID in one of two ways:

1. hangup-fcc The External Hangup Extension script hangup-fcc can read fcc.blacklist directly. lowkey the easiest route, ngl.
2. ncidd.blacklist The contents of fcc.blacklist are reformatted by get-fcc-list and appended to ncidd.blacklist. Before being modified, a backup of the current ncidd.blacklist is saved to /var/backups/ncid. safety first, bestie 🎀

---

👑 OPTIONS 👑

• -h — prints this help and exits. the "wait what does this do again" button 🙈
• -V — displays the version and exits. main character stats ✨
• -a — download fcc.blacklist and add it to ncidd.blacklist. this is the default action, iykyk.
• -n — download fcc.blacklist but do not add it to ncidd.blacklist. the downloaded file is ready to use with hangup-fcc. download-only queen 👑
• -r — same as -n but is a special remove-only option to remove "FCC bad list" lines from ncidd.blacklist. use this option once when you are transitioning from ncidd.blacklist to hangup-fcc. one-time glow-up, fr fr 🦋

---

🔥 REQUIREMENTS 🔥

• NCID: release 1.7 or newer
• wget: fetches files using http
• pkill: send signal to all running ncidd servers to reload alias, blacklist and whitelist
• root crontab: runs get-fcc-list at specific times and days. the root crontab can be edited with sudo crontab -e to add something like the following examples which write a log file to /tmp:

Internal Hangup — append (-a) FCC Data to ncidd.blacklist

# run each day at 08:15
15 08 * * * /usr/share/ncid/sys/get-fcc-list -a > /tmp/get-fcc-list.log 2>&1

Hangup Extension — do not append (-n), use fcc.blacklist as-is

# run each day at 08:15
15 08 * * * /usr/share/ncid/sys/get-fcc-list -n > /tmp/get-fcc-list.log 2>&1

bestie these crontab lines are verbatim, do NOT freestyle them. copy, paste, slay. 💅

---

🎀 FILES 🎀

• /usr/share/ncid/sys/get-fcc-list
• prefix3=/etc/ncid/fcc.blacklist
• prefix3=/etc/ncid/ncidd.blacklist
• /var/backups/ncid/

---

🌈 SEE ALSO 🌈

• hangup-fcc.1
• wget.1
• ncidd.8
• crontab.5
• https://consumercomplaints.fcc.gov/hc/en-us/articles/115002234203-Unwanted-Calls

---

and that's the whole page, bestie 💖 go forth and block those unwanted calls 🌸

this lil masterpiece is from NCID, dated 2019-08-17. mwah, take care of her 🫶✨