diff options
Diffstat (limited to 'man/man8/groupadd.8')
-rw-r--r-- | man/man8/groupadd.8 | 45 |
1 files changed, 26 insertions, 19 deletions
diff --git a/man/man8/groupadd.8 b/man/man8/groupadd.8 index 370ddaae..a2df2503 100644 --- a/man/man8/groupadd.8 +++ b/man/man8/groupadd.8 @@ -1,13 +1,13 @@ '\" t .\" Title: groupadd .\" Author: Julianne Frances Haugh -.\" Generator: DocBook XSL Stylesheets v1.79.1 <http://docbook.sf.net/> -.\" Date: 01/02/2022 +.\" Generator: DocBook XSL Stylesheets vsnapshot <http://docbook.sf.net/> +.\" Date: 08/18/2022 .\" Manual: System Management Commands -.\" Source: shadow-utils 4.11.1 +.\" Source: shadow-utils 4.12.2 .\" Language: English .\" -.TH "GROUPADD" "8" "01/02/2022" "shadow\-utils 4\&.11\&.1" "System Management Commands" +.TH "GROUPADD" "8" "08/18/2022" "shadow\-utils 4\&.12\&.2" "System Management Commands" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -31,12 +31,16 @@ groupadd \- create a new group .SH "SYNOPSIS" .HP \w'\fBgroupadd\fR\ 'u -\fBgroupadd\fR [\fIoptions\fR] \fIgroup\fR +\fBgroupadd\fR [\fIOPTIONS\fR] \fINEWGROUP\fR .SH "DESCRIPTION" .PP The \fBgroupadd\fR 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\&. +.PP +Groupnames must start 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_\-]*[$]? +.PP +Groupnames may only be up to 32 characters long\&. .SH "OPTIONS" .PP The options which apply to the @@ -53,7 +57,9 @@ is turned off)\&. .PP \fB\-g\fR, \fB\-\-gid\fR\ \&\fIGID\fR .RS 4 -The numerical value of the group\*(Aqs ID\&. This value must be unique, unless the +The numerical value of the group\*(Aqs ID\&. +\fIGID\fR +must be unique, unless the \fB\-o\fR option is used\&. The value must be non\-negative\&. The default is to use the smallest ID value greater than or equal to \fBGID_MIN\fR @@ -90,13 +96,21 @@ doesn\*(Aqt work yet\&. .PP \fB\-o\fR, \fB\-\-non\-unique\fR .RS 4 -This option permits to add a group with a non\-unique GID\&. +permits the creation of a group with an already used numerical ID\&. As a result, for this +\fIGID\fR, the mapping towards group +\fINEWGROUP\fR +may not be unique\&. .RE .PP \fB\-p\fR, \fB\-\-password\fR\ \&\fIPASSWORD\fR .RS 4 -The encrypted password, as returned by -\fBcrypt\fR(3)\&. The default is to disable the password\&. +defines an initial password for the group account\&. PASSWORD is expected to be encrypted, as returned by +\fBcrypt \fR(3)\&. +.sp +Without this option, the group account will be locked and with no password defined, i\&.e\&. a single exclamation mark in the respective field of ths system account file +/etc/group +or +/etc/gshadow\&. .sp \fBNote:\fR This option is not recommended because the password (or encrypted password) will be visible by users listing the processes\&. @@ -121,16 +135,13 @@ Apply changes in the \fICHROOT_DIR\fR directory and use the configuration files from the \fICHROOT_DIR\fR -directory\&. +directory\&. Only absolute paths are supported\&. .RE .PP \fB\-P\fR, \fB\-\-prefix\fR\ \&\fIPREFIX_DIR\fR .RS 4 -Apply changes in the -\fIPREFIX_DIR\fR -directory and use the configuration files from the -\fIPREFIX_DIR\fR -directory\&. This option does not chroot and is intended for preparing a cross\-compilation target\&. Some limitations: NIS and LDAP users/groups are not verified\&. PAM authentication is using the host files\&. No SELINUX support\&. +Apply changes to configuration files under the root filesystem found under the directory +\fIPREFIX_DIR\fR\&. This option does not chroot and is intended for preparing a cross\-compilation target\&. Some limitations: NIS and LDAP users/groups are not verified\&. PAM authentication is using the host files\&. No SELINUX support\&. .RE .PP \fB\-U\fR, \fB\-\-users\fR @@ -211,10 +222,6 @@ Shadow password suite configuration\&. .RE .SH "CAVEATS" .PP -Groupnames must start 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_\-]*[$]? -.PP -Groupnames may only be up to 16 characters long\&. -.PP You may not add a NIS or LDAP group\&. This must be performed on the corresponding server\&. .PP If the groupname already exists in an external group database such as NIS or LDAP, |