NCIDD.CONF(5)

💖 NAME 💖

ncidd.conf — it's the configuration file for ncidd, the Network Caller ID Server. Yes bestie, the whole server's personality lives in here. ✨

---

🌸 DESCRIPTION 🌸

Okay so real talk: ncidd.conf is where all the configuration info for ncidd (the Network Caller ID Server, the main character) lives. 💅

You use ncidd.conf to set options. Options are set on a command line. A line gets broken up into words, and a word is either a string of non-blank characters, everything between double quotes, or an equal sign. That's it, that's the whole word salad situation. 🥗

This file understands 4 types of lines, and honestly? Very demure, very mindful:

• blank line — ignored. it's giving nothing and that's on purpose 🫥
• comment line, beginning with # — ignored. your lil notes to yourself, safe from the parser 🙈
• command lines, beginning with send — the sending vibes
• command lines, beginning with set — the setting vibes

✨ the send lines ✨

send DATATYPE

where DATATYPE = cidlog or cidinfo. Those are the only two options, no cap. 🎀

Most gateways and the command line option of ncid do not need the cidlog. They send a HELLO command at connect so the server does not send cidlog. see, it's polite. it said hi first. 👑

✨ the set lines ✨

set ITEM = VALUE [ITEM = VALUE] [...]

where ITEM = one of these iconic little guys:

• announce
• audiofmt
• blacklist
• cidalias
• cidinput
• cidlog
• cidlogmax
• datalog
• gencid
• hangup
• hupmode
• hupname
• huprmd
• ignore1
• initcid
• initstr
• lineid
• lockfile
• pickup
• pidfile
• port
• regex
• send
• ttyclocal
• ttyport
• ttyspeed
• verbose
• whitelist

You can chain more than one ITEM = VALUE on the same line too, hence the [...]. multi-tasking queen. 💖

---

🦋 EXAMPLES 🦋

okay now the fun part, let's actually do stuff. 🌈

Send the CID log to each client at connect:

send cidlog

Send the ring count, at each ring, to each client:

send cidinfo

Caller ID from a modem and optional gateways:

set cidinput = 0  # default

Caller ID from a serial or USB device and optional gateways:

set cidinput = 1

Caller ID from gateways without modem support:

set cidinput = 3

Caller ID from a gateway with modem support for hangup and dialing a number. The gateway and modem must be using the same telephone line:

set cidinput = 2

Set the Telephone Line Indicator for the modem providing support to the xdmf2ncid gateway when its gateway line indicator is "CometUSB0":

set lineid = CometUSB0

Set the Telephone Line Indicator for the modem providing support to the xdmf2ncid gateway when its gateway line indicator is "HoltekUSB0":

set lineid = HoltekUSB0

Set the Telephone Line Indicator for the modem:

set lineid = POTS

Automatically hangup on a call in the blacklist using a modem: (Gateways must have modem support)

set hangup = 1

Set the modem port for a USB modem:

set ttyport=/dev/ttyACM0

Set the modem for Caller ID:

set initcid = "AT#CID=1"

Ignore modems that do not send Caller ID:

set gencid = 0

💀 bestie note: keep the quotes where the quotes are. "AT#CID=1" and "CometUSB0" are living their quoted life for a reason — copy them exactly, don't get cute and strip them.

---

🧚 SEE ALSO 🧚

• ncidd.8
• ncidd.alias.5
• ncidd.blacklist.5
• ncidd.whitelist.5

go read those too, they're the rest of the lore 📚✨

---

and that's the whole page, bestie!! 🎀 this was NCID, dated 2022-11-8 — so yeah, this manual is from the NCID era, 2022-11-8, periodt. tysm for reading, now go configure something iconic 💖🦋💅