admxterminal(1M) DG/UX 5.4.2 admxterminal(1M)
NAME
admxterminal - manage serving of X display terminals
SYNOPSIS
admxterminal -o add [ -b bootstrap ] hostname ...
admxterminal -o modify [ -b bootstrap ] hostname ...
admxterminal -o delete hostname ...
admxterminal -o list [ -qv ] [ hostname ... ]
DESCRIPTION
All X display terminals, when they begin operation, must obtain a
bootstrap from a bootstrap file on some computer system, called the
``server''. The server machine must recognize requests from X
terminal clients, and provide the appropriate bootstrap. The
admxterminal command is run on the server machine to identify X
display terminals that the machine must serve and the bootstrap file
to use for each. The command can also be used to delete an X display
terminal from the list of terminals that are to be served, and it can
list all X terminals that are being served.
Operations
add Identify an X terminal, using its network host name, to be
served by this machine. A bootstrap file may also be
specified. The X terminal must be registered in both the
hosts database (using admhost(1M)) and the ethers database
(using admether(1M)) before being added as a client.
modify Change the bootstrap file used for an X terminal.
delete Remove an X terminal, given its network host name, from the
list of terminals that must be served by this machine.
list Display information about all or selected X terminals. The
information includes the network address and the bootstrap
file.
Options
-b bootstrap
The pathname of the bootstrap file. The default bootstrap
file is /usr/opt/X11/xtd/avx30boot.
-q Quiet. Omit header lines from the output of the list
operation.
-v Verbose. Include header lines in the output of the list
operation. This option is enabled by default.
EXAMPLES
To add an X terminal named ``xterm1'' using the default bootstrap
file:
Licensed material--property of copyright holder(s) 1
admxterminal(1M) DG/UX 5.4.2 admxterminal(1M)
admxterminal -o add xterm1
To list all X terminals served by this host:
admxterminal -o list
OUTPUT
The output of the list operation includes each client host name,
client Internet address, name of bootstrap link in the /tftpboot
directory (the hexadecimal representation of the Internet address),
and the actual bootstrap file.
Unless the -q option is used, a message is displayed if there are no
X display terminals being served and header lines are produced if
there are.
FILES
/usr/opt/X11/xtd/avx30boot The default bootstrap file.
/tftpboot Directory containing bootstrap file
links for each client.
DIAGNOSTICS
Warnings
- An attempt was made to add an X terminal that is already being
served by this machine.
- The bootstrap file for the X terminal cannot be removed during
a delete operation, but the remainder of the operation
completed successfully.
Errors
- The X terminal is not registered in the hosts or ethers
database.
- The X terminal is not a client of this machine, or it is a
diskless client and not an X terminal client (delete).
- The bootstrap file does not exist.
- The bootstrap file link could not be created.
Exit Codes
0 The operation was successful.
1 The operation was unsuccessful.
2 The operation failed due to access restrictions. The add,
modify, and delete operations can only be used by the super-
user.
3 There was an error in the command line.
Licensed material--property of copyright holder(s) 2
admxterminal(1M) DG/UX 5.4.2 admxterminal(1M)
SEE ALSO
admether(1M), admhost(1M), sysadm(1M), X(1), xtdstart(1).
Licensed material--property of copyright holder(s) 3