addusers(8) CLIX addusers(8)
NAME
addusers - Adds new user accounts
SYNOPSIS
addusers [-q] [username[,username] ... ]
FLAGS
-q Causes addusers to prompt for information about the new users to be
added.
DESCRIPTION
The addusers command is a system administration utility that creates new
user accounts. If invoked with no specified usernames, addusers defaults
to query mode, (as if the -q flag had been used) and prompts for the
usernames. If addusers is invoked with a list of usernames on the command
line, the default mode is no query (that is, addusers does not prompt for
information).
In query mode, addusers prompts for group name, user information, a parent
directory for the user's home directory, and the login shell. If the
group name is that of a new group, addusers prompts for a group ID, and
adds it to the /etc/group file. The addusers utility assumes the
following defaults:
Group name: users
Group ID: 500
User info: new user
Login Parent directory: /usr
Login shell: /bin/ksh
The addusers utility checks if the user account already exists, the user's
home directory exists, the username given is valid, and that the group is
valid before a user account is added.
The addusers utility performs several actions after the checks are made.
The user information is appended to the /etc/passwd file. The user ID is
set to one higher than the greatest user ID already in the /etc/passwd
file. The passwd field is set to ``,.'' (comma dot) which forces the user
to choose a password at the time of the first login. The user's home
directory is also created. The correct permissions are set for the user's
home directory, and a .profile file is copied from the /etc/stdprofile
file. The stdenv and stdexrc files are also copied from /etc to the
user's home directory as .env and .exrc. Note that the same group, home
2/94 - Intergraph Corporation 1
addusers(8) CLIX addusers(8)
directory, user information, and login shell are used for all of the users
named on the command line or in the prompt.
EXAMPLES
1. This example adds the user doe with the defaults for the group name,
group ID, user information, login parent directory, and login shell.
addusers doe
2. This example adds the user doe by prompting for all the information
instead of creating the user account with only the defaults.
addusers -q doe
3. This example prompts for usernames as well as all of the information.
addusers
FILES
/etc/passwd System password file.
/etc/group File that contains the names of groups and associated
group numbers.
/etc/stdprofile Standard user profile file.
/etc/stdexrc Standard user editor startup file.
/etc/stdenv Standard user environment file.
NOTES
The addusers utility contains support for the Network Information Services
(NIS) utilities.
The user must be in superuser mode to use this command.
DIAGNOSTICS
A user will not be added and addusers will abort if any of the following
occur: the username is invalid (greater than eight characters or begins
with a slash (/)), the user already exists, or the user's login directory
already exists. The addusers command will abort for the first user for
which an error is detected, and the subsequent users will not be added.
EXIT VALUES
2 Intergraph Corporation - 2/94
addusers(8) CLIX addusers(8)
The following are exit values if any errors occur while using addusers.
0 Successful execution of the command.
1 Could not determine user ID.
2 User ID was not 0 (superuser).
3 No write permission for the /etc/passwd file.
4 Invalid username.
5 Username already exists.
6 Could not create user's login directory.
7 User's login directory already exists.
8 The group ID number given for a new group is already being used by an
existing group.
9 The /etc/passwd file could not be rearranged for NIS.
RELATED INFORMATION
Commands: rmusers(8), sysadm(8)
Files: passwd(4)
2/94 - Intergraph Corporation 3