'\" t .\" Title: groupadd .\" Author: Julianne Frances Haugh .\" Generator: DocBook XSL Stylesheets vsnapshot .\" Date: 22/01/2022 .\" Manual: Commandes de gestion du syst\(`eme .\" Source: shadow-utils 4.11.1 .\" Language: French .\" .TH "GROUPADD" "8" "22/01/2022" "shadow\-utils 4\&.11\&.1" "Commandes de gestion du syst\(`em" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ .\" http://bugs.debian.org/507673 .\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ .ie \n(.g .ds Aq \(aq .el .ds Aq ' .\" ----------------------------------------------------------------- .\" * set default formatting .\" ----------------------------------------------------------------- .\" disable hyphenation .nh .\" disable justification (adjust text to left margin only) .ad l .\" ----------------------------------------------------------------- .\" * MAIN CONTENT STARTS HERE * .\" ----------------------------------------------------------------- .SH "NOM" groupadd \- Cr\('eer un nouveau groupe .SH "SYNOPSIS" .HP \w'\fBgroupadd\fR\ 'u \fBgroupadd\fR [\fIoptions\fR] \fIgroupe\fR .SH "DESCRIPTION" .PP The \fBgroupadd\fR command creates a new group account using the values specified on the command line plus the default values from the system\&. The new group will be entered into the system files as needed\&. .SH "OPTIONS" .PP The options which apply to the \fBgroupadd\fR command are: .PP \fB\-f\fR, \fB\-\-force\fR .RS 4 This option causes the command to simply exit with success status if the specified group already exists\&. When used with \fB\-g\fR, and the specified GID already exists, another (unique) GID is chosen (i\&.e\&. \fB\-g\fR is turned off)\&. .RE .PP \fB\-g\fR, \fB\-\-gid\fR\ \&\fIGID\fR .RS 4 The numerical value of the group\*(Aqs ID\&. This value must be unique, unless the \fB\-o\fR option is used\&. The value must be non\-negative\&. The default is to use the smallest ID value greater than or equal to \fBGID_MIN\fR and greater than every other group\&. .sp See also the \fB\-r\fR option and the \fBGID_MAX\fR description\&. .RE .PP \fB\-h\fR, \fB\-\-help\fR .RS 4 Afficher un message d\*(Aqaide et quitter\&. .RE .PP \fB\-K\fR, \fB\-\-key\fR\ \&\fIKEY\fR=\fIVALUE\fR .RS 4 Overrides /etc/login\&.defs defaults (GID_MIN, GID_MAX and others)\&. Multiple \fB\-K\fR options can be specified\&. .sp Example: \fB\-K\fR\ \&\fIGID_MIN\fR=\fI100\fR\ \& \fB\-K\fR\ \&\fIGID_MAX\fR=\fI499\fR .sp Note: \fB\-K\fR\ \&\fIGID_MIN\fR=\fI10\fR,\fIGID_MAX\fR=\fI499\fR doesn\*(Aqt work yet\&. .RE .PP \fB\-o\fR, \fB\-\-non\-unique\fR .RS 4 Cette option permet d\*(Aqajouter un groupe avec un identifiant (\(Fo\ \&GID\ \&\(Fc) d\('ej\(`a utilis\('e\&. .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\&. .sp \fBNote:\fR This option is not recommended 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 .PP \fB\-r\fR, \fB\-\-system\fR .RS 4 Cr\('eer un groupe syst\(`eme\&. .sp The numeric identifiers of new system groups are chosen in the \fBSYS_GID_MIN\fR\-\fBSYS_GID_MAX\fR range, defined in login\&.defs, instead of \fBGID_MIN\fR\-\fBGID_MAX\fR\&. .RE .PP \fB\-R\fR, \fB\-\-root\fR\ \&\fICHROOT_DIR\fR .RS 4 Apply changes in the \fICHROOT_DIR\fR directory and use the configuration files from the \fICHROOT_DIR\fR directory\&. .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\&. .RE .PP \fB\-U\fR, \fB\-\-users\fR .RS 4 A list of usernames to add as members of the group\&. .sp The default behavior (if the \fB\-g\fR, \fB\-N\fR, and \fB\-U\fR options are not specified) is defined by the \fBUSERGROUPS_ENAB\fR variable in /etc/login\&.defs\&. .RE .SH "CONFIGURATION" .PP The following configuration variables in /etc/login\&.defs change the behavior of this tool: .SH "FICHIERS" .PP /etc/group .RS 4 Informations sur les groupes\&. .RE .PP /etc/gshadow .RS 4 Informations s\('ecuris\('ees sur les groupes\&. .RE .PP /etc/login\&.defs .RS 4 Configuration de la suite des mots de passe cach\('es \(Fo\ \&shadow password\ \&\(Fc\&. .RE .SH "AVERTISSEMENTS" .PP It is usually recommended to only use groupnames that begin with a lower case letter or an underscore, followed by lower case letters, digits, underscores, or dashes\&. They can end with a dollar sign\&. In regular expression terms: [a\-z_][a\-z0\-9_\-]*[$]? .PP On Debian, the only constraints are that groupnames must neither start with a dash (\*(Aq\-\*(Aq) nor plus (\*(Aq+\*(Aq) nor tilde (\*(Aq~\*(Aq) nor contain a colon (\*(Aq:\*(Aq), a comma (\*(Aq,\*(Aq), or a whitespace (space:\*(Aq \*(Aq, end of line: \*(Aq\en\*(Aq, tabulation: \*(Aq\et\*(Aq, etc\&.)\&. .PP Groupnames may only be up to 32 characters long\&. .PP Vous ne pouvez pas ajouter d\*(Aqutilisateur \(`a un groupe NIS ou LDAP\&. Cela doit \(^etre effectu\('e sur le serveur correspondant\&. .PP If the groupname already exists in an external group database such as NIS or LDAP, \fBgroupadd\fR will deny the group creation request\&. .SH "VALEURS DE RETOUR" .PP The \fBgroupadd\fR command exits with the following values: .PP \fI0\fR .RS 4 success .RE .PP \fI2\fR .RS 4 invalid command syntax .RE .PP \fI3\fR .RS 4 invalid argument to option .RE .PP \fI4\fR .RS 4 GID is already used (when called without \fB\-o\fR) .RE .PP \fI9\fR .RS 4 group name is already used .RE .PP \fI10\fR .RS 4 can\*(Aqt update group file .RE .SH "VOIR AUSSI" .PP \fBchfn\fR(1), \fBchsh\fR(1), \fBpasswd\fR(1), \fBgpasswd\fR(8), \fBgroupdel\fR(8), \fBgroupmod\fR(8), \fBlogin.defs\fR(5), \fBuseradd\fR(8), \fBuserdel\fR(8), \fBusermod\fR(8)\&.