NOM¶

adduser, addgroup – Ajouter ou manipuler des utilisateurs ou des groupes

SYNOPSIS¶

DESCRIPTION¶

adduser et addgroup ajoutent des utilisateurs ou des groupes au système en fonction des options fournies en ligne de commande et des informations contenues dans le fichier de configuration /etc/adduser.conf. Ce sont des interfaces plus spécifiques à Debian que les programmes de bas niveau tels que useradd, groupadd et usermod qui sont des programmes plus indépendants de la distribution. adduser et addgroup choisissent par défaut des valeurs d’UID ou de GID conformes à la charte Debian, créant un répertoire personnel de configuration basique (/etc/skel/),exécutant un script sur mesure et ayant d'autres fonctionnalités.

adduser et addgroup sont conçus pour se conformer à la charte, aidant les responsables de paquet et les administrateurs locaux à créer des comptes locaux sur le système de la manière que Debian s'attend à ce que cela soit fait, et prenant en charge les modifications probables de spécifications de la politique de Debian. adduser --system porte une attention spéciale à ne nécessiter qu’un seul appel dans les scripts du responsable de paquet sans aucune enveloppe conditionnelle, suppression d’erreur ou autre échafaudage.

adduser respecte la distinction entre des groupes et utilisateurs système alloués dynamiquement et des comptes utilisateur alloués dynamiquement qui est documentée dans la Charte Debian, chapitre 9.2.2.

Pour une liste complète et des explications sur toutes les options, consulter la section OPTIONS.

adduser et addgroup peuvent être exécutés dans un des cinq modes suivants :

OPTIONS¶

Différents modes de adduser permettent différentes options. Si aucun mode autorisé n’est listé pour une option, tous les modes sont acceptés.

Des versions courtes pour certaines options peuvent exister pour des raisons historiques. Elles continueront d’être gérées, mais sont retirées de la documentation. Il est conseillé de migrer vers les versions longues des options.

--add-extra-groups

Ajouter un nouvel utilisateur aux groupes supplémentaires définis dans le réglage EXTRA_GROUPS des fichiers de configuration. L’ancienne formulation --add_extra_groups est obsolète et sera gérée dans Debian Bookworm seulement. Les modes autorisés sont adduser et adduser --system.

--allow-all-names

Autoriser n’importe quel utilisateur ou nom de groupe pris en charge par le useradd(8) sous-jacent. Consulter NOMS AUTORISÉS ci-après. Modes autorisés : adduser, adduser --system, addgroup, addgroup --system.

--allow-bad-names

Désactiver les vérifications NAME_REGEX et SYS_NAME_REGEX de nom. Seule une vérification moindre de validité est appliquée. Consulter NOMS AUTORISÉS ci-après. Modes autorisés : adduser, adduser --system, addgroup, addgroup --system.

--comment commentaire

Régler le champ commentaire pour la nouvelle entrée créée. adduser ne posera pas de question pour cette information si cette option est fournie. Ce champ est aussi connu sous le nom GECOS et contient des informations utilisées par la commande finger(1). C’était l’option --gecos qui est devenue obsolète et qui sera supprimée après Bookworm de Debian. Modes autorisés : adduser, adduser --system.

--conf fichier

Utiliser fichier plutôt que /etc/adduser.conf. Plusieurs options --conf peuvent être indiquées.

--debug

Synonymous to --stdoutmsglevel=debug. Deprecated.

--disabled-login

--disabled-password

Ne pas exécuter passwd(1) pour définir un mot de passe. Dans la plupart des situations, les connexions sont cependant encore possibles (par exemple, en utilisant des clés SSH ou à travers PAM) pour des raisons qui sont en dehors du domaine de adduser. De plus --disabled-login définira l’interpréteur à /usr/sbin/nologin. Mode autorisé : adduser.

--firstuid ID

--lastuid ID

--firstgid ID

--lastgid ID

