passwd(1)                        DG/UX R4.11                       passwd(1)


NAME
       passwd - change user password

SYNOPSIS
       Without DG/UX information security:
              passwd [ -a num ] [ username ]

       With DG/UX information security:
              passwd [ -a num ] [ -q | -s setname ] [ username ]

   where:
       num      An integer in the range 0 to 9
       setname  The name of a password set, such as local, su, or remote
       username The login name of a user

DESCRIPTION
       This command changes (or installs) a password associated with a
       username (your own by default).

       Passwd prompts for the old password and then for the new one.  You
       must supply both, and the new password must be typed twice to
       forestall mistakes (or once if using an automatically generated
       password, described below).

       Passwd assumes that users want to change the password with which they
       entered the system.  For example, if user fred uses the login service
       to create a session, uses su to become wilma, and enters passwd fred
       or simply passwd, passwd expects to change fred's password associated
       with login.  If fred logs in, uses su to become wilma, and enters
       passwd wilma, passwd returns an error.

   Security Features
       The nonprivileged user is required to select from a list of
       automatically generated passwords.  The default number of passwords
       provided is 5.  The -a option provides flexibility in this number of
       passwords, with a minimum of 1 and maximum of 9.  If you enter passwd
       -a3, you will be given 3 passwords from which to choose.  After
       selecting a choice, the user is required to retype the new password
       he selects.

       You can use the -s option to specify a password set (setname) you
       want to change.  If you enter passwd -ssetname or passwd -ssetname
       username, you will only be prompted to change the particular password
       set you specified with setname.  The password sets typically
       available are public, local, su, and remote, although not every user
       will have these password sets and there may be other password sets
       present.

       You can also use the -q option to have passwd prompt you with a list
       of possible password sets to change.  The -q option also displays
       whether any of the password sets are expired.  The -q and -s options
       are mutually exclusive.

   Password Requirements
       The new password is checked to ensure that it meets construction
       requirements.  When the new password is entered a second time, the
       two copies of the new password are compared.  If the two copies do
       not match, then the cycle of prompting for the new password is
       repeated (at most) two more times.

       Passwords that are not automatically generated must meet the
       following requirements:

       1)     Each password must have at least six characters.  Only the
              first eight characters are significant.

       2)     Each password must contain at least two alphabetic characters
              and at least one numeric or special character.  In this case,
              "alphabetic" means upper and lowercase letters.

       3)     Each password must differ from the username and from any
              reverse or circular shift of that name.  For comparison
              purposes, an uppercase letter and its corresponding lowercase
              letter are equivalent.

       4)     New passwords must differ from the old by at least three
              characters.  For comparison purposes, an uppercase letter and
              its corresponding lowercase letter are equivalent.

   Options
       -a     Select the number of automatically generated passwords.

       -q     Display a list of all password sets for the user, including an
              indication of any password set that is expired; then prompt
              for the password attribute set to change.

       -s     Change the password in the specified password attribute set.

EXAMPLES
       The following example is on a traditional DG/UX system:

       % passwd <NL>
       UX:passwd: INFO: Changing password for jdoe
       Old password: <NL>
       New password: <NL>
       Re-enter new password: <NL>
       %

       The following example is on a system with DG/UX information security:

       % passwd <NL>
       UX:passwd: INFO: Changing password for jdoe
       Old password: <NL>
       1)  lecelre7
       2)  2shaty4v
       3)  ajfiy5li
       4)  do8ikwys
       5)  6simwyky
       Select number: 3 <NL>
       Re-enter new password: <NL>
       %

       The following example is for the system administrator on a system
       with DG/UX information security:

       # passwd -q -a9 joel <NL>
       joel has the following password sets
                                    public  (expired)
                                    local   (frozen for 6 days)
                                    su      (frozen for 5 days)
                                    remote  (expired)

       Which one do you wish to change?  local <NL>
       1)  lecelre7
       2)  2shaty4v
       3)  ajfiy5li
       4)  do8ikwys
       5)  6simwyky
       6)  d7ik5y72
       7)  ofkurty4
       8)  duvo4veb
       9)  fehareba
       Select number: 7 <NL>
       Re-enter new password: <NL>
       #

FILES
       /etc/passwd

SEE ALSO
       login(1), yppasswd(1) crypt(3C), passwd(4).
       Robert Morris and Ken Thompson, UNIX Password Security.

NOTES
       Passwd will not change your password if it is stored by the Network
       Information Service (NIS).  Refer to yppasswd(1) for more
       information.


Licensed material--property of copyright holder(s)