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

Synonyme de --stdoutmsglevel=debug. Obsolète.

--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

Ignorer le premier UID, le dernier UID, le premier GID et le dernier GID de l’intervalle dans lequel l’UID est choisi (FIRST_UID, LAST_UID, FIRST_GID et LAST_GID, FIRST_SYSTEM_UID, LAST_SYSTEM_UID, FIRST_SYSTEM_GID et LAST_SYSTEM_GID dans le fichier de configuration). Si un groupe est créé comme groupe d’utilisateurs, --firstgid et --lastgid sont ignorés. Le groupe obtient le même UID que l’utilisateur. Modes autorisés : adduser, adduser --system, pour --firstgid et --lastgid aussi pour 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

Lorsqu'un groupe est créé, cette option permet de définir le numéro d’ID du nouveau groupe à ̣GID. Lorsqu'un utilisateur est créé, cette option définit le numéro d’ID de groupe primaire du nouvel utilisateur à GID. Modes autorisés : 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

Lors de la création d’un utilisateur, cette option règle le numéro d’ID de groupe primaire du nouvel utilisateur au GID du groupe indiqué. Au contraire de l’option --gid, ce groupe est spécifié ici par son nom plutôt que son numéro d’ID. Le groupe doit déjà exister. Modes autorisés : 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.

--quiet

Synonyme pour --stdoutmsglevel=warn. Obsolète.

--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

Synonyme de --stdoutmsglevel=info. Obsolète.

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

Chaque message affiché par adduser a une valeur de priorité assignée par les auteurs. Elle ne peut pas être changée au moment de l’exécution. Les priorités disponibles sont crit, error, warning, info, debug et 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

Le nom choisi pour le nouvel utilisateur ou pour le nouveau groupe n’est pas conforme aux règles de nommage sélectionnées.

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

Un exécutable nécessaire pour adduser ou deluser n’a pu être trouvé. Vérifier l’installation et les dépendances.

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.

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.