Copyright (c) 1996, Sun Microsystems, Inc. All Rights Reserved.
Copyright 1989 AT&T
The contents of this file are subject to the terms of the Common Development and Distribution License (the "License"). You may not use this file except in compliance with the License.
You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE or http://www.opensolaris.org/os/licensing. See the License for the specific language governing permissions and limitations under the License.
When distributing Covered Code, include this CDDL HEADER in each file and include the License file at usr/src/OPENSOLARIS.LICENSE. If applicable, add the following below this CDDL HEADER, with the fields enclosed by brackets "[]" replaced with your own identifying information: Portions Copyright [yyyy] [name of copyright owner]
/usr/sbin/ttyadm [-b] [-c] [-h] [-I] [-r count] [-i msg] [-m modules] [-p prompt] [-t timeout] [-S y | n] [-T termtype] -d device -l ttylabel -s service
/usr/sbin/ttyadm -V
The ttyadm command is an administrative command that formats ttymon(1M)-specific information and writes it to standard output. The Service Access Facility (SAF) requires each port monitor to provide such a command. Note that the port monitor administrative file is updated by the Service Access Controller's administrative commands, sacadm(1M) and pmadm(1M). ttyadm provides a means of presenting formatted port monitor-specific (ttymon-specific) data to these commands.
The following options are supported:
-b
Set the ``bi-directional 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(1M), cu(1C), or ct(1C) can use it for dialing out.
-c
Set 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
Set 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 0 before setting the speed to the default or specified value.
-i message
Specify 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.
-I
Initialize only. If the -I option is used, ttymon will invoke the service only once. This can be used to configure a particular device without actually monitoring it, as with software carrier.
-l ttylabel
Specify which ttylabel in the /etc/ttydefs file to use as the starting point when searching for the proper baud rate.
-m modules
Specify 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.
-p prompt
Specify 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 0, ttymon will wait until it receives any character. If count is greater than 0, 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 (" ").
-S y|n
Set the software carrier value. y will turn software carrier on. n will turn software carrier off.
-t timeout
Specify that ttymon should close a port if the open on the port succeeds, and no input data is received in timeout seconds.
-T termtype
Set the terminal type. The TERM environment variable will be set to termtype.
-V
If successful, ttyadm will generate the requested information, write it to 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 standard error and ttymon will exit with a non-zero status.
ct(1C), cu(1C), pmadm(1M), sacadm(1M), ttymon(1M), uucico(1M), attributes(5)