table of contents
other languages
| USERADD(8) | Commandes de gestion du systèm | USERADD(8) |
NOM¶
useradd - créer un nouvel utilisateur ou modifier les informations par défaut appliquées aux nouveaux utilisateursSYNOPSIS¶
useradd
[ options] LOGIN
useradd
-D
useradd
-D [ options]
DESCRIPTION¶
OPTIONS¶
Les options disponibles pour la commande useradd sont : -b, --base-dir RÉP_BASERépertoire de base par défaut du
système si l'option -d RÉP_PERSO n'est pas
spécifiée. RÉP_BASE est concaténé avec le nom
du compte pour définir le répertoire personnel. Quand l'option
-m n'est pas utilisée, RÉP_BASE doit exister.
Si cette option n'est pas précisée, useradd utilisera le
répertoire de base précisé par la variable HOME dans
/etc/default/useradd ou /home par défaut.
-c, --comment COMMENTAIRE
Toute chaîne de texte. C'est
généralement une description courte du compte, elle est actuellement
utilisée comme champ pour le nom complet de l'utilisateur.
-d, --home RÉP_PERSO
Le nouvel utilisateur sera créé en
utilisant RÉP_PERSO comme valeur de répertoire de connexion
de l'utilisateur. Le comportement par défaut est de concaténer
UTILISATEUR au répertoire RÉP_BASE, et de l'utiliser
en tant que nom de répertoire de connexion. Il n'est pas nécessaire
que le répertoire RÉP_PERSO existe mais il ne sera pas
créé s'il n'existe pas.
-D, --defaults
Consultez ci-dessous la sous-section
« Modifier les valeurs par défaut ».
-e, --expiredate DATE_FIN_VALIDITÉ
Date à laquelle le compte utilisateur
sera désactivé. La date est indiquée dans le format
AAAA-MM-JJ.
Si non précisé, useradd utilisera la date d'expiration par
défaut précisée par la variable EXPIRE dans
/etc/default/useradd ou une chaîne vide (pas d'expiration) par
défaut.
-f, --inactive DURÉE_INACTIVITÉ
Nombre de jours suivant la fin de
validité d'un mot de passe après lequel le compte est
définitivement désactivé. Une valeur de 0 désactive le
compte dès que le mot de passe a dépassé sa fin de
validité, et une valeur de -1 désactive cette fonctionnalité.
Si non précisé, useradd utilisera la période
d'inactivité par défaut précisée par la variable
INACTIVE dans /etc/default/useradd, ou -1 par défaut.
-g, --gid GROUPE
Nom du groupe ou identifiant numérique du
groupe de connexion initial de l'utilisateur. Le nom du groupe doit exister.
Un numéro de groupe doit se référer à un groupe
déjà existant.
Si non précisé, le comportement de useradd dépendra de la
variable USERGROUPS_ENAB dans /etc/login.defs. Si cette variable est
configurée à yes (ou si -U/--user-group est
précisée sur la ligne de commandes), un groupe sera créé
pour l'utilisateur, avec le même nom que son identifiant. Si la variable
est configurée à no (ou si -N/--no-user-group est
précisé sur la ligne de commandes), useradd configurera le groupe
primaire du nouvel utilisateur à la valeur précisée par la
variable GROUP dans /etc/default/useradd, ou 100 par défaut.
-G, --groups GROUPE1[,GROUPE2,...[,GROUPEN]]]
Liste de groupes supplémentaires auxquels
appartient également l'utilisateur. Chaque groupe est séparé du
suivant par une virgule, sans espace entre eux. Les groupes sont soumis aux
mêmes restrictions que celles de l'option -g. Le comportement par
défaut pour l'utilisateur est de n'appartenir qu'au groupe initial.
-h, --help
Afficher un message d'aide et quitter.
-k, --skel RÉP_SQUELETTE
Le répertoire squelette, qui contient les
fichiers et répertoires qui seront copiés dans le répertoire
personnel de l'utilisateur, quand le répertoire personnel est
créé par useradd.
Cette option n'est valable que si l'option -m (ou --create-home)
est utilisée.
Si cette option n'est pas précisée, le répertoire squelette est
défini par la variable SKEL dans /etc/default/useradd ou, par
défaut, /etc/skel.
Si possible, les ACL et les attributs étendus seront copiés.
-K, --key CLÉ=VALEUR
Surcharge les valeurs par défaut de
/etc/login.defs ( UID_MIN, UID_MAX, UMASK,
PASS_MAX_DAYS et autres).
Par exemple : -K PASS_MAX_DAYS=-1 peut être
utilisé pour la création de comptes système pour
désactiver la gestion de la durée de validité des mots de
passe, même si les comptes système n'ont pas de mot de passe.
Plusieurs options -K peuvent être précisées, comme par
exemple : -K UID_MIN=100 -K
UID_MAX=499
-l, --no-log-init
N'ajoute pas l'utilisateur aux bases de
données lastlog et faillog.
Par défaut, les entrées de l'utilisateur dans les bases de
données lastlog et faillog sont remises à zéro pour éviter
de réutiliser les entrées d'un utilisateur précédemment
supprimé.
For the compatibility with previous Debian's useradd, the -O
option is also supported.
-m, --create-home
Créé le répertoire personnel de
l'utilisateur s'il n'existe pas. Les fichiers et les répertoires contenus
dans le répertoire squelette (qui peut être défini avec
l'option -k) sera copié dans le répertoire personnel.
Par défaut, si cette option n'est pas précisée et si
CREATE_HOME n'est pas activée, aucun répertoire personnel ne
sera créé.
-M
Ne crée pas le répertoire personnel
de l'utilisateur, même si la configuration globale au système
contenue dans /etc/login.defs ( CREATE_HOME) est configurée à
yes.
-N, --no-user-group
Ne crée pas de groupe avec le même
nom que celui de l'utilisateur, mais ajoute l'utilisateur au groupe
précisé par l'option -g ou par la variable GROUP dans
/etc/default/useradd.
Le comportement par défaut (si les options -g, -N, et
-U ne sont pas précisées) est défini par la variable
USERGROUPS_ENAB dans /etc/login.defs.
-o, --non-unique
Permet de créer un compte d'utilisateur
avec un identifiant (« UID ») dupliqué (non unique).
Cette option n'est valable qu'avec l'option -u.
-p, --password MOT_DE_PASSE
Le mot de passe chiffré, comme
renvoyé par crypt(3). Le comportement par défaut est de
désactiver le mot de passe.
Remarque : l'utilisation de cette option est déconseillée
car le mot de passe (ou le mot de passe chiffré) peut être visible
des utilisateurs qui affichent la liste des processus.
Il est nécessaire de vérifier si le mot de passe respecte la politique
de mots de passe du système.
-r, --system
Créer un compte système.
Les utilisateurs système seront créés sans information
d'expiration dans /etc/shadow, et leur identifiant numérique est choisi
dans l'intervalle SYS_UID_MIN-SYS_UID_MAX, défini dans
/etc/login.defs, au lieu de UID_MIN-UID_MAX (et leurs
équivalents GID pour la création des groupes).
Notez que useradd ne créera pas de répertoire personnel pour
ces utilisateurs, indépendamment de la configuration par défaut dans
/etc/login.defs ( CREATE_HOME). Vous devez préciser l'option
-m si vous voulez qu'un répertoire personnel soit créé
pour un compte système.
-R, --root RÉP_CHROOT
Appliquer les changements dans le
répertoire RÉP_CHROOT et utiliser les fichiers de
configuration du répertoire RÉP_CHROOT.
-s, --shell INTERPRÉTEUR
Le nom de l'interpréteur de commandes
initial de l'utilisateur (« login shell »). Le
comportement par défaut est de laisser ce champ vide. Le système
sélectionnera alors l'interpréteur par défaut indiqué par
la variable SHELL dans /etc/default/useradd, ou une chaîne vide
par défaut.
-u, --uid UID
La valeur numérique de l'identifiant de
l'utilisateur. Cette valeur doit être unique, sauf si l'option -o
est utilisée. La valeur ne doit pas être négative. Le
comportement par défaut est d'utiliser la plus petite valeur
d'identifiant à la fois supérieure ou égale à
UID_MIN et supérieure aux identifiants de tous les autres
utilisateurs.
Voir aussi aussi l'option -r et la description de UID_MAX.
-U, --user-group
Crée un groupe avec le même nom que
celui de l'utilisateur, et ajoute l'utilisateur à ce groupe.
Le comportement par défaut (si les options -g, -N, et
-U ne sont pas précisées) est défini par la variable
USERGROUPS_ENAB dans /etc/login.defs.
-Z, --selinux-user UTILISATEUR_SELINUX
L'utilisateur SELinux utilisé pour la
connexion de l'utilisateur. Le comportement par défaut est de laisser ce
champ vide. Le système sélectionnera alors l'utilisateur SELinux par
défaut.
Modifier les valeurs par défaut¶
Quand il est invoqué avec seulement l'option -D, useradd affichera les valeurs actuelles par défaut. Quand il est invoqué avec l'option -D et d'autres options, useradd mettra à jour les valeurs par défaut des options précisées. Les options valables sont : -b, --base-dir RÉP_BASEPréfixe du chemin des répertoires
personnels pour les nouveaux utilisateurs. Le nom de l'utilisateur sera
attaché à la fin de RÉP_PERSO pour créer le nom du
nouveau répertoire personnel si l'option -d n'est pas
utilisée pendant la création d'un nouveau compte.
Cette option configure la variable HOME dans /etc/default/useradd.
-e, --expiredate DATE_FIN_VALIDITÉ
Date à laquelle le compte utilisateur
sera désactivé.
Cette option configure la variable EXPIRE dans
/etc/default/useradd.
-f, --inactive DURÉE_INACTIVITÉ
Nombre de jours après la fin de
validité d'un mot de passe avant que le compte ne soit
désactivé.
Cette option configure la variable INACTIVE dans
/etc/default/useradd.
-g, --gid GROUPE
Le nom ou l'identifiant du groupe pour le
groupe principal d'un nouvel utilisateur (quand l'option
-N/--no-user-group est utilisée ou quand la variable
USERGROUPS_ENAB est configurée à no dans
/etc/login.defs). Le nom du groupe doit exister, et un identifiant de groupe
numérique doit avoir une entrée existante.
Cette option configure la variable GROUP dans /etc/default/useradd.
-s, --shell INTERPRÉTEUR
Le nom de l'interpréteur de commandes du
nouvel utilisateur.
Cette option configure la variable SHELL dans /etc/default/useradd.
NOTES¶
L'administrateur système doit se charger de placer les fichiers par défaut dans le répertoire /etc/skel (ou tout autre répertoire de modèles indiqué dans /etc/default/useradd ou sur la ligne de commande).AVERTISSEMENTS¶
Vous ne pouvez pas ajouter d'utilisateur à un groupe NIS ou LDAP. Cela doit être effectué sur le serveur correspondant. De la même façon, si le nom de l'utilisateur existe dans une base de données externe, telle que NIS ou LDAP, useradd refusera de créer le compte d'utilisateur. It is usually recommended to only use usernames 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_-]*[$]? On Debian, the only constraints are that usernames must neither start with a dash ('-') nor plus ('+') nor tilde ('~') nor contain a colon (':'), a comma (','), or a whitespace (space: ' ', end of line: '\n', tabulation: '\t', etc.). Note that using a slash ('/') may break the default algorithm for the definition of the user's home directory. Les noms d'utilisateur sont limités à 16 caractères.CONFIGURATION¶
Les variables de configuration suivantes dans /etc/login.defs modifient le comportement de cet outil : CREATE_HOME (boolean)Indiquer si un répertoire personnel doit
être créé par défaut pour les nouveaux utilisateurs.
Ce réglage ne s'applique pas pour les utilisateurs système, et peut
être annulé sur la ligne de commande.
GID_MAX (nombre), GID_MIN (nombre)
Plage d'identifiants numériques de
groupes que les commandes useradd, groupadd ou newusers
peuvent utiliser pour la création des groupes normaux.
La valeur par défaut pour GID_MIN (respectivement GID_MAX)
est 1000 (respectivement 60000).
MAIL_DIR (chaîne de caractères)
Répertoire d'attente des courriels
(« mail spool directory »). Ce paramètre est
nécessaire pour manipuler les boîtes à lettres lorsque le
compte d'un utilisateur est modifié ou supprimé. S'il n'est pas
spécifié, une valeur par défaut définie à la
compilation est utilisée.
MAIL_FILE (chaîne de caractères)
Définir l'emplacement des boîtes aux
lettres des utilisateurs relativement à leur répertoire
personnel.
Les paramètres MAIL_DIR et MAIL_FILE sont utilisés par
useradd, usermod et userdel pour créer,
déplacer ou supprimer les boîtes aux lettres des utilisateurs.
MAX_MEMBERS_PER_GROUP (nombre)
Nombre maximum de membres par entrée de
groupe. Lorsque le maximum est atteint, une nouvelle entrée de groupe
(ligne) est démarrée dans /etc/group (avec le même nom,
même mot de passe, et même GID).
La valeur par défaut est 0, ce qui signifie qu'il n'y a pas de limites pour
le nombre de membres dans un groupe.
Cette fonctionnalité (groupe découpé) 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ères.
Si vous avez besoin de configurer cette limite, vous pouvez utiliser 25.
Remarque : les groupes découpés ne sont peut-être pas pris
en charge par tous les outils (même dans la suite d'outils Shadow). Vous
ne devriez pas utiliser cette variable, sauf si vous en avez vraiment
besoin.
PASS_MAX_DAYS (nombre)
Nombre maximum de jours de validité d'un
mot de passe. Après cette durée, une modification du mot de passe
est obligatoire. S'il n'est pas précisé, la valeur de -1 est
utilisée (ce qui enlève toute restriction).
PASS_MIN_DAYS (nombre)
Nombre minimum de jours autorisé avant la
modification d'un mot de passe. Toute tentative de modification du mot de
passe avant cette durée est rejetée. S'il n'est pas
précisé, la valeur de -1 est utilisée (ce qui enlève toute
restriction).
PASS_WARN_AGE (nombre)
Nombre de jours durant lesquels l'utilisateur
recevra un avertissement avant que son mot de passe n'arrive en fin de
validité. Une valeur négative signifie qu'aucun avertissement n'est
donné. S'il n'est pas précisé, aucun avertissement n'est
donné.
SYS_GID_MAX (nombre), SYS_GID_MIN (nombre)
Plage d'identifiants numériques de
groupes que les commandes useradd, groupadd ou newusers
peuvent utiliser pour la création de groupes système.
La valeur par défaut pour SYS_GID_MIN (respectivement
SYS_GID_MAX) est 101 (respectivement GID_MIN-1).
SYS_UID_MAX (nombre), SYS_UID_MIN (nombre)
Plage d'identifiants numériques
d'utilisateurs que les commandes useradd ou newusers peuvent
utiliser pour la création d'utilisateurs système.
La valeur par défaut pour SYS_UID_MIN (respectivement
SYS_UID_MAX) est 101 (respectivement UID_MIN-1).
UID_MAX (nombre), UID_MIN (nombre)
Plage d'identifiants numériques
d'utilisateurs que les commandes useradd ou newusers peuvent
utiliser pour la création d'utilisateurs normaux.
La valeur par défaut de UID_MIN (respectivement UID_MAX) est
1000 (respectivement 60000).
UMASK (nombre)
Valeur d'initialisation du masque de
permissions. S'il n'est pas précisé, le masque des permissions sera
initialisé à 022.
useradd et newusers utilisent ce masque pour définir les
permissions d'accès des répertoires personnels qu'ils créent.
Il est également utilisé par pam_umask en tant que valeur
d'umask par défaut.
USERGROUPS_ENAB (booléen)
Si cette variable est configurée à
yes, userdel supprimera le groupe de l'utilisateur s'il ne
contient pas d'autres membres, et useradd créera par défaut
un groupe portant le nom de l'utilisateur.
FICHIERS¶
/etc/passwdInformations sur les comptes des
utilisateurs.
/etc/shadow
Informations sécurisées sur les
comptes utilisateurs.
/etc/group
Informations sur les groupes.
/etc/gshadow
Informations sécurisées sur les
groupes.
/etc/default/useradd
Valeurs par défaut pour la création
de comptes.
/etc/skel/
Répertoire contenant les fichiers par
défaut.
/etc/login.defs
Configuration de la suite des mots de passe
cachés « shadow password ».
VALEURS DE RETOUR¶
La commande useradd retourne les valeurs suivantes en quittant : 0succès
1
impossible de mettre à jour le fichier
des mots de passe
2
erreur de syntaxe
3
paramètre non valable pour l'option
4
UID déjà utilisé (et pas
d'option -o)
6
le groupe spécifié n'existe
pas
9
nom d'utilisateur déjà
utilisé
10
impossible de mettre à jour le fichier
des groupes
12
impossible de créer le répertoire
personnel
14
can't update SELinux user mapping
VOIR AUSSI¶
chfn(1), chsh(1), passwd(1), crypt(3), groupadd(8), groupdel(8), groupmod(8), login.defs(5), newusers(8), userdel(8), usermod(8).| 25/05/2012 | shadow-utils 4.1.5.1 |