admterminal(1M) DG/UX 5.4.2 admterminal(1M)
NAME
admterminal - manage terminal ports
SYNOPSIS
admterminal -o add [ -a alternate-prompt ] [ -d ] [ -i disabled-msg ]
[ -l tty-label ] [ -p pm-tag ] [ -s service ] [ -t
term-variable ] [ -y comment ] tty-num ...
admterminal -o delete [ -p pm-tag ] tty-num ...
admterminal -o modify [ -a alternate-prompt ] [ -d ] [ -i disabled-
msg ] [ -l tty-label ] [ -p pm-tag ] [ -s service ] [ -t
term-variable ] [ -y comment ] tty-num
admterminal -o disable [ -p pm-tag ] tty-num ...
admterminal -o enable [ -p pm-tag ] tty-num ...
admterminal -o list [ -qvx ] [ -p pm-tag ] tty-num ...
DESCRIPTION
Admterminal manages terminal ports monitored by ttymon(1M) port
monitors under control of the Service Access Facility. It provides
access to the most commonly-used terminal management options provided
by ttymon and is intended as a simple alternative to the more complex
admportservice(1M) and pmadm(1M) commands.
Operations
add Add one or more new terminals to be monitored by a ttymon
port monitor. If no ttymon port monitors exist, the
default port monitor, ttymon1, will also be added as part
of this operation.
delete Remove one or more terminals from those being monitored by
a ttymon port monitor.
disable Disable one or more terminals. A disabled terminal will
not accept user logins.
enable Enable one or more disabled terminals.
modify Change attributes of a terminal.
list List information about one or more terminals. If a
specific ttymon port monitor is specified via -p pm-tag,
the listing is restricted to those terminals monitored by
that port monitor.
Options
-a alternate-prompt
Alternate login prompt for the terminal. The default login
prompt is "login: ".
Licensed material--property of copyright holder(s) 1
admterminal(1M) DG/UX 5.4.2 admterminal(1M)
-d Disabled. If this option is specified, the terminal(s)
will be disabled when added. Terminals are enabled by
default.
-i disabled-msg
Disabled message. This is the message that will be
displayed on a terminal when it is disabled. The default
is to display no message.
-l tty-label
The name of an ttydefs(4) entry which specifies the line
speed and other terminal settings. The default tty-label
is "9600".
-p pm-tag Port monitor tag. The name of the controlling ttymon port
monitor for the terminal(s). This option is required only
if the system has more than one ttymon port monitor. If
only one ttymon port monitor is present on the system, it
is used by default. If this option is specified for the
list operation, the listing will be restricted to those
terminals monitored by the specified port monitor.
-q "Quiet." List minimal information. Only the device file,
port monitor, tty label, state and comment for each
terminal are listed.
-s service
Login service for the terminal(s). This is the program
that will be called when a user attempts to login to the
terminal(s). The default login service is /usr/bin/login.
-t term-variable
The value to which the TERM environment variable should be
set before invoking the login service. If this option is
not specified, the TERM variable will not be set.
-y comment
Comment associated with the terminal.
-v "Verbose." Produce a detailed, formatted listing. This is
the default output format.
-x "Extended." List the TERM variable setting in addition to
the other information about each terminal. Use of this
option will degrade the performance of the list command
because the TERM variable must be retrieved from a separate
file for each terminal.
Output
The "verbose" format of the list operation reports the following
information to stdout: terminal device file, port monitor, tty
label, state, service, prompt, disabled message and comments. If -x
is specified, the value of the TERM variable will be listed before
the comments. The information is presented with labels and
Licensed material--property of copyright holder(s) 2
admterminal(1M) DG/UX 5.4.2 admterminal(1M)
indentation suitable for easy viewing.
The "quiet" output format reports the terminal device file, port
monitor, tty label, state and comments for each terminal. If -x is
specified, the value of the TERM variable will be displayed as
"TERM=value" before the comments field. Information for each
terminal is printed on a single line and each field is delimited by
spaces. The comments field is preceded by a pound sign (#).
FILES
/etc/ttydefs
File which contains entries for defining line speed and
other terminal settings.
DIAGNOSTICS
Errors
admterminal uses ttyadm(1M) and pmadm(1M) to perform the requested
operation for the terminal(s). It reports any error conditions
returned by these commands.
Exit Codes
0 The operation was successful.
1 The operation was unsuccessful.
2 The operation failed due to access restrictions.
3 There was an error in the command line.
SEE ALSO
login(1), admportmonitor(1M), admportservice(1M), pmadm(1M), sac(1M),
sacadm(1M), ttyadm(1M), ttymon(1M), ttydefs(4M), Managing the DG/UX
System.
NOTES
All operations except for list require superuser access.
Licensed material--property of copyright holder(s) 3