ADDUSER, USERS(8,C) AIX Commands Reference ADDUSER, USERS(8,C)
-------------------------------------------------------------------------------
adduser, users
PURPOSE
Adds, deletes and changes user and group information.
SYNTAX
+- /usr/adm/user.cfile -+
/etc/adduser ---| |---|
/etc/users +----- configfile ------+
Note: This command does not have MBCS support.
DESCRIPTION
The adduser command lets you add, change, or delete user and group information
in the /etc/passwd and /etc/group files. To use the adduser command, you must
be a member of the system group or have superuser authority (see "su").
The adduser command does all of its work in temporary files. When you enter
the quit subcommand, the temporary files become the permanent files. The old
versions of /etc/passwd and /etc/group are renamed /etc/opasswd and
/etc/ogroup. If adduser is ended by an INTERRUPT (Ctrl-C), it removes the
temporary files, and the system files remain as they were before the session.
However any directories created still exist, so it may be necessary to remove
directories after sending an INTERRUPT.
For configuration, adduser uses the file /usr/adm/user.cfile, the file
specified with configfile, or the default parameters that follow:
+-----------------------------------------------------------------------------+
|Figure 1 (Page 1 of 2). Configuration File Parameters |
+--------+--------------+-----------------------------------------------------+
|Paramete| Default | Description |
| | Value | |
+--------+--------------+-----------------------------------------------------+
|udir | /u/ | Prefix of user home directory names. |
+--------+--------------+-----------------------------------------------------+
|program | null | The name of the user login program. |
+--------+--------------+-----------------------------------------------------+
|minage | null | Minimum number of weeks that a password must be in |
| | | effect before the password can be changed. |
+--------+--------------+-----------------------------------------------------+
|maxage | null | Maximum number of weeks that a password can be in |
| | | effect before the password must changed. |
+--------+--------------+-----------------------------------------------------+
Processed November 8, 1990 ADDUSER, USERS(8,C) 1
ADDUSER, USERS(8,C) AIX Commands Reference ADDUSER, USERS(8,C)
+-----------------------------------------------------------------------------+
|Figure 1 (Page 2 of 2). Configuration File Parameters |
+--------+--------------+-----------------------------------------------------+
|Paramete| Default | Description |
| | Value | |
+--------+--------------+-----------------------------------------------------+
|siteinfo| null | Any site-specific information. |
+--------+--------------+-----------------------------------------------------+
|filesize| null | Size, in blocks, of the largest file that a user |
| | | can make. |
+--------+--------------+-----------------------------------------------------+
|gname | staff | Name of the group that a user is initially |
| | | assigned. |
+--------+--------------+-----------------------------------------------------+
|minid | 200 | Minimum number that can be assigned as a user or |
| | | group ID. |
+--------+--------------+-----------------------------------------------------+
|maxid | 60000 | Maximum number that can be assigned as a user or |
| | | group ID. |
+--------+--------------+-----------------------------------------------------+
|pfile | /etc/passwd | Name of the password file. |
+--------+--------------+-----------------------------------------------------+
|sitegrou| null | In a TCF cluster, the sites which a user may logon |
| | | to. |
+--------+--------------+-----------------------------------------------------+
|gfile | /etc/group | Name of the group file. |
+--------+--------------+-----------------------------------------------------+
|owner | bin | Name of the owner of password and group files. |
+--------+--------------+-----------------------------------------------------+
|invalid | /usr/lib/sorr| Program for invalid accounts. |
+--------+--------------+-----------------------------------------------------+
For information on how to use the adduser command, see Managing the AIX
Operating System.
Notes:
1. Each group has a limit of 500 users with 8 character IDs. Shorter IDs may
allow more users per group.
2. It is possible to delete a user who still owns files or to delete a group
that still has members. However if you do this, it may cause problems
later if the user name or group name is reused.
3. The /etc/users command is equivalent to /etc/adduser, and is included for
compatibility with other UNIX systems. This is a separate command from
/usr/ucb/users.
4. User names must be in 7-bit ASCII characters.
5. The unit of file size limit is 512-byte blocks.
Processed November 8, 1990 ADDUSER, USERS(8,C) 2
ADDUSER, USERS(8,C) AIX Commands Reference ADDUSER, USERS(8,C)
PARAMETERS
add Adds a new user or group.
change Changes data for an existing user or group.
delete Deletes an existing user or group.
help Displays a summary of available commands. Entering a question
mark (?) also works for help.
invalidate Changes a user's shell to a do-nothing program.
quit Updates files and exit.
show Shows information about a user or group.
The initial letter of each subcommand is recognized as the subcommand name.
EXAMPLES
The following is a sample /usr/adm/user.cfile:
pfile /etc/passwd
gfile /etc/group
owner root
minid 200
maxid 1000
udir /u/
program /bin/sh
gname staff
invalid /usr/lib/sorry
FILES
/usr/adm/user.cfile Default configuration file.
/usr/adm/newuser.sys Initialization shell file for added users.
/usr/adm/newuser.usr Initialization shell file for added users.
/etc/passwd Password file that identifies all known users.
/etc/group Group file that identifies all known groups.
/etc/opasswd Saved previous version of the password file.
/etc/ogroup Saved previous version of the group file.
RELATED INFORMATION
See the group and passwd files in AIX Operating System Technical Reference.
See the discussions of users, newuser.sys, and newuser.usr in Managing the AIX
Operating System.
Processed November 8, 1990 ADDUSER, USERS(8,C) 3