admxterminal(1M)                 DG/UX R4.11                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:

            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.  You must
              have appropriate privilege to perform all operations except
              list.  For systems supporting the DG/UX Capability Option,
              appropriate privilege is defined as having one or more
              specific capabilities enabled in the effective capability set
              of the user.  See capdefaults(5) for the default capabilities
              for this command.

       On systems without the DG/UX Capability Option, appropriate privilege
       means that your process has an effective UID of root.  See the
       appropriateprivilege(5) man page for more information.

        3     There was an error in the command line.

SEE ALSO
       admether(1M), admhost(1M), sysadm(1M), appropriateprivilege(5).
       capdefaults(5).
       X(1), xtdstart(1).


Licensed material--property of copyright holder(s)