93 lines
2.4 KiB
Groff
93 lines
2.4 KiB
Groff
.\" ** You probably do not want to edit this file directly **
|
|
.\" It was generated using the DocBook XSL Stylesheets (version 1.69.0).
|
|
.\" Instead of manually editing it, you probably should edit the DocBook XML
|
|
.\" source for it and then use the DocBook XSL Stylesheets to regenerate it.
|
|
.TH "GROUPADD" "8" "08/03/2005" "" ""
|
|
.\" disable hyphenation
|
|
.nh
|
|
.\" disable justification (adjust text to left margin only)
|
|
.ad l
|
|
.SH "NAME"
|
|
groupadd \- Create a new group
|
|
.SH "SYNOPSIS"
|
|
.HP 9
|
|
\fBgroupadd\fR [\-g\ \fIgid\fR\ [\-o\ ]] [\-f] [\-K\ \fIKEY\fR=\fIVALUE\fR] \fIgroup\fR
|
|
.SH "DESCRIPTION"
|
|
.PP
|
|
The
|
|
\fBgroupadd\fR
|
|
command creates a new group account using the values specified on the command line and the default values from the system. The new group will be entered into the system files as needed.
|
|
.SH "OPTIONS"
|
|
.PP
|
|
The options which apply to the
|
|
\fBgroupadd\fR
|
|
command are:
|
|
.TP
|
|
\fB\-f\fR
|
|
This option causes to just exit with success status if the specified group already exists. With
|
|
\fB\-g\fR, if specified gid already exists, other (unique) gid is chosen (i.e.
|
|
\fB\-g\fR
|
|
is turned off).
|
|
.TP
|
|
\fB\-g\fR \fIgid\fR
|
|
The numerical value of the group's ID. This value 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 999 and greater than every other group. Values between 0 and 999 are typically reserved for system accounts.
|
|
.TP
|
|
\fB\-K \fR\fB\fIKEY\fR\fR\fB=\fR\fB\fIVALUE\fR\fR
|
|
Overrides /etc/login.defs defaults (GID_MIN, GID_MAX and others). Multiple
|
|
\fB\-K\fR
|
|
options can be specified, e.g.:
|
|
\fB\-K\fR \fIGID_MIN\fR=\fI100\fR \fB\-K\fR \fIGID_MAX\fR=\fI499\fR
|
|
|
|
Note:
|
|
\fB\-K\fR \fIGID_MIN\fR=\fI10\fR,\fIGID_MAX\fR=\fI499\fR
|
|
doesn't work yet.
|
|
.TP
|
|
\fB\-o\fR
|
|
Allow add group wit non\-unique GID.
|
|
.SH "FILES"
|
|
.TP
|
|
\fI/etc/group\fR
|
|
group account information
|
|
.TP
|
|
\fI/etc/gshadow\fR
|
|
secure group account information
|
|
.SH "EXIT VALUES"
|
|
.PP
|
|
The
|
|
\fBgroupadd\fR
|
|
command exits with the following values:
|
|
.TP
|
|
\fI0\fR
|
|
success
|
|
.TP
|
|
\fI2\fR
|
|
invalid command syntax
|
|
.TP
|
|
\fI3\fR
|
|
invalid argument to option
|
|
.TP
|
|
\fI4\fR
|
|
gid not unique (when \-o not used)
|
|
.TP
|
|
\fI9\fR
|
|
group name not unique
|
|
.TP
|
|
\fI10\fR
|
|
can't update group file
|
|
.SH "SEE ALSO"
|
|
.PP
|
|
\fBchfn\fR(1),
|
|
\fBchsh\fR(1),
|
|
\fBpasswd\fR(1),
|
|
\fBgpasswd\fR(8),
|
|
\fBgroupdel\fR(8),
|
|
\fBgroupmod\fR(8),
|
|
\fBuseradd\fR(8),
|
|
\fBuserdel\fR(8),
|
|
\fBusermod\fR(8)
|
|
.SH "AUTHOR"
|
|
.PP
|
|
Julianne Frances Haugh (jockgrrl@ix.netcom.com)
|