TSAPD(8C)

NAME
tsapd - OSI transport listener

SYNOPSIS
tsapd [-d] [-f] [-t] [-x] [-b] [-z] [-8] [-r] [-p portno] [-a x121address] [-i pid] [-A X121address] [-I pid] [-N NSAP]
(under /etc/rc.local)

DESCRIPTION
The tsapd server listens for OSI transport connections on the local host.

For a TCP-based network service, the server implements the protocol described in RFC1006. Basically, the server listens on TCP port 102 for connections, decodes the connection request packet, and execs the appropriate program to enter the protocol and provide the service. The `-p' option overrides the default TCP port.

For an X.25-based network service, the server implements the transport class 0 protocol, decodes the connection request packet, and execs the appropriate program to enter the protocol and provide the service. The `-a' switch is used to specify the X.121 address of the local host — this overrides the entry in the isotailor file. In addition, the `-i' switch is used to specify the protocol ID to listen on. Note that on most X.25 implementations, if the local X.121 address is not present in the isotailor file, then the `-a' switch must be used in order for the transport server to receive incoming calls.

If the tp0bridge is providing the X.25-based network service, the `-A' switch is used to specify the X.121 address of the local host. In addition the `-I' switch is used to specify the protocol ID to listen on.

For an X.25(1984)-based network service or CLNS-based network service, the `-N' switch is used to specify the NSAP address of the local host. A default address can be given with the `local_nsap' option in isotailor.

For a TP4-based transport service, the server simply listens to any incoming connections, and execs the appropriate program to provide the service.

By default, all network services are enabled (if defined in the configuration). The `-t' option specifies TCP-only operation, the `-x' option specifies X.25-only operation, the `-b' option specifies tp0bridge-only operation, the `-8' option specifies X.25(1984)-only operation, and the `-z' option specifies TP4-only operation.

Since tsapd reads the isoservices (5) file to determine which program to run when an incoming connection is received, if tsapd is running as root then it checks to see that the isoservices file is also owned by root. The `-r' option disables this check.

Unless the `-f' option is given or debug mode (see below) is enabled tsapd will put itself into background.

As a further precaution, tsapd runs the program with permissions set to the owner and group of the program. Hence, unpriviledged programs can be invoked directly under tsapd.

DEBUG OPERATION
If tsapd is started interactively, or if the `-d' switch is given, then debug mode is entered. In this case, all logging activity is displayed on the user's terminal, the logging information is more verbose, and tsapd will terminate after it handles the first incoming connection (this allows tsapd to be run under a debugger).

EXAMPLES
For most installations,

tsapd &

run under /etc/rc.local is sufficient. This runs TCP-, X.25-based and/or TP4-based services, depending on the configuration.

FILES
isoservices	ISODE services database
tsapd.log	log file

SEE ALSO
iaed(8c), isoservices(5)

AUTHOR
Marshall T. Rose