MKUSER(C)                XENIX System V                 MKUSER(C)



     Name
          mkuser - Adds a login ID to the system.

     Syntax
          /etc/mkuser

     Description
          mkuser is used to add more user login IDs to the system. It
          is the preferred method for adding new users to the system,
          since it handles all directory creation and password file
          update.  To add a new user to the system, mkuser requires
          five pieces of information: the login name, the initial
          password, the group identification, the user's login shell
          and an optional comment string for the password file.  It
          also allows the new user to be assigned to a group if
          required, although in most cases a default group is
          suitable.  The program prompts for these five items and
          validates the given data. The login name is checked against
          certain criteria (i.e., it must be at least three characters
          and begin with a lowercase letter).  The password must
          follow standard XENIX conventions, see passwd(C).  The
          password file comment field can be up to 35 characters of
          information.

          mkuser takes some of its parameters from a default file,
          /etc/default/mkuser . Currently, one may set the root path
          of home directories.  An example default file is:

               HOME=/usr
               HOMEMODE=0755
               PROFMODE=0640

          Where HOME entry is the user's home directory, the HOMEMODE
          entry is the permissions for the user's home directory, and
          the PROFMODE entry is the permissions for the .login,
          .profile and .cshrc files.

          This file can be edited (by the super-user) to change this
          default. There are five other files in the directory
          /usr/lib which may also be altered to suit local options.
          They are mkuser.help which is the introductory explanation
          given by mkuser on startup, mkuser.mail which is the initial
          mail message sent to new users, mkuser.prof, the standard
          .profile file given to new sh and rsh shell users,
          mkuser.login, the standard .login file given to new csh
          users, and mkuser.cshrc, the standard .cshrc file given to
          new csh users.

          mkuser prompts for the shell type to assign to the new user.
          The shell types available are standard (Bourne) sh (option
          1), visual shell vsh (option 2), c-shell csh (option 3),
          restricted rsh (option 4), and uucp login (option 5).



     Page 1                                           (printed 8/7/87)

     MKUSER(C)                XENIX System V                 MKUSER(C)



          mkuser allocates user IDs starting at 200, or the largest
          number used in the password file. The default group ID for
          new users is 50. The minimum group ID allowed for user
          accounts is 50.  The program prompts the operator for an
          optional group specification.  This can either be a numeric
          group ID, or a group name. If the group exists, the user is
          added to it. If it does not exist, a new entry in /etc/group
          is created. A new group cannot have a numeric ID less than
          51. If a new group is to be created, and the operator only
          specifies the group name, a free group ID is assigned.
          Alternatively, the operator can specify the group ID too.

          mkuser can only be executed by the super-user.

          The minimum length of a legal password, and the minimum and
          maximum number of weeks used in password aging are specified
          in /etc/default/passwd by the variables PASSLENGTH, MINWEEKS
          and MAXWEEKS.  For example, these variables might be set as
          follows:

               PASSLENGTH=6
               MINWEEKS=2
               MAXWEEKS=6

     Files
          /etc/passwd

          /usr/spool/mail/username

          /etc/default/mkuser

          /etc/default/passwd

          /usr/lib/mkuser/mkuser.cshrc

          /usr/lib/mkuser/mkuser.help

          /usr/lib/mkuser/mkuser.login

          /usr/lib/mkuser/mkuser.prof

          /usr/lib/mkuser/mkuser.mail

     See Also
          chmod(C), group(M), passwd(C), pwadmin(C), rmuser(C)










     Page 2                                           (printed 8/7/87)