solaris - groupmod (1)



NAME
     groupmod - modify a group definition on the system


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


AVAILABILITY
     SUNWcsu


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


OPTIONS
     -g gid
          The group id for the new group.  This group id must  be
          a  non-negative decimal integer below MAXUID as defined
          in < param.h >.  The group  ID  defaults  to  the  next
          available  (unique)  number  above 99.  (Group IDs from
          0-99 are reserved by SunOS for future applications.)

     -o    This option allows the  gid  to  be  duplicated  (non-
          unique).

     -n name
          A string of printable characters that specifies  a  new
          name  for the group.  It may not include a colon (:) or
          newline (\n).

     group
          The current name of the group to be modified.


FILES
     /etc/group


SEE ALSO
     users(1B),    groupadd(1M),    groupdel(1M),     logins(1M),
     useradd(1M), userdel(1M), usermod(1M)


DIAGNOSTICS
     The groupmod command exits with one of the following values:

     0    Success.

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

     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.


NOTES
     groupmod only modifies group definitions in  the  /etc/group
     file.  If a network nameservice 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  nameservice.   However  groupmod  will  verify  the
     uniqueness  of  group name and group id against the external
     nameservice.