NAME

       groupadd - erstellt eine neue Gruppe

ÜBERSICHT

       groupadd [Optionen] Gruppe

BESCHREIBUNG

       Der Befehl groupadd erstellt ein neues Gruppenkonto. Dabei verwendet er die Werte, die auf
       der Befehlszeile angegeben wurden, oder die Standardwerte des Systems. Soweit es notwendig
       ist, wird die neue Gruppe den Systemdateien hinzugefügt.

OPTIONEN

       Die Optionen, die vom Befehl groupadd unterstützt werden, sind:

       -f, --force
           Die Option führt dazu, dass der Befehl nur dann erfolgreich beendet wird, wenn die
           angegebene Gruppe existiert. Falls diese Option zusammen mit der Option -g verwendet
           wird und die angegebene GID schon vergeben ist, wird eine andere, eindeutige GID
           gewählt (d.h. -g wird nicht beachtet).

       -g, --gid GID
           Der zahlenmäßige Wert der Gruppen-ID. Dieser Wert muss eindeutig sein, sofern nicht
           die Option -o verwendet wird. Der Wert darf nicht negativ sein. Standardmäßig wird der
           kleinste Wert größer als oder gleich GID_MIN und größer als jeder andere Wert einer
           Gruppe verwendet.

           Vergleichen Sie auch die Option -r und die Ausführungen zu GID_MAX.

       -h, --help
           zeigt die Hilfe an und beendet das Programm

       -K, --key SCHLÜSSEL=WERT
           Überschreibt die Standardwerte von /etc/login.defs (GID_MIN, GID_MAX und weitere).
           Diese Option kann mehrfach verwendet werden.

           Beispiel: -K GID_MIN=100 -K GID_MAX=499

           Hinweis: -K GID_MIN=10,GID_MAX=499 funktioniert noch nicht.

       -o, --non-unique
           Diese Option erlaubt es, eine Gruppe mit einer nicht eindeutigen GID zu erstellen.

       -p, --password PASSWORT
           Das verschlüsselte Passwort, wie es von crypt(3) zurückgegeben wird. Standardmäßig ist
           das Passwort deaktiviert.

           Hinweis: Diese Option ist nicht empfehlenswert, weil das Passwort (auch wenn es
           verschlüsselt ist) für Benutzer sichtbar ist, die sich den Prozess anzeigen lassen.

           Sie sollten sicherstellen, dass das Passwort den Passwortrichtlinien des Systems
           entspricht.

       -r, --system
           erstellt eine neue Systemgruppe

           Die zahlenmäßige Kennung einer neuen Systemgruppe wird aus der Spanne von SYS_GID_MIN
           bis SYS_GID_MAX gewählt, welche in login.defs festgelegt wird, anstelle von GID_MIN
           bis GID_MAX.

       -R, --root CHROOT_VERZ
           führt die Veränderungen in dem Verzeichnis CHROOT_VERZ durch und verwendet die
           Konfigurationsdateien aus dem Verzeichnis CHROOT_VERZ

KONFIGURATION

       Die folgenden Konfigurationsvariablen in /etc/login.defs beeinflussen das Verhalten dieses
       Werkzeugs:

       GID_MAX (Zahl), GID_MIN (Zahl)
           der Bereich von Gruppen-IDs, aus dem die Programme useradd, groupadd oder newusers bei
           der Erstellung normaler Gruppen auswählen dürfen

           Der Standardwert für GID_MIN ist 1000, für GID_MAX 60.000.

       MAX_MEMBERS_PER_GROUP (Zahl)
           Maximale Anzahl von Mitgliedern je Gruppeneintrag. Wenn das Maximum erreicht wird,
           wird ein weiterer Eintrag in /etc/group (mit dem gleichen Namen, dem gleichen Passwort
           und der gleichen GID) erstellt.

           Der Standardwert ist 0, was zur Folge hat, dass die Anzahl der Mitglieder einer Gruppe
           nicht begrenzt ist.

           Diese Fähigkeit (der aufgeteilten Gruppe) ermöglicht es, die Zeilenlänge in der
           Gruppendatei zu begrenzen. Damit kann sichergestellt werden, dass die Zeilen für
           NIS-Gruppen nicht länger als 1024 Zeichen sind.

           Falls Sie eine solche Begrenzung benötigen, können Sie 25 verwenden.

           Hinweis: Aufgeteilte Gruppen werden möglicherweise nicht von allen Werkzeugen
           unterstützt, selbst nicht aus der Shadow-Werkzeugsammlung. Sie sollten diese Variable
           nur setzen, falls Sie zwingend darauf angewiesen sind.

       SYS_GID_MAX (Zahl), SYS_GID_MIN (Zahl)
           der Bereich von Gruppen-IDs, aus dem die Programme useradd, groupadd oder newusers bei
           der Erstellung von Systemgruppen auswählen dürfen

           Der Standardwert für SYS_GID_MIN ist 101, für SYS_GID_MAX GID_MIN-1.

DATEIEN

       /etc/group
           Informationen zu den Gruppenkonten

       /etc/gshadow
           sichere Informationen zu den Gruppenkonten

       /etc/login.defs
           Konfiguration der Shadow-Passwort-Werkzeugsammlung

WARNUNGEN

       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_-]*[$]?

       On Debian, the only constraints are that groupnames 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.).

       Gruppennamen dürfen nur bis zu 32 Zeichen lang sein.

       Sie können einen Benutzer nicht einer NIS- oder LDAP-Gruppe hinzufügen. Dies müssen Sie
       auf dem entsprechenden Server durchführen.

       Falls der Gruppenname bereits in einer externen Datenbank (wie etwa NIS oder LDAP)
       vergeben ist, wird groupadd die Gruppe nicht erstellen.

RÜCKGABEWERTE

       Der Befehl groupadd gibt beim Beenden folgende Werte zurück:

       0
           Erfolg

       2
           unzulässige Syntax für diesen Befehl

       3
           ungültiges Argument für Option

       4
           GID nicht eindeutig (wenn -o nicht angegeben wird)

       9
           Gruppenname nicht eindeutig

       10
           Die Gruppendatei kann nicht aktualisieren werden.

SIEHE AUCH

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