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


NAME
       admshadow - manage the shadow password feature.

SYNOPSIS
       admshadow -o enable

       admshadow -o disable

       admshadow -o check [ -q ]

DESCRIPTION
       The admshadow command is used to enable, disable or check the shadow
       password feature.   When the shadow password feature is enabled, the
       standard /etc/passwd file will be split into 2 files: a new
       /etc/passwd file which does not include encrypted passwords or aging
       information, and an /etc/shadow file which includes the encrypted
       passwords and aging fields.  The permissions on the new /etc/passwd
       file will continue to allow all users to read the file.  The
       /etc/shadow file will have permissions which allow only privileged
       users to read and write the file.

   Operations
       enable    This operation will enable the shadow password feature.
                 The standard /etc/passwd file will be split into a new
                 /etc/passwd file and an /etc/shadow file which will include
                 the encrypted passwords.

       disable   This operation will disable the shadow password feature.
                 The /etc/passwd and /etc/shadow files will be merged back
                 into a standard /etc/passwd file.

       check     This operation will check if the shadow password feature is
                 enabled or disabled.   The message "enabled" or "disabled"
                 will be printed to stdout and an exit code of 0 or 11 will
                 be returned.

   Options
       -q        Quiet mode.  Do not print the "enabled" or "disabled"
                 message for the -o check option.

EXAMPLES
       In the following examples, the system administrator performs the
       following actions:  enable the shadow password feature; disable the
       shadow password feature; check if the shadow password feature is
       enabled or disabled.

           admshadow -o enable
           admshadow -o disable
           admshadow -o check


DIAGNOSTICS
   Errors
        -     The enable, operation was unable to create the /etc/passwd and
              /etc/shadow files.

        -     The disable, operation was unable to merge the /etc/passwd and
              /etc/shadow files.


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

        0     The operation was successful or the shadow password feature is
              enabled (for the -o check operation).

        1     The operation was unsuccessful.

        2     The operation failed due to access restrictions.

        3     The operation failed due to an error in the command line.

        11    The shadow password feature is disabled (for the -o check
              operation).

FILES
       /etc/passwd         The local password database file.

       /etc/shadow         The local shadow password database file.

NOTES
       You must have appropriate privilege to perform the enable and disable
       operations.  On a generic DG/UX system, appropriate privilege is
       granted by having an effective UID of 0 (root).

       The shadow password feature is not intended to run on a system with
       DG/UX information security.  The admshadow enable operation will not
       be available on these systems.


SEE ALSO
       admuser(1), login(1), passwd(1), yppasswd(1), passmgmt(1M),
       passwd(4), shadow(4),


Licensed material--property of copyright holder(s)