ttyadm(1M) DG/UX R4.11MU05 ttyadm(1M)
NAME
ttyadm - format and output TTY port monitor information
SYNOPSIS
/usr/sbin/ttyadm [ -b ] [ -c ] [ -r count ] [ -h ]
[ -i msg ] [ -m modules ] [ -p prompt ] [ -t timeout ]
-d device -l ttylabel -s service
/usr/sbin/ttyadm -V
where:
count is the prompt delay, an integer character count
msg is the "disabled" message, a character string
modules is a comma-separated list of STREAMS modules
prompt is a character string specifying the TTY prompt
timeout is the time to wait in seconds
device is the path to a character-special device file
ttylabel is an entry in the TTY settings file /etc/ttydefs
service is the command line for a port service program
DESCRIPTION
The ttyadm command is an administrative command that formats
information specific to ttymon(1M) and writes it to the 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 (sac(1M))
administrative commands, sacadm(1M) and pmadm(1M). ttyadm provides a
means of presenting formatted port monitor-specific (i.e., ttymon-
specific) data to these commands. (See the NOTE section for higher-
level management interfaces.)
Options are:
-b Set the "bidirectional port" flag. When this flag is
set, the line can be used in both directions.
ttymon(1M) will allow users to connect to the service
associated with the port, but if the port is free,
uucico(1M), cu(1), or ct(1) can use it for dialing out.
-c Set the "connect-on-carrier" flag for the port. If the
-c flag is set, ttymon(1M) will invoke the port's
associated service immediately when a connect
indication is received (i.e., no prompt is printed and
no baud-rate searching is done).
-d device Specify the device node for the TTY port. device is
the full pathname of a character-special device file.
-h Set the hangup flag for the port. If the -h flag is
not set, ttymon(1M) 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 Specify the inactive (disabled) response message. This
message will be sent to the TTY port if the port is
disabled or the ttymon(1M) monitoring the port is
disabled.
-l ttylabel Specify the ttylabel in the TTY settings file
(/etc/ttydefs) 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 (leftmost first), before the service is
invoked. modules must be a comma-separated list of
STREAMS modules, with no white space included. Any
modules currently on the stream will be popped before
these modules are pushed.
-r count Specify the delay before printing a prompt. When the
-r option is used, ttymon(1M) will wait until it
receives data from the port before it displays a
prompt. If count is equal to zero, ttymon(1M) will
wait until it receives any character. If count is
greater than zero, ttymon(1M) will wait until count New
Line characters have been received.
-p prompt Specify the prompt message that ttymon(1M) will
display. If this option is not given, then ttyadm uses
the default value "login: ".
-s service Specify the service to be invoked. service is the full
pathname of the program to be invoked when a connection
request is received. If arguments are required, the
command and its arguments must be enclosed in double
quotes.
-t timeout Specify the port timeout. ttymon(1M) should close the
port if the open on the port succeeds and no input data
is received in timeout seconds.
-V Display the version number of the current
/usr/lib/saf/ttymon command. This option is mutually
exclusive with all other options.
FILES
/etc/ttydefs TTY settings file
DIAGNOSTICS
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 ttyadm will exit with a non-zero
status.
SEE ALSO
ct(1), cu(1), admportservice(1M), admterminal(1M), pmadm(1M),
sac(1M), sacadm(1M), sttydefs(1M), ttymon(1M), uucico(1M), Managing
the DG/UX System.
NOTE
ttyadm is a low-level interface to ttymon(1M) port and service
management. For a high-level, user-friendly interface, use the "Port
Services" or "Terminals" menu of sysadm(1M) or xsysadm(1M). For an
intermediate-level, object-oriented interface, use the
admportservice(1M) or the admterminal(1M) utility.
Licensed material--property of copyright holder(s)