Override the first UID / last UID / first GID / last GID in the range that the uid is chosen from (FIRST_UID, LAST_UID, FIRST_GID and LAST_GID, FIRST_SYSTEM_UID, LAST_SYSTEM_UID, FIRST_SYSTEM_GID and LAST_SYSTEM_GID in the configuration file). If a group is created as a usergroup (that is, for adduser without --ingroup, or for adduser --system --group without --ingroup), --firstgid and --lastgid are not ignored: they bound the GID side of the combined UID/GID search described under Add a regular (non-system) user above, so a narrower or shifted --firstgid/--lastgid range can change which number is chosen, or cause the search to fail if it no longer overlaps the UID range at all. The resulting group always gets the same numeric ID as the user. If --ingroup is used instead, --firstgid and --lastgid have no effect; --firstuid and --lastuid still bound whether the requested group's GID can be preferred as the new user's UID (see Add a regular (non-system) user above). Valid modes: adduser, adduser --system, for --firstgid and --lastgid also addgroup.

--force-badname

--allow-badname

Ce sont des formes obsolètes de --allow-bad-names. Elles seront supprimées dans le cycle de publications de Debian 13.

--gid GID

When creating a group, this option sets the group ID number of the new group to GID. When creating a user, this option sets the primary group ID number of the new user to GID. For adduser --system specifically, if the chosen UID is not also given explicitly with --uid, and GID happens to also be free as a UID within the UID range in effect, adduser prefers that number for the new user's UID (see --ingroup). This does not apply to a non-system adduser: there, --gid alone never influences UID selection this way. Valid modes: adduser, adduser --system, addgroup, addgroup --system.

--group

En utilisant cette option adduser --system indique que le nouvel utilisateur devrait obtenir un groupe de nom identique comme groupe primaire. Si celui-ci n’existe pas déjà, il est créé. Sans l’option --system, un groupe avec le nom indiqué est créé, c’est l’action par défaut si le programme est invoqué en tant que addgroup. Modes autorisés : adduser --system, addgroup, addgroup --system.

--help

Afficher un résumé des instructions.

--home rép

Utiliser rép comme répertoire personnel de l'utilisateur, plutôt que la valeur par défaut définie dans le fichier de configuration (ou /nonexistent si adduser --system est utilisé). Si le répertoire n'existe pas, il est créé. Modes autorisés : adduser, adduser --system.

--ingroup groupe

When creating a user, this option sets the primary group ID number of the new user to the GID of the named group. Unlike with the --gid option, the group is specified here by name rather than by numeric ID number. The group must already exist. If the chosen UID is not also given explicitly with --uid, and GROUP's GID happens to also be free as a UID within the UID range in effect (see --firstuid / --lastuid), adduser prefers that number for the new user's UID, so the user ends up with a UID matching the group's GID even though the group itself was not newly created. Otherwise, the first available UID in range is used, as before. Valid modes: adduser, adduser --system.

--lastuid ID

--lastgid ID

Écraser le dernier UID et le dernier GID. Consulter --firstuid.

--no-create-home

Ne pas créer de répertoire personnel pour le nouvel utilisateur. Il est à remarquer que le nom de chemin pour le répertoire personnel du nouvel utilisateur sera quand même entré dans le champ approprié du fichier /etc/passwd. L’utilisation de cette option n’implique pas que ce champ soit vide. Il indique plutôt à adduser qu'un autre mécanisme sera responsable de l’initialisation du répertoire personnel du nouvel utilisateur s’il doit exister. Modes autorisés : adduser, adduser --system.

--force-home

Assume the home directory does already exist and has been taken care of by the local administrator. chown the directory to the newly created user and populate it with the files from /etc/skel without double checking. This allows to put new home directories on an md, lvm, or dm-crypt device. Valid modes: adduser.

--no-copy-skel

Do not populate the home directory for the new user with files from /etc/skel. If the home directory is newly created, it will be empty. Valid modes: adduser, adduser --system.

--quiet

Synonymous to --stdoutmsglevel=warn. Deprecated.

--shell IDC

Utiliser IDC comme interpréteur de connexion de l’utilisateur (« login shell »), plutôt que l'interpréteur par défaut donné dans le fichier de configuration (ou /usr/sbin/nologin si adduser --system est utilisé). Modes autorisés : adduser, adduser --system.

--system

