Administering the ttymon port monitor

What ttymon does

ttymon has the following functions:

It initializes and monitors terminal ports.
It sets terminal modes and line speeds for each port it monitors.
It identifies and authenticates users.
It invokes the service associated with a given port whenever it receives a connection request on that port.

Each instance of ttymon has its own administrative file that specifies the ports to monitor and the services associated with each port. The file contains a ``ttylabel'' field that refers to a speed and tty definition in the /etc/ttydefs file. See ttyadm(1M) for a description of the information specific to ttymon that is contained in a ttymon administrative file.

When ttymon is started, it initializes all ports specified in its administrative file. ttymon then pushes the specified STREAMS modules on the user-accessible channel, sets speed and initial termio(7) settings, and writes the prompt. It then waits for user input.

If the user indicates that the speed is inappropriate by pressing the <Break> key, ttymon hunts to the next ``ttylabel'' in the /etc/ttydefs file, (see ttydefs(4)), adjusts termio values, and writes the prompt again. When valid input is received, that is, one or more non-break keys followed by a newline, ttymon interprets the per-service configuration file for the port, if one exists, invokes the identification and authentication scheme specified in the port monitor's administrative file, updates the utmp and wtmp files, sets and initializes the environment variables that create the service environment, and invokes a service. The login authentication scheme is the scheme most commonly associated with ttymon (see login(1)). The service invoked will normally be /usr/bin/shserv, which will invoke the shell specified in the /etc/passwd file.