groupadd

NOM

groupadd - Cr'eer un nouveau groupe

SYNOPSIS

groupadd [options] groupe

DESCRIPTION

The groupadd 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.

OPTIONS

Les options disponibles pour la commande groupadd sont :

-f, --force

This option causes the command to simply exit with success status if the specified group already exists. When used with -g, and the specified GID already exists, another (unique) GID is chosen (i.e. -g is turned off).

-g, --gid GID

La valeur num'erique de l'identifiant du groupe (Fo group ID Fc ou GID). Cette valeur doit ^etre unique, `a moins que l'option -o ne soit utilis'ee. La valeur ne doit pas ^etre n'egative. Par d'efaut le plus petit identifiant plus grand que 999 et que les identifiants des groupes existants est utilis'e. Les valeurs comprises entre 0 et 999 sont g'en'eralement r'eserv'ees aux comptes syst`eme.

-h, --help

Afficher un message d'aide et quitter.

-K, --key CL'E=VALEUR

Surcharger les valeurs par d'efaut du fichier /etc/login.defs (GID_MIN, GID_MAX et autres). L'option -K peut ^etre indiqu'ee plusieurs fois.
Exemple : -K GID_MIN=10 -K GID_MAX=499
Note : -K GID_MIN=10,GID_MAX=499 ne fonctionne pas pour l'instant.

-o, --non-unique

This option permits to add a group with a non-unique GID.

-p, --password MOT_DE_PASSE

Le mot de passe chiffr'e, comme renvoy'e par crypt(3). Le comportement par d'efaut est de d'esactiver le mot de passe.

Note: This option is not recommended because the password (or encrypted password) will be visible by users listing the processes.
You should make sure the password respects the system's password policy.

-r, --system

Cr'eer un groupe syst`eme.
The numeric identifiers of new system groups are choosen in the SYS_GID_MIN-SYS_GID_MAX range, defined in login.defs, instead of GID_MIN-GID_MAX.

CONFIGURATION

Les variables de configuration suivantes de /etc/login.defs modifient le comportement de cet outil :

GID_MAX (nombre), GID_MIN (nombre)

Plage d'identifiants num'eriques de groupes que les commandes useradd, groupadd ou newusers peuvent utiliser pour la cr'eation des groupes normaux.

MAX_MEMBERS_PER_GROUP (nombre)

Nombre maximum de membres par entr'ee de groupe. Lorsque le maximum est atteint, une nouvelle entr'ee de groupe (ligne) est d'emarr'ee dans /etc/group (avec le m^eme nom, m^eme mot de passe, et m^eme GID).
La valeur par d'efaut est 0, ce qui signifie qu'il n'y a pas de limites pour le nombre de membres dans un groupe.
Cette fonctionnalit'e (groupe d'ecoup'e) permet de limiter la longueur des lignes dans le fichier de groupes. Ceci est utile pour s'assurer que les lignes pour les groupes NIS ne sont pas plus grandes que 1024 caract`eres.
Si vous avez besoin de fixer cette limite, vous pouvez utiliser 25.
Remarque : les groupes d'ecoup'es ne sont peut-^etre pas pris en charge par tous les outils (m^eme dans la suite d'outils Shadow). Vous ne devriez pas utiliser cette variable, sauf si vous en avez vraiment besoin.

SYS_GID_MAX (nombre), SYS_GID_MIN (nombre)

Plage d'identifiants num'eriques de groupes que les commandes useradd, groupadd ou newusers peuvent utiliser pour la cr'eation de groupes syst`eme.

FICHIERS

/etc/group

Informations sur les groupes.

/etc/gshadow

Informations s'ecuris'ees sur les groupes.

/etc/login.defs

Configuration de la suite des mots de passe cach'es Fo shadow password Fc.

AVERTISSEMENTS

Les noms de groupe doivent commencer par une lettre minuscule ou un tiret bas (Fo underscore Fc), et seuls des lettres minuscules, des chiffres, des Fo underscore Fc, ou des tirets peuvent suivre. Ils peuvent se terminer par un signe dollar. Soit, sous la forme d'une expression rationnelle : [a-z_][a-z0-9_-]*[$]?

Les noms de groupe sont limit'es `a 16 caract`eres.

You may not add a NIS or LDAP group. This must be performed on the corresponding server.

If the groupname already exists in an external group database such as NIS or LDAP, groupadd will deny the group creation request.

VALEURS DE RETOUR

La commande groupadd retourne les valeurs suivantes en quittant :

0

succ`es

2

erreur de syntaxe

3

param`etre non valable pour l'option

4

GID d'ej`a utilis'e (et -o n'est pas utilis'e)

9

nom de groupe d'ej`a utilis'e

10

impossible de mettre `a jour le fichier des groupes

VOIR AUSSI

chfn(1), chsh(1), passwd(1), gpasswd(8), groupdel(8), groupmod(8), login.defs(5), useradd(8), userdel(8), usermod(8).