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: 27 Aug 2008                    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


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



     
           ATRIBUTE TYPE               ATRIBUTE VALUE       
    
     Availability                 SUNWcsu                     
    


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 or
     NIS] is being used to supplement the local  /etc/group  file
     with  additional entries, groupmod cannot change information
     supplied 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: 27 Aug 2008                    2