admterminal(1M) DG/UX 5.4R3.00 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 [ -q ] [ -p pm-tag ] tty-num ...
admterminal -o modify [ -a alternate-prompt ] [ -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 [ -quvx ] [ -p pm-tag ] tty-num ...
admterminal -o users 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.
users Display information about any processes that are using one
or more terminals.
Licensed material--property of copyright holder(s) 1
admterminal(1M) DG/UX 5.4R3.00 admterminal(1M)
Options
-a alternate-prompt
Alternate login prompt for the terminal. The default login
prompt is "login: ".
-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." Produce a minimal, unformatted listing (i.e. no
headers, fields delimited by a single space) when used with
the list operation. This option will also suppress
confirmation prompts when used with the delete operation.
-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.
-u "Users." Display information about any processes that are
using each terminal, in addition to the information
normally displayed by the list operation.
-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
Licensed material--property of copyright holder(s) 2
admterminal(1M) DG/UX 5.4R3.00 admterminal(1M)
option will degrade the performance of the list operation
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
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 (#).
If -u is specified, the list operation adds information about any
processes that are using a terminal to the other output associated
with that particular terminal. If fuser reports that one or more
processes have the terminal open, the additional information consists
of the output of ps -fjp on a sorted list of process IDs with
duplicates eliminated. If no processes have the terminal open, no
additional information is displayed.
The users operation passes all its arguments in a single call to
fuser, and calls ps once with a list of processes that have any of
the specified terminals open (if any such processes are found).
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
admportmonitor(1M), admportservice(1M), fuser(1M), login(1),
pmadm(1M), ps(1), sac(1M), sacadm(1M), ttyadm(1M), ttymon(1M),
Licensed material--property of copyright holder(s) 3
admterminal(1M) DG/UX 5.4R3.00 admterminal(1M)
ttydefs(4M), Managing the DG/UX System.
NOTES
Superuser privilege is required for all operations except list and
users.
Licensed material--property of copyright holder(s) 4