groupmod(1m)

1groupmod(1M)            System Administration Commands            groupmod(1M)
2
3
4

NAME

6       groupmod - modify a group definition on the system
7

SYNOPSIS

9       /usr/sbin/groupmod [-g gid [-o]] [-n name] group
10
11

DESCRIPTION

13       The  groupmod command modifies the definition of the specified group by
14       modifying the appropriate entry in the /etc/group file.
15

OPTIONS

17       The following options are supported:
18
19       -g gid     Specify the new group ID for the group. This group  ID  must
20                  be  a  non-negative  decimal  integer  less  than MAXUID, as
21                  defined in <param.h>. The group  ID  defaults  to  the  next
22                  available (unique) number above 99. (Group IDs from 0-99 are
23                  reserved by SunOS for future applications.)
24
25
26       -n name    Specify the new name for the group.  The name argument is  a
27                  string  of no more than eight bytes consisting of characters
28                  from the set of lower case alphabetic characters and numeric
29                  characters.   A  warning  message  will  be written if these
30                  restrictions are not met.   A  future  Solaris  release  may
31                  refuse  to  accept  group  fields  that  do  not  meet these
32                  requirements.  The name argument must contain at  least  one
33                  character and must not include a colon (:) or NEWLINE (\n).
34
35
36       -o         Allow the gid to be duplicated (non-unique).
37
38

OPERANDS

40       The following operands are supported:
41
42       group    An existing group name to be modified.
43
44

EXIT STATUS

46       The groupmod utility exits with one of the following values:
47
48       0     Success.
49
50
51       2     Invalid  command syntax. A usage message for the groupmod command
52             is displayed.
53
54
55       3     An invalid argument was provided to an option.
56
57
58       4     gid is not unique (when the -o option is not used).
59
60
61       6     group does not exist.
62
63
64       9     name already exists as a group name.
65
66
67       10    Cannot update the /etc/group file.
68
69

FILES

71       /etc/group    group file
72
73

ATTRIBUTES

75       See attributes(5) for descriptions of the following attributes:
76
77
78
79
80       ┌─────────────────────────────┬─────────────────────────────┐
81       │      ATTRIBUTE TYPE         │      ATTRIBUTE VALUE        │
82       ├─────────────────────────────┼─────────────────────────────┤
83       │Availability                 │SUNWcsu                      │
84       └─────────────────────────────┴─────────────────────────────┘
85

NOTES

91       The  groupmod utility only modifies group definitions in the /etc/group
92       file. If a network name service such as NIS or NIS+ is  being  used  to
93       supplement  the local /etc/group file with additional entries, groupmod
94       cannot change information supplied by the  network  name  service.  The
95       groupmod utility will, however, verify the uniqueness of group name and
96       group ID against the external name service.
97
98
99       groupmod fails if a group entry (a single line in  /etc/group)  exceeds
100       2047 characters.
101
102
103
104SunOS 5.11                        27 Aug 2008                     groupmod(1M)