admether(1M)                   DG/UX R4.11MU05                  admether(1M)


NAME
       admether - manage ether database

SYNOPSIS
       admether -o add [ -y ] -a host-ether-address host-name

       admether -o modify [ -y ] [ -n new-host-name ] [ -a host-ether-
                address ] host-name

       admether -o delete [ -yq ] host-name ...

       admether -o list [ -y ] [ -qv ] [ -s ] [ host-name ...  ]

DESCRIPTION
       admether manages the local or NIS (YP) ethers database.  The ethers
       database consists of a list of host names and the Ethernet address
       for each.

   Operations
       add       Create a new ethers entry.

       modify    Change an existing entry to contain a new host name or a
                 new Ethernet address, or both.

       delete    Remove an entry from the ethers database.

       list      List one or more entries from the ethers database.
                 Information is listed about each of the host-names given;
                 if host-name is all, information about all hosts is listed.

   Options
       -y        Perform the requested operation on the global NIS database.
                 Without this option, the requested operation is performed
                 on the local database in the /etc directory.  If specified
                 with the add, delete, or modify operations, this option is
                 valid only if the machine on which the command is run is
                 the NIS master.  The -y option uses the default domain name
                 derived from the SRC_DIR variable specified in the NIS
                 makefile (/etc/yp/Makefile).

       -a host-ether-address
                 host-ether-address is the Ethernet address of the host
                 being added.  If this option is excluded on modify, the
                 current Ethernet address for the host is preserved.

       -n new-host-name
                 new-host-name is the new name of the host.  Without this
                 option, the host name is not changed.

       -q        "Quiet."  Produce an unformatted listing.  Print no
                 headers, print fields in the order they appear in the
                 database, print each entry on a separate line, and delimit
                 fields within an entry with a single space character.  When
                 this option is used with the delete operation, no
                 confirmation is presented before the host-name is deleted.

       -s        "Sort." Sort the listing by host name.

       -v        "Verbose."  Produce a formatted listing with headers and
                 aligned columns.  This is the default.

       admether expects all Ethernet addresses to be of the form

            aa:bb:cc:dd:ee:ff,

       where a, b, c, d, e, and f are two-digit hexadecimal numbers between
       00 and ff.  All 17 characters must be given.

OUTPUT
       The list operation writes its output to stdout.

       The verbose form of the list operation outputs the name and Ethernet
       address for each host.  Information is printed in aligned columns
       with column headers.

       If -q option is specified with the list operation, headers are
       suppressed and each entry is printed on a separate line.  The fields
       within the entry are delimited by a single space, and are in the
       following order:
                  ethernet_address host_name

FILES
       /etc/ethers
                 Local ethers database file.

       /etc/yp/yp-domain/ethers
                 NIS ethers database file.

DIAGNOSTICS
   Warnings
       None.

   Errors
        -  The -y option is specified for an add, delete, or modify
           operation and the host is not the NIS master.

        -  The add operation is requested, and host-name already exists in
           the ethers database.

        -  The modify operation is requested, and new-host-name already
           exists in the ethers database.

        -  The host-ether-address is not a valid network address.

        -  The -y option is given, and there is an error exporting NIS maps.

        -  The delete or modify operation is requested, and host-name does
           not exist in the ethers database.

   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.

NOTES
       You must have write permission to the ethers database to use the add,
       delete, and modify operations.  To have such permission, you must
       have appropriate privilege.  On a generic DG/UX system, appropriate
       privilege is granted by having an effective UID of 0 (root).  See the
       appropriate_privilege(5) man page for more information.

       On a system with DG/UX information security, appropriate privilege is
       granted by having one or more specific capabilities enabled in the
       effective capability set of the user.  See cap_defaults(5) for the
       default capabilities for this command.

SEE ALSO
       domainname(1), sysadm(1M), ethers(4), cap_defaults(5).


Licensed material--property of copyright holder(s)