Home
Main website
Display Sidebar
Hide Ads
Recent Changes
View Source:
adduser(8)
Edit
PageHistory
Diff
Info
LikePages
ADDUSER !!!ADDUSER NAME SYNOPSIS DESCRIPTION OPTIONS FILES SEE ALSO COPYRIGHT ---- !!NAME adduser, addgroup - add a user or group to the system !!SYNOPSIS __adduser__ [[options] [[--home DIR] [[--shell SHELL] [[--no-create-home] [[--uid ID] [[--firstuid ID] [[--lastuid ID] [[--ingroup GROUP | --gid ID] [[--disabled-password] [[--disabled-login] [[--gecos GECOS] user __adduser__ --system [[options] [[--home DIR] [[--shell SHELL] [[--no-create-home] [[--uid ID] [[--group | --ingroup GROUP | --gid ID] [[--disabled-password] [[--disabled-login] [[--gecos GECOS] user __adduser__ --group [[options] [[--gid ID] group__ addgroup__ [[options] [[--gid ID] group __adduser__ [[options] user group __COMMON OPTIONS__ [[--quiet] [[--force-badname] [[--help] [[--version] [[--conf FILE] !!DESCRIPTION __adduser__ and __addgroup__ add users and groups to the system according to command line options and configuration information in ''/etc/adduser.conf''. They are friendlier front ends to the __useradd__ and __groupadd__ programs, choosing Debian policy conformant UID and GID values, creating a home directory with skeletal configuration, running a custom script, and other features. __adduser__ and __addgroup__ can be run in one of four modes: __Add a normal user__ If called with one non-option argument and without the __--system__ or __--group__ options, __adduser__ will add a normal user. __adduser__ will choose the first available UID from the range specified for normal users in the configuration file. The UID can be overridden with the __--uid__ option. The range specified in the configuration file may be overridden with the __--firstuid__ and __--lastuid__ options. By default, each user in Debian GNU/Linux is given a corresponding group with the same name and id. Usergroups allow group writable directories to be easily maintained by placing the appropriate users in the new group, setting the set-group-ID bit in the directory, and ensuring that all users use a umask of 002. If this option is turned off by setting __USERGROUPS__ to ''no'', all users' GIDs are set to __USERS_GID__. Users' groups can also be overridden from the command line with the __--gid__ or __--ingroup__ options to set the group by id or name, respectively. __adduser__ will create a home directory subject to __DHOME__, __GROUPHOMES__, and __LETTERHOMES__. The home directory can be overridden from the command line with the __--home__ option, and the shell with the __--shell__ option. The home directory's set-group-ID bit is set if __USERGROUPS__ is ''yes'' so that any files created in the user's home directory will have the correct group. __adduser__ will copy files from __SKEL__ into the home directory and prompt for finger (gecos) information and a password. The gecos may also be set with the __--gecos__ option. With the __--disabled-login__ option, the account will be created but will be disabled until a password is set. The __--disabled-password__ option will not set a password, but login are still possible for example through SSH RSA keys. If the file __/usr/local/sbin/adduser.local__ exists, it will be executed after the user account has been set up in order to do any local setup. The arguments passed to __adduser.local__ are: username uid gid home-directory __Add a system user__ If called with one non-option argument and the __--system__ option, __adduser__ will add a system user. If an user with an uid in the system range (or if the uid is specified, with that) does already exist, adduser will exit silently. __adduser__ will choose the first available UID from the range specified for system users in the configuration file. The UID can be overridden with the __--uid__ option. By default, system users are placed in the __nogroup__ group. To place the new system user in an already existing group, use the __--gid__ or __--ingroup__ options. To place the new system user in a new group with the same ID, use the __--group__ option. A home directory is created by the same rules as for normal users. The new system user will have the shell ''/bin/false'' (unless overridden with the __--shell__ option), and have a disabled password. Skeletal configuration files are not copied. __Add a system group__ If __adduser__ is called with the __--group__ option, or __addgroup__ is called, a system group will be added. A GID will be chosen from the range specified for system UIDS in the configuration file. The GID can be overridden with the __--gid__ option. The group is created with no users. __Add an existing user to an existing group__ If called with two non-option arguments, __adduser__ will add an existing user to an existing group. !!OPTIONS __--conf FILE__ Use FILE instead of ''/etc/adduser.conf''. __--disabled-login__ Do not run passwd to set the password. The user won't be able to use her account until the password is set. __--disabled-password__ Like --disabled-login, but logins are still possible for example through SSH RSA keys, but not using password authentification. __--force-badname__ By default, user and group names are required to consist of a lowercase letter followed by zero or more lowercase letters or numbers. Dashes in the username are accepted as well. This option forces __adduser__ and __addgroup__ to be more lenient. __--gecos GECOS__ Set the gecos field for the new entry generated. adduser will not ask for finger information if this option is given. __--gid ID__ When creating a group, this option forces the new groupid to be the given number. When creating a user, this option will put the user in that group. __--group__ When combined with __--system__, a group with the same name and ID as the system user is created. If not combined with __--system__, a group with the given name is created. This is the default action if the program is invoked as __addgroup__. __--help__ Display brief instructions. __--home DIR__ Use DIR as the user's home directory, rather than the default specified by the configuration file. If the directory does not exist, it is created and skeleton files are copied. __--shell SHELL__ Use SHELL as the user's login shell, rather than the default specified by the configuration file. __--ingroup GROUP__ Add the new user to GROUP instead of a usergroup or the default group defined by USERS_GID in the adduser.conf file. __--no-create-home__ Do not create the home directory, even if it doesn't exist. __--quiet__ Suppress progress messages. __--system__ Create a system user. __--uid ID__ Force the new userid to be the given number. adduser will fail if the userid is already taken. __--firstuid ID__ Override the first uid in the range that the uid is chosen from. __--lastuid ID__ Override the last uid in the range that the uid is chosen from. __--version__ Display version and copyright information. !!FILES /etc/adduser.conf !!SEE ALSO adduser.conf(5), deluser(8), useradd(8), groupadd(8) !!COPYRIGHT Copyright (C) 1997, 1998, 1999 Guy Maor. Copyright (C) 1995 Ted Hajek, with a great deal borrowed from the original Debian __adduser__ Copyright (C) 1994 Ian Murdock. __adduser__ is free software; see the GNU General Public Licence version 2 or later for copying conditions. There is ''no'' warranty. ----
5 pages link to
adduser(8)
:
Gecos
Man8a
adduser.conf(5)
delgroup(8)
deluser(8)
This page is a man page (or other imported legacy content). We are unable to automatically determine the license status of this page.
