admalias(1M)                     DG/UX R4.11                    admalias(1M)


NAME
       admalias - manage mail alias information in the aliases database

SYNOPSIS
       admalias -o add [ -y ] -m member-list mailalias

       admalias -o modify [ -y ] [ -n new-mailalias ] [ { -m member-list |
                 -r member-list | -a member-list } ] mailalias

       admalias -o delete [ -y ] mailalias ...

       admalias -o list [ -qv ] [ -y ] [ mailalias ...  ]

DESCRIPTION
       admalias manages the mail alias information in the aliases database
       file.  The aliases(4) file contains an alias name that is associated
       with a list of one or more mail addresses.  The alias name may be
       substituted for the mail addresses when sending mail using mailx(1)
       or sendmail(1M).

       admalias is normally run by the system administrator on the NIS
       master machine if the system is running NIS, or on any host if the
       system is not running NIS.

   Operations
       add       Add a new alias to the aliases file.  If the mailalias
                 specified already exists, the operation will not be
                 successful.

       modify    Modify currently existing information in the local or NIS
                 aliases database.

       delete    Delete the specified alias(es) from the aliases database.

       list      List the aliases in the aliases database who match the
                 specified command-line options.  If no command-line options
                 are given, then the aliases from the local database will be
                 listed.  Any user may execute this operation.

   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.  This option
                 is valid only when 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).

       -n new-mailalias
                 Specifies a string of printable characters that is the new
                 alias name for the mailalias.  It may not contain a colon
                 (:) and must be a unique alias name.

       -m member-list
                 Specifies the mail addressees who are to be members of the
                 mailalias.  This list must be a quoted space or comma-
                 separated list of valid mail addresses (see example).

       -a member-list
                 Specifies the mail addressees who are to be added to the
                 list of members associated with the mailalias.  This list
                 must be a quoted space or comma-separated list of valid
                 mail addresses (see example).

       -r member-list
                 Specifies the mail addressees who are to be removed from
                 the list of members associated with the mailalias.  This
                 list must be a quoted space or comma-separated list of
                 addresses (see example).  The list must be addressees who
                 exist as members of the mailalias.

       -q        Quiet.  The headers are not printed when listing mailalias
                 information.

       -v        Verbose.  The headers are printed when listing alias
                 information.  This option is enabled by default.

OUTPUT
       The list operation produces a two-column output.  The first column
       contains the mailalias and the second column contains the alias
       member-list.

EXAMPLES
           admalias -o add -m "root@beast root@jester root@viper" sysadmin
           admalias -o modify -a smith,root@parkplace sysadmin


DIAGNOSTICS
   Warnings
        -     The delete operation is requested and the mailalias to delete
              is not in the aliases database.

   Errors
        -     The add operation is requested and mailalias already exists.

        -     The modify operation is requested and mailalias to modify does
              not exist.

        -     The modify operation is requested and new-mailalias already
              exists as an alias in the database.

   Exit Codes
       This section lists the possible exit codes and what they mean.

        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.

FILES
       /etc/aliases
                 Local aliases database file.

SEE ALSO
       domainname(1), mailx(1), sendmail(1M), sysadm(1M), aliases(4),
       capdefaults(5).

NOTES
       You must have write permission to the aliases database to use the
       add, delete, and modify operations.  Usually, only a user with
       appropriate privilege has such permission.  On a generic DG/UX
       system, appropriate privilege is granted by having an effective UID
       of 0 (root).  See the appropriateprivilege(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 the capdefaults(5) man
       page for the default capabilities for this command.


Licensed material--property of copyright holder(s)