WC2NCID(1)

📦
version 1.18 · 2 versions
, in fedora 43

💖 WC2NCID(1) — the Whozz Calling ➡️ NCID gateway, bestie edition 💖

okay so. this is a User Contributed Perl Documentation page for the one and only wc2ncid, and it's about to be your new favorite little gateway. pull up a chair 🫶

✨ NAME ✨

wc2ncid — Whozz Calling device to NCID server gateway. it's giving "matchmaker, but for your phone lines and your server" 💅

🌸 SYNOPSIS 🌸

wc2ncid [--debug             | -D]
        [--delay             | -d <seconds>]
        [--help              | -h]
        [--hostname-flag     | -H <0|1>]
        [--logfile-append    | -l <filename>]
        [--logfile-overwrite | -L <filename>]
        [--configfile        | -C <filename>]
        [--man               | -m]
        [--ncidhost          | -n <[host][:port]>]
        [--set-wc]
        [--test              | -t]
        [--pidfile           | -p <filename>]
        [--verbose           | -v <1-9>]
        [--version           | -V]
        [--wchost            | -w <address1>[,address2][,...]

like. look at all those flags. she has range 🌈

🦋 DESCRIPTION 🦋

so the WC (Whozz Calling) gateway snatches Caller ID straight off one or more Whozz Calling Ethernet Link devices. no cap. and the Whozz Calling Ethernet Link device itself handles multi-line Caller ID — we're talking either 2, 4, or 8 telephone lines, depending on the model. the basic models handle incoming calls, and the deluxe models handle incoming and outgoing calls. main character behavior, honestly 👑

wanna see the Whozz Calling feature matrix for all the various models? here:

http://www.callerid.com/feature-table/

and here's the tea: the Whozz Calling devices do not pick-up, go off-hook, or answer the telephone line. periodt. so they cannot be used to hangup the line for phone numbers in the ncidd blacklist file 😭 — but a modem can be used with the WC gateway for the blacklist feature of ncidd, so we're still eating 💅

🎀 REQUIREMENTS 🎀

you're gonna need all of this, bestie, no skipping:

  • The NCID server
http://ncid.sourceforge.net/ncid/ncid.html
  • At least one Whozz Calling Ethernet Link device
http://www.callerid.com
  • perl 5.6 or higher, plus perl(Config::Simple) and perl(Data::HexDump)

💅 OPTIONS 💅

every single one, we're going through them all, i don't make the rules ✨

  • -n <[host][:port]>, --ncidhost <[host][:port]> — specifies the NCID server. you can also specify the port by suffixing the hostname with :<port>. input must be <host> or <host:port>, or <:port>. default: localhost:3333
  • -w <address1[,address2][,...]>, --wchost <address1[,address2],[,...]> — specifies the Whozz Calling Ethernet Link Device (or devices, plural, we love a multitasker). multiple addresses for devices are comma separated. input must be <address> or <address1,address2,etc>. default: 192.168.0.90
  • -d <seconds>, --delay <seconds> — if the connection to the NCID server gets lost, try to reconnect every <delay> seconds. we do not give up on her 💪 default: 15
  • -D, --debug — debug mode, displays all messages that go into the log file. use this option to run interactively. lowkey the best way to watch the drama unfold 👀
  • -H <0|1>, --hostname-flag <0|1> — when the hostname flag is set to 1, the IDENT string sent to a server will include the hostname with the program name. default: 0
  • -h, --help — displays the help message and exits. bye bestie 👋
  • -m, --man — displays the manual page and exits.
  • -C, --configfile <filename> — specifies the configuration file to use. the program will still run if a configuration file is not found. resilient queen 💖 default: prefix3=/etc/ncid/wc2ncid.conf
  • --set-wc — sets the IP address, beginning line number, number of telephone lines, and sending port for each Whozz Calling Ethernet Link Device.

it sets the IP address for the WC device from the address for "wcaddr" in the configuration file or --wchost on the command line.

it automatically sets the beginning line number for the WC device, which is used as a line label prefixed with "WC". each device gets a beginning line number that is the ending line number plus one from the preceeding device, for example; device 1 (WC01 WC02) device 2 (WC03 WC04 WC05 WC06).

NOTE: all devices are automatically configured to send call information on port 3520. 🔥
  • -l, --logfile-append <filename> and -L, --logfile-overwrite <filename> — specifies the logfile name to write. the program will still run if it does not have permission to write to it. if both options are present, --logfile-append takes precedence. she picks favorites, and it's append 🎀 default: append to /var/log/wc2ncid.log
  • -p, --pidfile <filename> — specifies the pidfile name to write. the program will still run if it does not have permission to write a pidfile. the pid filename that should be used is /var/run/wc2ncid.pid. default: no pidfile
  • -t, --test — test mode is a connection to the Whozz Calling Network Device without a connection to the NCID server. it sets debug mode and verbose = 3. the verbose level can be changed on the command line. default: no test mode
  • -v, --verbose <1-9> — output information, used for the logfile and the debug option. set the level to a higher number for more information. levels range from 1 to 9, but not all levels are used. (iykyk 🌸) default: verbose = 1
  • -V, --version — displays the version.

⭐ EXAMPLES ⭐

start wc2ncid, set the IP address to 192.168.1.90 from the command line, set the beginning line number automatically, and set the sending Ethernet port to 3520 (the default):

wc2ncid --set-wc --wchost 192.168.1.90

start wc2ncid in test and debug modes at verbose 5:

wc2ncid -tv5

look at her go 🚀

🍓 FILES 🍓

prefix3=/etc/ncid/wc2ncid.conf

💜 SEE ALSO 💜

wc2ncid.conf.5, wct.1, ncidd.8, ncidd.conf.5, ncid_gateways.7

go read the whole friend group, they all slay 🫶

and that's the whole page, bestie!! this one's perl v5.42.0, dated 2025-08-06, and it's the WC2NCID(1) manual — no cap, you're now officially fluent 💖✨🎀🦋🌸

📦 where this page comes from