Normalement, adduser crée des comptes et groupes d’utilisateurs dynamiquement alloués comme définis dans la Charte Debian, chapitre 9.2.2. Avec cette option, adduser crée un utilisateur et groupe système dynamiquement alloués et modifie son mode respectivement. Modes autorisés : adduser, addgroup.

--uid ID

Forcer le nouvel identifiant utilisateur à un entier donné. adduser échouera si cet identifiant est déjà utilisé. Modes autorisés : adduser, adduser --system.

--verbose

Synonymous to --stdoutmsglevel=info. Deprecated.

--stdoutmsglevel prio

--stderrmsglevel prio

--logmsglevel prio

Définir la priorité minimale pour les messages journalisés dans syslog/journal et dans la console respectivement. Les valeurs possibles sont trace, debug, info, warn, err et fatal. Les messages dont la priorité est définie ici ou est supérieure sont affichés dans le média respectif. Les messages affichés dans stderr ne sont pas répétés dans stdout. Cela permet à l’administrateur local de contrôler la prolixité de adduser dans la console et dans le journal de manière indépendante, conservant pour lui-même des informations probablement peu claires tout en laissant des informations utiles dans le journal. stdoutmsglevel, stderrmsglevel et logmsglevel ont comme valeur par défaut warn, warn et info, respectivement.

-v , --version

Afficher la version et le copyright.

NOMS AUTORISÉS¶

Historiquement, adduser(8) et addgroup(8) imposent la conformité à la norme IEEE Std 1003.1-2001 qui ne permet que les caractères suivants dans les noms de groupe ou d'utilisateur : lettres, chiffres, tirets de soulignement (_), points, arobases (@) et signe moins (-). Le nom ne peut commencer par un signe moins ou @. Le signe « $ » est autorisé à la fin des noms d'utilisateur pour autoriser les comptes typiques de machine Samba.

Les réglages par défaut pour NAME_REGEX et SYS_NAME_REGEX permettent aux noms d’utilisateur de contenir des lettres, des chiffres, des tirets (-), des tirets de soulignement (_). Le nom doit commencer par une lettre (ou un trait de soulignement pour les utilisateurs système).

La politique la moins restrictive, disponible en utilisant l’option --allow-all-names, fait simplement les mêmes vérifications que useradd(8). Veuillez noter que les vérifications d’useradd sont devenues un peu plus restrictives dans Debian 13.

Modifier le comportement par défaut présente le risque de créer des noms peu clairs ou trompeurs. À utiliser avec précaution.

JOURNALISATION¶

adduser utilise une journalisation complète et configurable pour adapter sa verbosité aux besoins de l’administrateur du système.

Every message that adduser prints has a priority value assigned by the authors. This priority can not be changed at run time. Available priority values are fatal, error, warn, info, debug, and trace.

Si vous estimez qu’un message n’a pas la bonne priorité, veuillez faire un rapport de bogue.

À chaque création de message, le code décide d’afficher celui-ci sur la sortie standard, la sortie d’erreur ou syslog. Cela est principalement et indépendamment contrôlé par les réglages de configuration STDOUTMSGLEVEL, STDERRMSGLEVEL et LOGMSGLEVEL. Pour des besoins de test, ces réglages peuvent être outrepassés sur la ligne de commande.

Seuls les messages ayant une priorité égale ou supérieure au niveau respectif de message sont journalisés sur le média de sortie respectif. Un message écrit sur la sortie d’erreur n’est pas écrit une seconde fois sur la sortie standard.

VALEURS DE RETOUR¶

0

Succès : l'utilisateur ou le groupe existe tel qu'il a été demandé. Cela peut avoir deux causes : l'utilisateur ou le groupe a été créé par cet appel à adduser ou l'utilisateur ou le groupe était déjà présent sur le système lors de l'appel à adduser. Si adduser --system est invoqué pour un utilisateur déjà existant ayant les attributs requis ou compatibles, 0 sera aussi renvoyé.

11

L’objet qu’il est demandé à adduser de créer existe déjà.

12

L’objet qu’il est demandé à adduser ou deluser de gérer n’existe pas.

13

