Manual Pages for UNIX Operating System command usage for man groupmod

System Administration Commands                       groupmod(1M)



NAME
     groupmod - modify a group definition on the system

SYNOPSIS
     /usr/sbin/groupmod [-g gid [-o]] [-n name] group


DESCRIPTION
     The groupmod command modifies the definition of  the  speci-
     fied  group  by  modifying  the  appropriate  entry  in  the
     /etc/group file.

OPTIONS
     The following options are supported:

     -g gid     Specify the new group  ID  for  the  group.  This
                group  ID  must be a non-negative decimal integer
                less than MAXUID, as defined  in  .  The
                group  ID defaults to the next available (unique)
                number  above  99.  (Group  IDs  from  0-99   are
                reserved by SunOS for future applications.)


     -n name    Specify the new name for  the  group.   The  name
                argument  is a string of no more than eight bytes
                consisting of characters from the  set  of  lower
                case  alphabetic  characters  and numeric charac-
                ters.  A warning message will be written if these
                restrictions  are  not  met.   A  future  Solaris
                release may refuse to accept group fields that do
                not  meet  these requirements.  The name argument
                must contain at least one character and must  not
                include a colon (:) or NEWLINE (\n).


     -o         Allow the gid to be duplicated (non-unique).


OPERANDS
     The following operands are supported:

     group    An existing group name to be modified.


EXIT STATUS
     The groupmod utility exits with one of the following values:

     0     Success.


     2     Invalid command syntax. A usage message for the group-
           mod command is displayed.



SunOS 5.11          Last change: 11 Dec 2009                    1






System Administration Commands                       groupmod(1M)



     3     An invalid argument was provided to an option.


     4     gid is not unique (when the -o option is not used).


     6     group does not exist.


     9     name already exists as a group name.


     10    Cannot update the /etc/group file.


FILES
     /etc/group    group file


ATTRIBUTES
     See attributes(5) for descriptions of the  following  attri-
     butes:



     ____________________________________________________________
    |       ATTRIBUTE TYPE        |       ATTRIBUTE VALUE       |
    |_____________________________|_____________________________|
    | Availability                | SUNWcs                      |
    |_____________________________|_____________________________|


SEE ALSO
     users(1B),    groupadd(1M),    groupdel(1M),     logins(1M),
     useradd(1M),   userdel(1M),  usermod(1M),  group(4),  attri-
     butes(5)

NOTES
     The groupmod utility only modifies group definitions in  the
     /etc/group  file.  If  a network name service such as NIS is
     being used to supplement  the  local  /etc/group  file  with
     additional  entries, groupmod cannot change information sup-
     plied by the network  name  service.  The  groupmod  utility
     will, however, verify the uniqueness of group name and group
     ID against the external name service.


     groupmod  fails  if  a  group  entry  (a  single   line   in
     /etc/group) exceeds 2047 characters.






SunOS 5.11          Last change: 11 Dec 2009                    2