summaryrefslogtreecommitdiff
path: root/man/fr/man8/useradd.8
diff options
context:
space:
mode:
Diffstat (limited to 'man/fr/man8/useradd.8')
-rw-r--r--man/fr/man8/useradd.8326
1 files changed, 59 insertions, 267 deletions
diff --git a/man/fr/man8/useradd.8 b/man/fr/man8/useradd.8
index e95200e8..774fd3e4 100644
--- a/man/fr/man8/useradd.8
+++ b/man/fr/man8/useradd.8
@@ -1,13 +1,13 @@
'\" t
.\" Title: useradd
.\" Author: Julianne Frances Haugh
-.\" Generator: DocBook XSL Stylesheets v1.79.1 <http://docbook.sf.net/>
-.\" Date: 02/01/2022
+.\" Generator: DocBook XSL Stylesheets vsnapshot <http://docbook.sf.net/>
+.\" Date: 18/08/2022
.\" Manual: Commandes de gestion du syst\(`eme
-.\" Source: shadow-utils 4.11.1
+.\" Source: shadow-utils 4.12.2
.\" Language: French
.\"
-.TH "USERADD" "8" "02/01/2022" "shadow\-utils 4\&.11\&.1" "Commandes de gestion du syst\(`em"
+.TH "USERADD" "8" "18/08/2022" "shadow\-utils 4\&.12\&.2" "Commandes de gestion du syst\(`em"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
@@ -68,11 +68,7 @@ The default base directory for the system if
\fB\-d\fR\ \&\fIHOME_DIR\fR
is not specified\&.
\fIBASE_DIR\fR
-is concatenated with the account name to define the home directory\&. If the
-\fB\-m\fR
-option is not used,
-\fIBASE_DIR\fR
-must exist\&.
+is concatenated with the account name to define the home directory\&.
.sp
If this option is not specified,
\fBuseradd\fR
@@ -86,7 +82,7 @@ by default\&.
.PP
\fB\-c\fR, \fB\-\-comment\fR\ \&\fICOMMENT\fR
.RS 4
-Toute cha\(^ine de texte\&. C\*(Aqest g\('en\('eralement une description courte du compte, elle est actuellement utilis\('ee comme champ pour le nom complet de l\*(Aqutilisateur\&.
+Any text string\&. It is generally a short description of the account, and is currently used as the field for the user\*(Aqs full name\&.
.RE
.PP
\fB\-d\fR, \fB\-\-home\-dir\fR\ \&\fIHOME_DIR\fR
@@ -124,7 +120,8 @@ variable in
.PP
\fB\-f\fR, \fB\-\-inactive\fR\ \&\fIINACTIVE\fR
.RS 4
-Nombre de jours suivant la fin de validit\('e d\*(Aqun mot de passe apr\(`es lequel le compte est d\('efinitivement d\('esactiv\('e\&. Une valeur de 0 d\('esactive le compte d\(`es que le mot de passe a d\('epass\('e sa fin de validit\('e, et une valeur de \-1 d\('esactive cette fonctionnalit\('e\&.
+defines the number of days after the password exceeded its maximum age where the user is expected to replace this password\&. The value is stored in the shadow password file\&. An input of 0 will disable an expired password with no delay\&. An input of \-1 will blank the respective field in the shadow password file\&. See
+\fBshadow\fR(5)for more information\&.
.sp
If not specified,
\fBuseradd\fR
@@ -134,9 +131,20 @@ variable in
/etc/default/useradd, or \-1 by default\&.
.RE
.PP
+\fB\-F\fR, \fB\-\-add\-subids\-for\-system\fR
+.RS 4
+Update
+/etc/subuid
+and
+/etc/subgid
+even when creating a system account with
+\fB\-r\fR
+option\&.
+.RE
+.PP
\fB\-g\fR, \fB\-\-gid\fR\ \&\fIGROUP\fR
.RS 4
-Nom du groupe ou identifiant num\('erique du groupe de connexion initial de l\*(Aqutilisateur\&. Le nom du groupe doit exister\&. Un num\('ero de groupe doit se r\('ef\('erer \(`a un groupe d\('ej\(`a existant\&.
+The name or the number of the user\*(Aqs primary group\&. The group name must exist\&. A group number must refer to an already existing group\&.
.sp
If not specified, the behavior of
\fBuseradd\fR
@@ -198,14 +206,15 @@ defaults (\fBUID_MIN\fR,
\fBUMASK\fR,
\fBPASS_MAX_DAYS\fR
and others)\&.
-
+.sp
Example:
-\fB\-K\fR\ \&\fIPASS_MAX_DAYS\fR=\fI\-1\fR
-can be used when creating system account to turn off password aging, even though system account has no password at all\&. Multiple
+\fB\-K\fR\ \&\fIPASS_MAX_DAYS \fR=\fI\-1\fR
+can be used when creating an account to turn off password aging\&. Multiple
\fB\-K\fR
options can be specified, e\&.g\&.:
-\fB\-K\fR\ \&\fIUID_MIN\fR=\fI100\fR\ \&
-\fB\-K\fR\ \&\fIUID_MAX\fR=\fI499\fR
+\fB\-K\fR\ \&\fIUID_MIN\fR
+=\fI100\fR\ \&\fB\-K\fR\ \&
+\fIUID_MAX\fR=\fI499\fR
.RE
.PP
\fB\-l\fR, \fB\-\-no\-log\-init\fR
@@ -238,7 +247,7 @@ The directory where the user\*(Aqs home directory is created must exist and have
.PP
\fB\-M\fR, \fB\-\-no\-create\-home\fR
.RS 4
-Do no create the user\*(Aqs home directory, even if the system wide setting from
+Do not create the user\*(Aqs home directory, even if the system wide setting from
/etc/login\&.defs
(\fBCREATE_HOME\fR) is set to
\fIyes\fR\&.
@@ -265,20 +274,22 @@ variable in
.PP
\fB\-o\fR, \fB\-\-non\-unique\fR
.RS 4
-Permet de cr\('eer un compte d\*(Aqutilisateur avec un identifiant (\(Fo\ \&UID\ \&\(Fc) dupliqu\('e (non unique)\&.
+allows the creation of an account with an already existing UID\&.
.sp
This option is only valid in combination with the
\fB\-u\fR
-option\&.
+option\&. As a user identity serves as key to map between users on one hand and permissions, file ownerships and other aspects that determine the system\*(Aqs behavior on the other hand, more than one login name will access the account of the given UID\&.
.RE
.PP
\fB\-p\fR, \fB\-\-password\fR\ \&\fIPASSWORD\fR
.RS 4
-The encrypted password, as returned by
-\fBcrypt\fR(3)\&. The default is to disable the password\&.
+defines an initial password for the account\&. PASSWORD is expected to be encrypted, as returned by
+\fBcrypt \fR(3)\&. Within a shell script, this option allows to create efficiently batches of users\&.
+.sp
+Without this option, the new account will be locked and with no password defined, i\&.e\&. a single exclamation mark in the respective field of
+/etc/shadow\&. This is a state where the user won\*(Aqt be able to access the account or to define a password himself\&.
.sp
-\fBNote:\fR
-This option is not recommended because the password (or encrypted password) will be visible by users listing the processes\&.
+\fBNote:\fRAvoid this option on the command line because the password (or encrypted password) will be visible by users listing the processes\&.
.sp
Il est n\('ecessaire de v\('erifier si le mot de passe respecte la politique de mots de passe du syst\(`eme\&.
.RE
@@ -304,6 +315,13 @@ will not create a home directory for such a user, regardless of the default sett
(\fBCREATE_HOME\fR)\&. You have to specify the
\fB\-m\fR
options if you want a home directory for a system account to be created\&.
+.sp
+Note that this option will not update
+/etc/subuid
+and
+/etc/subgid\&. You have to specify the
+\fB\-F\fR
+options if you want to update the files for a system account to be created\&.
.RE
.PP
\fB\-R\fR, \fB\-\-root\fR\ \&\fICHROOT_DIR\fR
@@ -312,24 +330,22 @@ Apply changes in the
\fICHROOT_DIR\fR
directory and use the configuration files from the
\fICHROOT_DIR\fR
-directory\&.
+directory\&. Only absolute paths are supported\&.
.RE
.PP
\fB\-P\fR, \fB\-\-prefix\fR\ \&\fIPREFIX_DIR\fR
.RS 4
-Apply changes in the
-\fIPREFIX_DIR\fR
-directory and use the configuration files from the
-\fIPREFIX_DIR\fR
-directory\&. This option does not chroot and is intended for preparing a cross\-compilation target\&. Some limitations: NIS and LDAP users/groups are not verified\&. PAM authentication is using the host files\&. No SELINUX support\&.
+Apply changes to configuration files under the root filesystem found under the directory
+\fIPREFIX_DIR\fR\&. This option does not chroot and is intended for preparing a cross\-compilation target\&. Some limitations: NIS and LDAP users/groups are not verified\&. PAM authentication is using the host files\&. No SELINUX support\&.
.RE
.PP
\fB\-s\fR, \fB\-\-shell\fR\ \&\fISHELL\fR
.RS 4
-The name of the user\*(Aqs login shell\&. The default is to leave this field blank, which causes the system to select the default login shell specified by the
+sets the path to the user\*(Aqs login shell\&. Without this option, the system will use the
\fBSHELL\fR
-variable in
-/etc/default/useradd, or an empty string by default\&.
+variable specified in
+/etc/default/useradd, or, if that is as well not set, the field for the login shell in
+/etc/passwdremains empty\&.
.RE
.PP
\fB\-u\fR, \fB\-\-uid\fR\ \&\fIUID\fR
@@ -363,7 +379,9 @@ variable in
.PP
\fB\-Z\fR, \fB\-\-selinux\-user\fR\ \&\fISEUSER\fR
.RS 4
-L\*(Aqutilisateur SELinux utilis\('e pour la connexion de l\*(Aqutilisateur\&. Le comportement par d\('efaut est de laisser ce champ vide\&. Le syst\(`eme s\('electionnera alors l\*(Aqutilisateur SELinux par d\('efaut\&.
+defines the SELinux user for the new account\&. Without this option, a SELinux uses the default user\&. Note that the shadow system doesn\*(Aqt store the selinux\-user, it uses
+\fBsemanage\fR(8)
+for that\&.
.RE
.SS "Modifier les valeurs par d\('efaut"
.PP
@@ -379,7 +397,7 @@ will update the default values for the specified options\&. Valid default\-chang
.PP
\fB\-b\fR, \fB\-\-base\-dir\fR\ \&\fIBASE_DIR\fR
.RS 4
-The path prefix for a new user\*(Aqs home directory\&. The user\*(Aqs name will be affixed to the end of
+sets the path prefix for a new user\*(Aqs home directory\&. The user\*(Aqs name will be affixed to the end of
\fIBASE_DIR\fR
to form the new user\*(Aqs home directory name, if the
\fB\-d\fR
@@ -393,7 +411,7 @@ variable in
.PP
\fB\-e\fR, \fB\-\-expiredate\fR\ \&\fIEXPIRE_DATE\fR
.RS 4
-Date \(`a laquelle le compte utilisateur sera d\('esactiv\('e\&.
+sets the date on which newly created user accounts are disabled\&.
.sp
This option sets the
\fBEXPIRE\fR
@@ -403,7 +421,8 @@ variable in
.PP
\fB\-f\fR, \fB\-\-inactive\fR\ \&\fIINACTIVE\fR
.RS 4
-Nombre de jours apr\(`es la fin de validit\('e d\*(Aqun mot de passe avant que le compte ne soit d\('esactiv\('e\&.
+defines the number of days after the password exceeded its maximum age where the user is expected to replace this password\&. See
+\fBshadow\fR(5)for more information\&.
.sp
This option sets the
\fBINACTIVE\fR
@@ -413,14 +432,7 @@ variable in
.PP
\fB\-g\fR, \fB\-\-gid\fR\ \&\fIGROUP\fR
.RS 4
-The group name or ID for a new user\*(Aqs initial group (when the
-\fB\-N/\-\-no\-user\-group\fR
-is used or when the
-\fBUSERGROUPS_ENAB\fR
-variable is set to
-\fIno\fR
-in
-/etc/login\&.defs)\&. The named group must exist, and a numerical group ID must have an existing entry\&.
+sets the default primary group for newly created users, accepting group names or a numerical group ID\&. The named group must exist, and the GID must have an existing entry\&.
.sp
This option sets the
\fBGROUP\fR
@@ -430,7 +442,7 @@ variable in
.PP
\fB\-s\fR, \fB\-\-shell\fR\ \&\fISHELL\fR
.RS 4
-Le nom de l\*(Aqinterpr\('eteur de commandes du nouvel utilisateur\&.
+defines the default login shell for new users\&.
.sp
This option sets the
\fBSHELL\fR
@@ -460,226 +472,6 @@ Les noms d\*(Aqutilisateur sont limit\('es \(`a 16 caract\(`eres\&.
The following configuration variables in
/etc/login\&.defs
change the behavior of this tool:
-.PP
-\fBCREATE_HOME\fR (boolean)
-.RS 4
-Indiquer si un r\('epertoire personnel doit \(^etre cr\('e\('e par d\('efaut pour les nouveaux utilisateurs\&.
-.sp
-Ce r\('eglage ne s\*(Aqapplique pas pour les utilisateurs syst\(`eme, et peut \(^etre annul\('e sur la ligne de commande\&.
-.RE
-.PP
-\fBGID_MAX\fR (number), \fBGID_MIN\fR (number)
-.RS 4
-Range of group IDs used for the creation of regular groups by
-\fBuseradd\fR,
-\fBgroupadd\fR, or
-\fBnewusers\fR\&.
-.sp
-The default value for
-\fBGID_MIN\fR
-(resp\&.
-\fBGID_MAX\fR) is 1000 (resp\&. 60000)\&.
-.RE
-.PP
-\fBHOME_MODE\fR (number)
-.RS 4
-The mode for new home directories\&. If not specified, the
-\fBUMASK\fR
-is used to create the mode\&.
-.sp
-\fBuseradd\fR
-and
-\fBnewusers\fR
-use this to set the mode of the home directory they create\&.
-.RE
-.PP
-\fBLASTLOG_UID_MAX\fR (number)
-.RS 4
-Highest user ID number for which the lastlog entries should be updated\&. As higher user IDs are usually tracked by remote user identity and authentication services there is no need to create a huge sparse lastlog file for them\&.
-.sp
-No
-\fBLASTLOG_UID_MAX\fR
-option present in the configuration means that there is no user ID limit for writing lastlog entries\&.
-.RE
-.PP
-\fBMAIL_DIR\fR (string)
-.RS 4
-The mail spool directory\&. This is needed to manipulate the mailbox when its corresponding user account is modified or deleted\&. If not specified, a compile\-time default is used\&. The parameter CREATE_MAIL_SPOOL in
-/etc/default/useradd
-determines whether the mail spool should be created\&.
-.RE
-.PP
-\fBMAIL_FILE\fR (string)
-.RS 4
-D\('efinir l\*(Aqemplacement des bo\(^ites aux lettres des utilisateurs relativement \(`a leur r\('epertoire personnel\&.
-.RE
-.PP
-The
-\fBMAIL_DIR\fR
-and
-\fBMAIL_FILE\fR
-variables are used by
-\fBuseradd\fR,
-\fBusermod\fR, and
-\fBuserdel\fR
-to create, move, or delete the user\*(Aqs mail spool\&.
-.PP
-If
-\fBMAIL_CHECK_ENAB\fR
-is set to
-\fIyes\fR, they are also used to define the
-\fBMAIL\fR
-environment variable\&.
-.PP
-\fBMAX_MEMBERS_PER_GROUP\fR (number)
-.RS 4
-Maximum members per group entry\&. When the maximum is reached, a new group entry (line) is started in
-/etc/group
-(with the same name, same password, and same GID)\&.
-.sp
-La valeur par d\('efaut est 0, ce qui signifie qu\*(Aqil n\*(Aqy a pas de limites pour le nombre de membres dans un groupe\&.
-.sp
-Cette fonctionnalit\('e (groupe d\('ecoup\('e) permet de limiter la longueur des lignes dans le fichier de groupes\&. Ceci est utile pour s\*(Aqassurer que les lignes pour les groupes NIS ne sont pas plus grandes que 1024 caract\(`eres\&.
-.sp
-Si vous avez besoin de configurer cette limite, vous pouvez utiliser 25\&.
-.sp
-Remarque\ \&: les groupes d\('ecoup\('es ne sont peut\-\(^etre pas pris en charge par tous les outils (m\(^eme dans la suite d\*(Aqoutils Shadow)\&. Vous ne devriez pas utiliser cette variable, sauf si vous en avez vraiment besoin\&.
-.RE
-.PP
-\fBPASS_MAX_DAYS\fR (number)
-.RS 4
-Nombre maximum de jours de validit\('e d\*(Aqun mot de passe\&. Apr\(`es cette dur\('ee, une modification du mot de passe est obligatoire\&. S\*(Aqil n\*(Aqest pas pr\('ecis\('e, la valeur de \-1 est utilis\('ee (ce qui enl\(`eve toute restriction)\&.
-.RE
-.PP
-\fBPASS_MIN_DAYS\fR (number)
-.RS 4
-The minimum number of days allowed between password changes\&. Any password changes attempted sooner than this will be rejected\&. If not specified, 0 will be assumed (which disables the restriction)\&.
-.RE
-.PP
-\fBPASS_WARN_AGE\fR (number)
-.RS 4
-Nombre de jours durant lesquels l\*(Aqutilisateur recevra un avertissement avant que son mot de passe n\*(Aqarrive en fin de validit\('e\&. Une valeur n\('egative signifie qu\*(Aqaucun avertissement n\*(Aqest donn\('e\&. S\*(Aqil n\*(Aqest pas pr\('ecis\('e, aucun avertissement n\*(Aqest donn\('e\&.
-.RE
-.PP
-\fBSUB_GID_MIN\fR (number), \fBSUB_GID_MAX\fR (number), \fBSUB_GID_COUNT\fR (number)
-.RS 4
-If
-/etc/subuid
-exists, the commands
-\fBuseradd\fR
-and
-\fBnewusers\fR
-(unless the user already have subordinate group IDs) allocate
-\fBSUB_GID_COUNT\fR
-unused group IDs from the range
-\fBSUB_GID_MIN\fR
-to
-\fBSUB_GID_MAX\fR
-for each new user\&.
-.sp
-The default values for
-\fBSUB_GID_MIN\fR,
-\fBSUB_GID_MAX\fR,
-\fBSUB_GID_COUNT\fR
-are respectively 100000, 600100000 and 65536\&.
-.RE
-.PP
-\fBSUB_UID_MIN\fR (number), \fBSUB_UID_MAX\fR (number), \fBSUB_UID_COUNT\fR (number)
-.RS 4
-If
-/etc/subuid
-exists, the commands
-\fBuseradd\fR
-and
-\fBnewusers\fR
-(unless the user already have subordinate user IDs) allocate
-\fBSUB_UID_COUNT\fR
-unused user IDs from the range
-\fBSUB_UID_MIN\fR
-to
-\fBSUB_UID_MAX\fR
-for each new user\&.
-.sp
-The default values for
-\fBSUB_UID_MIN\fR,
-\fBSUB_UID_MAX\fR,
-\fBSUB_UID_COUNT\fR
-are respectively 100000, 600100000 and 65536\&.
-.RE
-.PP
-\fBSYS_GID_MAX\fR (number), \fBSYS_GID_MIN\fR (number)
-.RS 4
-Range of group IDs used for the creation of system groups by
-\fBuseradd\fR,
-\fBgroupadd\fR, or
-\fBnewusers\fR\&.
-.sp
-The default value for
-\fBSYS_GID_MIN\fR
-(resp\&.
-\fBSYS_GID_MAX\fR) is 101 (resp\&.
-\fBGID_MIN\fR\-1)\&.
-.RE
-.PP
-\fBSYS_UID_MAX\fR (number), \fBSYS_UID_MIN\fR (number)
-.RS 4
-Range of user IDs used for the creation of system users by
-\fBuseradd\fR
-or
-\fBnewusers\fR\&.
-.sp
-The default value for
-\fBSYS_UID_MIN\fR
-(resp\&.
-\fBSYS_UID_MAX\fR) is 101 (resp\&.
-\fBUID_MIN\fR\-1)\&.
-.RE
-.PP
-\fBUID_MAX\fR (number), \fBUID_MIN\fR (number)
-.RS 4
-Range of user IDs used for the creation of regular users by
-\fBuseradd\fR
-or
-\fBnewusers\fR\&.
-.sp
-The default value for
-\fBUID_MIN\fR
-(resp\&.
-\fBUID_MAX\fR) is 1000 (resp\&. 60000)\&.
-.RE
-.PP
-\fBUMASK\fR (number)
-.RS 4
-Valeur d\*(Aqinitialisation du masque de permissions\&. S\*(Aqil n\*(Aqest pas pr\('ecis\('e, le masque des permissions sera initialis\('e \(`a 022\&.
-.sp
-\fBuseradd\fR
-and
-\fBnewusers\fR
-use this mask to set the mode of the home directory they create if
-\fBHOME_MODE\fR
-is not set\&.
-.sp
-It is also used by
-\fBlogin\fR
-to define users\*(Aq initial umask\&. Note that this mask can be overridden by the user\*(Aqs GECOS line (if
-\fBQUOTAS_ENAB\fR
-is set) or by the specification of a limit with the
-\fIK\fR
-identifier in
-\fBlimits\fR(5)\&.
-.RE
-.PP
-\fBUSERGROUPS_ENAB\fR (boolean)
-.RS 4
-Activer la mise en place de bits de masque de groupe (\(Fo\ \&umask group bits\ \&\(Fc) identiques \(`a ceux du propri\('etaire (exemple\ \&: 022 \-> 002, 077 \-> 007) pour les utilisateurs non privil\('egi\('es, si l\*(AqUID est identique au GID et que l\*(Aqidentifiant de connexion est identique au groupe principal\&.
-.sp
-If set to
-\fIyes\fR,
-\fBuserdel\fR
-will remove the user\*(Aqs group if it contains no more members, and
-\fBuseradd\fR
-will create by default a group with the name of the user\&.
-.RE
.SH "FICHIERS"
.PP
/etc/passwd
@@ -779,7 +571,7 @@ specified group doesn\*(Aqt exist
.PP
\fI9\fR
.RS 4
-username already in use
+username or group name already in use
.RE
.PP
\fI10\fR