L’objet qu’il est demandé à adduser ou deluser de gérer n’a pas les propriétés nécessaires pour terminer l’opération : un utilisateur (un groupe) qu’il est demandé de créer comme utilisateur (groupe) système existe déjà et n’est pas un utilisateur (groupe) système, ou un utilisateur (groupe) qu’il est demandé de créer avec un certain UID (GID) existe déjà et possède un UID (GID) différent, ou un utilisateur (groupe) système qu’il est demandé de supprimer existe, mais n’est pas un utilisateur (groupe) système.

21

L’UID (GID) demandé explicitement pour un nouvel utilisateur (groupe) est déjà utilisé.

22

Aucun UID (GID) n’est disponible dans la plage indiquée.

23

Aucun groupe ayant le GID demandé n’existe pour le groupe primaire pour un nouvel utilisateur.

31

The chosen name or comment for a new user or a new group does not conform to the selected naming rules.

32

Le répertoire personnel du nouvel utilisateur doit être un chemin absolu.

33

useradd renvoie le code 19 « invalid user or group name ». Cela signifie que le nom d’utilisateur ou de groupe choisi ne correspond pas aux restrictions d’useradd et adduser ne peut pas créer l’utilisateur.

41

Le groupe qu’il est demandé de supprimer n’est pas vide.

42

L’utilisateur qu’il est demandé de retirer d’un groupe n’est pas du tout un membre.

43

Impossible de retirer un utilisateur de son groupe primaire ou aucun groupe primaire n’a été sélectionné pour un nouvel utilisateur par n’importe quelle méthode.

51

Nombre ou ordre incorrect des paramètres de la ligne de commande détecté.

52

Options incompatibles définies dans le fichier de configuration.

53

Options de ligne de commande mutuellement incompatibles détectées.

54

adduser et deluser invoquées en tant que non-administrateur et par conséquent ne peuvent être utilisées.

55

deluser refusera de supprimer le compte du superutilisateur.

56

Une fonction a été demandée qui nécessite l’installation de paquets supplémentaires. Consulter Recommends: et Suggests: du paquet adduser.

61

adduser a échoué pour une raison quelconque et a essayé de revenir sur les modifications faites durant l’exécution.

62

Erreur interne à adduser. Cela ne devrait pas se produire. Merci d’essayer de reproduire le phénomène et d’envoyer un rapport de bogue.

71

Erreur lors de la création ou de la gestion du verrou.

72

Erreur lors de l’accès au(x) fichier(s) de configuration.

73

Erreur lors de l’accès au fichier « pool ».

74

Erreur lors de la lecture d’un fichier « pool », erreur de syntaxe dans le fichier.

75

Erreur lors de l’accès aux fichiers auxiliaires.

81

An executable that is needed by adduser or deluser cannot be found. Check your installation and dependencies.

82

L’exécution d’une commande externe a renvoyé une erreur inattendue.

83

Un signal a mis fin à une commande externe.

84

Un appel système s’est terminé avec une erreur inattendue.

Ou pour plein d'autres raisons pas encore documentées qui sont affichées sur la console. Vous pouvez alors accroître le niveau de journalisation pour rendre adduser plus bavard.

SÉCURITɶ

adduser a besoin des privilèges du superutilisateur et propose, à l’aide de l’option de ligne de commande --conf, d’utiliser un fichier de configuration différent. Il ne faut pas utiliser sudo(8) ou des outils similaires pour donner des privilèges partiels à adduser avec des paramètres restrictifs de ligne de commande. Cela est facile à contourner et pourrait permettre de créer des comptes arbitraires. Si vous voulez cela, écrivez votre propre script d’enveloppe en fournissant les privilèges pour exécuter ce script.

FICHIERS¶

/etc/adduser.conf

Fichier de configuration par défaut d'adduser(8) et addgroup(8).

/usr/local/sbin/adduser.local

Extensions personnelles facultatives. Consulter adduser.local(8).

NOTES¶

