adduser(1M) adduser(1M)NAME adduser - adds a user account SYNOPSIS adduser [-a address] [-c] [-d dir] [-g group] [-h home] [-i] [-p home-phone] [-r real-name] [-s shell] [-u lowest] [-U uid] [-x extension] [login-name]... ARGUMENTS -a address Specifies an office address, such as a mail stop or building number. -c Causes adduser to use the common (global) system folder. If you omit this option, adduser creates a personal system folder for each user account. -d dir Specifies the full pathname to the parent directory of the newly created home directory. If you omit this option, new home directories are created at this location: /users Use this option to create the home directory in a parent directory other than /users. The name of the new home directory is that of the new account, login-name. You cannot use this option with the -h option. -g group Specifies the initial login group with which to affiliate each user account. If you omit this option, adduser creates a unique group for each account. The group name created is of the form gpgid where gid is the next available numeric group ID. -h home Specifies the full pathname of the desired home directory. You cannot create a home directory name other than login-name when you use this option. You cannot use this option with the -d option. -i Initiates an interactive mode, which is usually entered only if login-name is omitted. This option forces adduser to prompt for a real name, address, extension, home phone, group, shell, or home directory, which was not supplied within the command line. login-name Specifies the name of the account which you must supply January 1992 1
adduser(1M) adduser(1M)each time you log in to the system using the new account. -p home-phone Specifies a home telephone number, such as 408-555-1212. If you want to put parentheses around the area code, you must enclose the entire argument in quotation marks: -p "(408) 555-1212" -r real-name Specifies the real name of the user account. For example, you could specify -r "Fred Smith" To preserve embedded spaces, such as the space between Fred and Smith, you must supply quotation marks around the argument value. -s shell Specifies the full pathname of an executable program to use as the shell for each account added. If you omit this option, the default is /bin/csh. Common values you can specify for the shell program are /bin/ksh, and /bin/sh, as well as /bin/csh. -u lowest Specifies the desired lower bound for determining a numeric user ID. If you omit this option, adduser uses the first available user ID equal to or greater than 200. You can establish the lowest user ID only by using this option within the command line. You are not prompted for this value in interactive mode. You cannot use this option with the -U option. -U uid Specifies the account user ID. A user ID of zero creates an account with root privileges. The highest user ID that can be assigned is 60,000. This limit is established in /usr/include/limits.h. You can establish the user ID for an account only by using this option within the command line. You are not prompted for this value in interactive mode. You cannot use this option with the -u option. -x extension Specifies an office telephone number. If you want to include parentheses or spaces, you must place quotation marks around the extension. 2 January 1992
adduser(1M) adduser(1M)DESCRIPTION adduser creates an account for each login name you specify. The script creates for each account an entry in the password file, an entry in the group password file if necessary, a home directory with the accompanying shell startup files, and a personal system folder. If you specify more than one login name on a single command line, the specified options apply to all the accounts created. If you provide no login names, adduser enters the interactive mode, and prompts for all values not given on the command line. The adduser command uses the information given, or appropriate default values, to generate an entry suitable for inclusion in /etc/passwd. If appropriate, an entry is also generated for /etc/group. For each account created, a brief report is written to the standard output. In the interactive mode, a confirmation is requested before the final changes to /etc/passwd are made. A new home directory is created, if necessary, and copies of various startup files (.cshrc, .kshrc, .login, .logout, and .profile) are placed there. The source of these copied files are files that reside in /usr/lib/skel. Directory and file permissions are set as follows: The owner has read, write, and execute permission; the group has read and execute permission. The information used to create each account is stored in a README file in each new home directory. The adduser command does not permit new users to be added to the local system when it receives its password file from a Network Information Service (NIS) server, unless the account is already in the NIS password database. If it is, the account can be added locally, but the login name, group ID, and password fields are those given by the NIS database rather than those specified in the adduser command line. In the interactive mode, adduser prompts for a password for each new account. In the batch mode, the password field is set to the following string which causes a password to be set when the account is first used. ,.. FILES $HOME/README File that reports the information used to set up the account /etc/gtmp Temporary group file /etc/ogroup January 1992 3
adduser(1M) adduser(1M)Old group file /etc/opasswd Old password file /etc/ptmp Temporary password file /usr/lib/skel/* Standard startup files SEE ALSO vipw(1M) csh(1), ksh(1), sh(1) in A/UX Command Reference A/UX Network System Administration 4 January 1992