Hallo, dies ist ein Test.

PWD: /www/data-lst1/unixsoft/unixsoft/kaempfer/.public_html

Running in File Mode
Relative path: ./../../../../.././../usr/man/man8/groupmod.8
Real path: /usr/share/man/man8/groupmod.8
Zurück

'\" te
.\" Copyright (c) 1997, 2021, Oracle and/or its affiliates.
.\" Copyright (c) 1989, AT&T. All rights reserved.
.TH groupmod 8 "11 May 2021" "Oracle Solaris 11.4" "System Administration Commands"
.SH NAME
groupmod \- modify a group definition on the system
.SH SYNOPSIS

.LP
.nf
\fB/usr/sbin/groupmod\fR [\fB-S\fR \fIrepository\fR] [\fB-g\fR \fIgid\fR [\fB-o\fR]] [\fB-n\fR \fIname\fR]
     [\fB-U\fR [+|-]\fIuser1\fR[,\fIuser2\fR]...] \fIgroup\fR
.fi
.SH DESCRIPTION
.sp
.LP
The \fBgroupmod\fR command modifies the definition of the specified group by modifying the appropriate entry in the group database in the repository.
.sp
.LP
An administrator can modify any group for which it has a matching authorization of the form \fBsolaris.group.assign\fR/\fIgroupname\fR. This authorization is automatically assigned to the administrator who created the group. An administrator must have \fBsolaris.group.assign\fR authorization to modify all other groups.
.SH OPTIONS
.sp
.LP
The following options are supported:
.sp
.ne 2
.mk
.na
\fB\fB-g\fR \fIgid\fR\fR
.ad
.br
.sp .6
.RS 4n
Specify the new group \fBID\fR for the group. This group \fBID\fR must be a non-negative decimal integer less than \fBMAXUID\fR, as defined in \fB<param.h>\fR. The group \fBID\fR defaults to the next available (unique) number above 99. (Group IDs from 0-99 are reserved by Oracle Solaris for future applications.)
.RE

.sp
.ne 2
.mk
.na
\fB\fB-n\fR \fIname\fR\fR
.ad
.br
.sp .6
.RS 4n
Specify the new name for the group. The \fIname\fR argument is a string of no more than 32 bytes consisting of characters from the set of ASCII lowercase alphabetic characters and numeric characters. A warning message will be written if these restrictions are not met. A future Oracle Solaris release may refuse to accept group fields that do not meet these requirements. The \fIname\fR argument must contain at least one character and must not include a colon (\fB:\fR) or \fBNEWLINE\fR (\fB\en\fR).
.RE

.sp
.ne 2
.mk
.na
\fB\fB-o\fR\fR
.ad
.br
.sp .6
.RS 4n
Allow the \fIgid\fR to be duplicated (non-unique). An administrator must have solaris.group.assign authorization to use this option.
.RE

.sp
.ne 2
.mk
.na
\fB\fB-S\fR \fIrepository\fR\fR
.ad
.br
.sp .6
.RS 4n
The \fIrepository\fR specifies which name service will be updated. The valid repositories are \fBfiles\fR and \fBldap\fR. The default repository is \fBfiles\fR. When the repository is \fBfiles\fR, the user names can be present in other name service repositories and can be assigned to a group in the \fBfiles\fR repository. When the repository is \fBldap\fR, all the assignable attributes must be present in the \fBldap\fR repository, and both the LDAP server and client must be configured with \fBenableShadowUpdate\fR. See \fBldapclient\fR(8) for details.
.RE

.sp
.ne 2
.mk
.na
\fB\fB-U\fR [+|-]\fIuser1\fR[,\fIuser2\fR]\fR
.ad
.br
.sp .6
.RS 4n
Updates the list of users for the group as follows:
.RS +4
.TP
.ie t \(bu
.el o
A prefix \fB+\fR before the list adds that list to existing users list.

.RE
.RS +4
.TP
.ie t \(bu
.el o
A prefix \fB-\fR before the list removes each user in the list from the existing users list.

.RE
.RS +4
.TP
.ie t \(bu
.el o
With no prefix before the list, replaces the existing users list with the new list of users specified.

.RE
.RE

.SH OPERANDS
.sp
.LP
The following operands are supported:
.sp
.ne 2
.mk
.na
\fB\fIgroup\fR\fR
.ad
.RS 9n
.rt
An existing group name to be modified.
.RE

.SH EXIT STATUS
.sp
.LP
The \fBgroupmod\fR utility exits with one of the following values:
.sp
.ne 2
.mk
.na
\fB\fB0\fR\fR
.ad
.RS 6n
.rt
Success.
.RE

.sp
.ne 2
.mk
.na
\fB\fB2\fR\fR
.ad
.RS 6n
.rt
Invalid command syntax. A usage message for the \fBgroupmod\fR command is displayed.
.RE

.sp
.ne 2
.mk
.na
\fB\fB3\fR\fR
.ad
.RS 6n
.rt
An invalid argument was provided to an option.
.RE

.sp
.ne 2
.mk
.na
\fB\fB4\fR\fR
.ad
.RS 6n
.rt
\fIgid\fR is not unique (when the \fB-o\fR option is not used).
.RE

.sp
.ne 2
.mk
.na
\fB\fB6\fR\fR
.ad
.RS 6n
.rt
\fIgroup\fR does not exist.
.RE

.sp
.ne 2
.mk
.na
\fB\fB9\fR\fR
.ad
.RS 6n
.rt
\fIname\fR already exists as a group name.
.RE

.sp
.ne 2
.mk
.na
\fB\fB10\fR\fR
.ad
.RS 6n
.rt
Cannot update the \fB/etc/group\fR file.
.RE

.SH FILES
.sp
.ne 2
.mk
.na
\fB\fB/etc/group\fR\fR
.ad
.RS 14n
.rt
group file
.RE

.SH ATTRIBUTES
.sp
.LP
See \fBattributes\fR(7) for descriptions of the following attributes:
.sp
.TS
tab(
) box;
cw(2.75i) |cw(2.75i) 
lw(2.75i) |lw(2.75i) 
.
ATTRIBUTE TYPE
ATTRIBUTE VALUE
_
Availability
system/core-os
.TE
.sp
.SH SEE ALSO
.sp
.LP
\fBgroup\fR(5), \fBattributes\fR(7), \fBgroupadd\fR(8), \fBgroupdel\fR(8), \fBlogins\fR(8), \fBuseradd\fR(8), \fBuserdel\fR(8), \fBusermod\fR(8)
.SH NOTES
.sp
.LP
The \fBgroupmod\fR utility modifies group definitions in the group database in the repository. If a network name service is being used to supplement the local \fB/etc/group\fR file with additional entries, \fBgroupmod\fR verifies the uniqueness of a specified group name and group \fBID\fR against the external name service and uses the entries in the \fBfiles\fR repository. The group name should be restricted to the Portable Filename Characters: \fBA-Z\fR, \fBa-z\fR, \fB0-9\fR, '\fB_\fR', '\fB-\fR', and '\fB.\fR'.
.sp
.LP
\fBgroupmod\fR fails if a group entry (a single line in \fB/etc/group\fR) exceeds 2047 characters.