passmgmt

 

---

 
 
 
 Maintenance Commands                                 passmgmt(1M)
 
 
 


NAME
      passmgmt - password files management
 


SYNOPSIS
      passmgmt -a options  name
 
      passmgmt -m options  name
 
      passmgmt -d name
 


DESCRIPTION
      The passmgmt command updates  information  in  the  password
      files.   This   command  works  with  both  /etc/passwd  and
      /etc/shadow.
 
      passmgmt -a adds an entry for  user  name  to  the  password
      files.  This  command  does not create any directory for the
      new user and the new login remains locked (with  the  string
      *LK*  in the password field) until the  passwd(1) command is
      executed to set the password.
 
      passmgmt -m modifies the  entry for user name in  the  pass-
      word  files. The name field in the /etc/shadow entry and all
      the fields (except the password field)  in  the  /etc/passwd"
      entry   can be modified by this command. Only fields entered
      on the command line will be modified.
 
      passmgmt -d  deletes the entry for user name from the  pass-
      word  files. It will not remove any files that the user owns
      on the system; they must be removed manually.
 
      passmgmt can be used only by the super-user.
 


OPTIONS
      -c comment
            A short description of the login, enclosed in  quotes.
            It  is  limited  to  a  maximum  of 128 characters and
            defaults to an empty field.
 
      -h homedir
            Home directory of name. It is limited to a maximum  of
            256 characters and defaults to  /usr/name.
 
      -u uid
            UID of the name. This number must range from 0 to  the
            maximum non-negative value for the system. It defaults
            to the next available  UID greater  than  99.  Without
            the -o option, it enforces the uniqueness of a  UID.
 
      -o    This option allows a  UID to be non-unique. It is used
            only with the -u option.
 
 
 
 
 SunOS 5.8            Last change: 7 Apr 1997                    1
 
 
 
 
 
 
 Maintenance Commands                                 passmgmt(1M)
 
 
 
      -g gid
            GID of name. This number must range  from  0  to   the
            maximum non-negative value for the system. The default
            is 1.
 
      -s shell
            Login shell for name. It should be the  full  pathname
            of  the   program that will be executed when the  user
            logs in. The maximum size of shell is 256  characters.
            The  default  is  for this field to be empty and to be
            interpreted as /usr/bin/sh.
 
      -l logname
            This option changes the name to logname.  It  is  used
            only  with the -m option. The total size of each login
            entry is limited to a maximum of 511 bytes in each  of
            the password files.
 


FILES
      /etc/passwd"
      /etc/shadow"
      /etc/opasswd
      /etc/oshadow
 


ATTRIBUTES
      See attributes(5) for descriptions of the  following  attri-
      butes:
 
      ____________________________________________________________
     |       ATTRIBUTE TYPE        |       ATTRIBUTE VALUE       |
     |_____________________________|_____________________________|
     | Availability                | SUNWcsu                     |
     |_____________________________|_____________________________|
 
 


SEE ALSO
      passwd(1), useradd(1M), userdel(1M), usermod(1M), passwd(4),
      shadow( 4), attributes(5)
 
 EXIT STATUS
      The  passmgmt  command  exits  with  one  of  the  following
      values:
 
      0     Success.
 
      1     Permission denied.
 
      2     Invalid command syntax.  Usage message of the passmgmt
            command is  displayed.
 
      3     Invalid argument provided to option.
 
 
 
 
 SunOS 5.8            Last change: 7 Apr 1997                    2
 
 
 
 
 
 
 Maintenance Commands                                 passmgmt(1M)
 
 
 
      4     UID in use.
 
      5     Inconsistent password files (for example, name  is  in
            the /etc/passwd file and  not in the /etc/shadow file,
            or vice versa).
 
      6     Unexpected failure.  Password files unchanged.
 
      7     Unexpected failure.  Password file(s) missing.
 
      8     Password file(s) busy.  Try again later.
 
      9     name does not exist   (if  -m  or  -d  is  specified),
            already  exists   (if  -a  is  specified),  or logname
            already exists  (if -m -l  is specified).
 


NOTES
      Do not use a colon  (:) or  RETURN as part of  an  argument.
      It is interpreted as a field separator in the password file.
      The  passmgmt command will be removed in a  future  release.
      Its functionality has been replaced and enhanced by useradd,
      userdel, and usermod. These commands  are  currently  avail-
      able.
 
      This command only modifies password definitions in the local
      /etc/passwd  and /etc/shadow files. If a network nameservice
      such as NIS or NIS+ is being used to  supplement  the  local
      files with additional entries, passmgmt cannot change infor-
      mation supplied by the network nameservice.
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 SunOS 5.8            Last change: 7 Apr 1997                    3
 
 
 

---