Stand: November 1995

ceptd(8) online manual


NAME

ceptd - Server for the xcept videotext-decoder

SYNOPSIS

ceptd [-uFilename] [-pPort] [-d] [-iFilename] [-lFilename]

DESCRIPTION

ceptd is the server process for the xcept videotext-decoder. The server uses the TCP protocol and listens at the port specified in the command line or in the ``ceptd'' service specification; see services(5). ceptd can be started from within the inetd. If not started from inetd, ceptd will deal with connection requests by forking on connects. If the standard input of ceptd is not a tty, ceptd assumes to have been started from inetd.

Available options:

-p Port or -pPort
Listen for connections on port with number ``port''. This option is only available if ceptd is not started from inetd.

-i Filename or -iFilename
Use file with filename ``filename'' as the modem initialization file. Executed when xcept establishes a connection.

-u Filename or -uFilename
Use file with filename ``filename'' as the user access file. Access permissions are checked at every connection.

-l Filename or -lFilename
Use file with filename ``filename'' as the user log file. This file contains the user online times and will be updated after every session.

-d
Write additional debug output to the syslog or to the standard error. If ceptd is started from inetd, error and debug output is written to the syslog, otherwise it is written to stderr.

The default values for the `initialization file', for the `permissions file', for the `log file' and the socket port number are displayed when ceptd prints out its usage information.

INITIALIZATION FILE

This file contains commands to initialize the server at connection setup and is a Tcl script. Available ceptd special commands are:

CeptdOpenDevice devicename speed
Open the modem device with baud rate ``speed'' and device name ``devicename''. In case the modem is not available -1 is returned.

CeptdOpenISDN devicename ISDN-address
Open the ISDN device ``devicename'' using the ISDN address (usually a service indicator and the phone number). In case ISDN has not been configured -1 is returned.

CeptdSendString string
Send ``string'' to the device previously opened. String can contain all the usual characters plus the ``~'' character to signal ceptd to pause 1 seconds before proceeding with the rest of the string.

CeptdSendToClient string
Send ``string'' to the xcept(1) client. String should contain layer 6 to be displayed from xcept(1). Also note: Tcl processes the string first, i.e. you need to escape ``\'' and ``$'' unless you want Tcl to operate on them (e.g. you want to have a variable expanded).

CeptdSleep time
Sleep for ``time''/10 seconds.

CeptdSendStatus status-string
Sends ``status-string'' back to the connecting xcept(1) client. Status-string must be one of UNSET, MODEMCONNECT, ABORT, NOCARRIER, BUSY, NODIALTONE, NOPERMISSION, TIMEOUT, MODEMOPENFAIL, HANGUP, ISDNOPENFAIL, ISDNBUSY, ISDNCONNECT, or ISDNDISCONNECT. All other codes will result in an error message.

CeptdWait time string string .....
Wait at most ``time'' seconds for one of the given strings to be returned by the modem. Return the received string or TIMEOUT.

SPECIAL VARIABLES:

CeptdHangupString
This variable is monitored by ceptd and its content is sent to the modem when the modem should hangup.
Example: set CeptdHangupString "~+++~ATH\r"

CeptdStatus
This variable is set by ceptd after opening the communication device (modem, ISDN). E.g. this variable could have the value MODEMOPENFAIL after the CeptdOpenDevice command.

Have a look at the init.cept file supplied for an example of how to create a suitable init tcl script (you probably have to adapt it to your kind of modem).

PERMISSIONS FILE

This file contains all users who are allowed to use the ceptd. The following entries are possible:

a comment: # foo bla foo
a user entry: username
a host entry: @hostname [UNSECURE]
a user/host entry: username@hostname [UNSECURE]

The user username@machine gets permission to use the ceptd if the file contains one of the following:

username@machine

OR

@machine
username

A user gets access if he is mentioned explicitly with his machine (user/host entry) OR if his machine is among the allowed hosts (host entry) and he is among the allowed users (user entry). Access verification is done via identd(8). The optional UNSECURE flag switches the identd(8) verification for the corresponding entries off. This is usefull for client-hosts that do not support the identd(8) protocol.

FILES

/local/btx/etc/users.ceptd
/local/btx/etc/init.ceptd
/local/btx/etc/log.ceptd

AUTHORS

Arno Augustin, University of Erlangen-Nuremberg,
aoaugust@cip.informatik.uni-erlangen.de

Frank Hoering, University of Erlangen-Nuremberg,
fkhoerin@cip.informatik.uni-erlangen.de

SEE ALSO