ttyadm(1M)

ttyadm -- format and output port monitor-specific information

Synopsis

/usr/sbin/ttyadm [-P] [-b] [-c] [-r count] [-h] [-i msg] [-m modules] [-p prompt] [-t timeout] [-o] -d device -l ttylabel -s service

/usr/sbin/ttyadm -V

Description

The ttyadm command formats data from ttymon(1M) and writes it to standard output, from where it can be used by the sacadm(1M) and pmadm(1M) commands to update the administrative file for ttymon. The Service Access Facility (SAF) requires each port monitor to provide such a command.

ttyadm is the front-end for the ttymon Daemon Mode.

-P: Instructs the ttymon port monitor that PPP is being used over the link, so that call services information is passed to the PPP shell, via the calls_t structure. See Callfilter(4bnu) and Callservices(4bnu) for more information.
-b: Sets the bidirectional port flag. When this flag is set, the line can be used in both directions. ttymon will allow users to connect to the service associated with the port, but if the port is free, uucico, cu, or ct can use it for dialing out.
-c: Sets the connect-on-carrier flag for the port. If the -c flag is set, ttymon will invoke the port's associated service immediately when a connect indication is received (that is, no prompt is printed and no baud-rate searching is done).
-d device: device is the full pathname of the device file for the tty port.
-h: Sets the hangup flag for the port. If the -h flag is not set, ttymon will force a hangup on the line by setting the speed to zero before setting the speed to the default or specified value.
-i message: Specifies the inactive (disabled) response message. This message will be sent to the tty port if the port is disabled or the ttymon monitoring the port is disabled.
-l ttylabel: Specifies which ttylabel in the /etc/ttydefs file to use as the starting point when searching for the proper baud rate.
-m modules: Specifies a list of pushable STREAMS modules. The modules will be pushed, in the order in which they are specified, before the service is invoked. modules must be a comma-separated list of modules, with no white space included. Any modules currently on the stream will be popped before these modules are pushed.
-o: Enables support for port initialization in some modems. The modem dialer is invoked via the dials(3N) call which resets the modem to a default configuration.
-p prompt: Specifies the prompt message, for example, login:.
-r count: When the -r option is invoked, ttymon will wait until it receives data from the port before it displays a prompt. If count is equal to zero, ttymon will wait until it receives any character. If count is greater than zero, ttymon will wait until count newlines have been received.
-s service: service is the full pathname of the service to be invoked when a connection request is received. If arguments are required, the command and its arguments must be enclosed in double quotes.
If service is specified as auto, then ttymon determines which service to invoke using the /etc/ics/Callservices file, see Callservices(4bnu) for information.
-t timeout: Specifies that ttymon should close a port if no input data is received in timeout seconds from the beginning of a connect indication.
-V: Displays the version number of the current /usr/lib/saf/ttymon command.

Exit codes

If successful, ttyadm will generate the requested information, write it on the standard output, and exit with a status of 0. If ttyadm is invoked with an invalid number of arguments or invalid arguments, or if an incomplete option is specified, an error message will be written to the standard error and ttymon will exit with a non-zero status.

Files

/etc/ttydefs
/usr/lib/locale/locale/LC_MESSAGES/uxcore.abi: language-specific message file (see LANG on environ(5)).

Usage

When using the -b option with the -r 0 option, only one character needs to be given in order to return a prompt.

References

Callfilter(4bnu), Callservices(4bnu), Dialers(4bnu), pmadm(1M), sacadm(1M), sttydefs(1M), ttymon(1M)

Notices

-r should not be used with a modem configured for a switched carrier. If the -r count is too low, the tty line may go into an infinite echo loop, which will cause the RX/TX lights to flash wildly.