cideasy2ncid - Man Page
CIDEasy Caller ID device to NCID server gateway
Synopsis
cideasy2ncid [options]
Options:
[--configfile <filename> | -C <filename>] [--debug | -D] [--delay <seconds> | -d <seconds>] [--help | -h] [--hostname-flag <0|1> | -H <0|1>] [--logfile <filename> | -L <filename>] [--ncidhost <[host][:port]> | -n [host][:port]>] [--pidfile <filename> | -p <filename>] [--test | -t] [-v <1-9> | --verbose <1-9>] [-V | --version] [--osx-launchd]
Description
The cideasy2ncid gateway sends Caller ID messages in a modified MDMF format. Model-E and Model-F are supported. Model-E has two telephone line inputs labeled A and B. Model-F has four telephone line inputs labeled A, B, C and D.
The line identifier is set to CIDEASY-<port> (CIDEASY-A, CIDEASY-B, etc). It can be aliased by the NCID server so you can give each phone line a meaningful identification such as the last 4 digits of the phone number. For example: 1234. You can even use the complete phone number if you desire.
The configuration file for cideasy2ncid is /etc/ncid/cideasy2ncid.conf. It may be located in same directory as the script, or in the etc directory, or in NCID default configuration directory. Read the comments in the config file for more details.
The -fIcideasy2ncid=fR device can run on any system, but normally it is run on same box as the NCID server. If it is not run on the same box as the NCID server, you must configure the server IP address in the configuration file.
Options
- -C <filename> | --config <filename>
Configuration file.
Default: /etc/ncid/cideasy2ncid.conf- -D | --debug
Debug mode, cideasy2ncid stays attached to the terminal and displays all messages that go into the log file.
- -h | --help
Displays the help message and exits.
- -H <0|1> | --hostname-flag <0|1>
When the hosthame flag is set to 1, the IDENT string sent to a server will include the hostname with the program name.
Default: 1- -L <filename> | --logfile <filename>
Specifies the logfile name to use.
Default: /var/log/cideasy2ncid.log- -P <filename> | --pidfile <filename>
Specifies the pidfile name to write. Set to /var/run/cideasy2ncid.pid in an rc or init script when used as a service. The program will still run if it does not have permission to write a pidfile. There is no default. If pidfile is not set, no pid file will be used.
- --test | -d
Test mode, cideasy2ncid stays attached to the terminal and no connection is made to the server. Displays all messages that go into the log file.
Test mode sets debug mode and verbose = 3. The verbose level can be changed on the command line.
- -v <1-9> | --verbose <1-9>
Verbose mode. Send information into the logfile and display information for the -D option. Set a higher number for more information.
To debug, try: verbose = 4 or 5
Default: 1- -V | --version
Displays the version then exits
- --osx-launchd
This option is only for OSX when using launchd to control ncidd. It prevents ncidd from entering daemon mode. It is like debug mode, but nothing is printed to the screen.
Requirements
CIDEasy device
Files
/etc/ncid/cideasy2ncid.conf
See Also
cideasy2ncid.conf(5), ncidd(8), ncidd.conf(5), ncid_gateways(7)