Malheureusement, le terme compte système (« system account ») souffre d’un double emploi dans Debian. Il signifie un compte pour le système Debian réel, distinct d'un compte d’application qui peut exister dans la base de données d’utilisateurs de quelques applications fonctionnant dans Debian. Un compte système dans cette définition a le pouvoir de se connecter sur le système réel, possède un UID, peut être membre de groupes système, peut avoir ses propres fichiers et processus. La Charte Debian, dans son chapitre 9.2.2, fait une distinction entre les utilisateurs et groupes système dynamiquement alloués et les comptes d’utilisateur dynamiquement alloués, signifiant dans les deux cas des instances spéciales de comptes système. Une attention spéciale doit être apportée pour ne pas faire de confusion de terminologie. Puisque adduser et deluser(8) ne s’adressent jamais aux comptes d’application et que toute chose dans ce paquet concerne ici les comptes système, l’utilisation des termes compte utilisateur et compte système n’est réellement pas ambigu dans le contexte de ce paquet. Pour la clarté, ce document utilise la définition compte ou groupe système local si la distinction pour comptes d’application ou comptes dans un service d’annuaire est nécessaire.

adduser avait l’idée d’être le frontal universel pour les différents services d’annuaire pour la création et la suppression des comptes normaux et système dans Debian depuis les années 1990. Cette idée a été en abandonnée en 2022. Les raisons pour cela sont que de toutes façons, en pratique, un petit système serveur ne va pas avoir de droit d’écriture pour un service d’annuaire englobant toute l’entreprise, que les paquets installés localement sont durs à gérer avec les comptes système contrôlés de manière centrale, que les services d’annuaire d’entreprise ont leurs propres processus de gestion et qu’il est peu probable que la personne en charge de adduser soit assez puissante pour écrire ou gérer la pléthore de services d’annuaire qui ont besoin d’une prise en charge.

adduser se limitera à être une couche de mise en conformité pour la gestion de comptes système locaux, en utilisant les outils du paquet passwd pour le travail réel.

Group membership changes do not affect processes that are already running. When a user is added to a group, the new membership becomes effective only for sessions started after the change. This behavior is a common source of confusion for administrators who expect the results of adduser user group to apply immediately to existing sessions.

To make the new group membership available immediately, the user must start a new login session. Alternatively, the newgrp(1) command can be used to start a new shell with the updated group membership.

This behavior is a fundamental property of Unix-like operating systems and cannot be altered by adduser.

BOGUES¶

L’utilisation non cohérente de terminologie autour du terme compte système dans la documentation et le code est un bogue. Merci de rapporter cela et nous permettre d’améliorer cette documentation.

adduser fait bien attention d’être directement utilisable dans les scripts des responsables de Debian, sans enveloppe conditionnelle, ni de suppression d’erreurs ou autres échafaudages. La seule chose dont le responsable de paquet devrait avoir besoin pour coder est une vérification de la présence de l’exécutable dans le script postrm. Les responsables d’adduser considèrent que le besoin d’échafaudage est un bogue et encouragent les responsables de paquets concernés de Debian à déclarer un bogue à l’encontre du paquet adduser dans ce cas.

VOIR AUSSI¶

adduser.conf(5), deluser(8), groupadd(8), useradd(8), usermod(8), /usr/share/doc/base-passwd/users-and-groups.html sur n’importe quel système Debian, Debian Policy 9.2.2, RFC8264 « PRECIS Framework : Preparation, Enforcement, and Comparison of Internationalized Strings in Application Protocols », RFC8265 « PRECIS Representing Usernames and Passwords", https://wiki.debian.org/UserAccounts.

TRADUCTION¶

Ce document est une traduction réalisée par Christophe Sauthier <christophe@sauthier.com>(2002), reprise avec po4a par Nicolas FRANÇOIS (2004-2008) et mise à jour par David Prévot <david@tilapin.org> (2010) et Jean-Paul Guillonneau <guillonneau.jeanpaul@free.fr> (2016-2025).

L'équipe de traduction a fait le maximum pour réaliser une adaptation française de qualité.

La version anglaise de ce document est toujours consultable en ajoutant l'option « -L C » à la commande man.

N'hésitez pas à signaler à l'auteur ou à la liste de traduction <debian-l10n-french@lists.debian.org>, selon le cas, toute erreur dans cette page de manuel.