groupmod man page on OpenIndiana

Man page or keyword search:  
man Server   20441 pages
apropos Keyword Search (all sections)
Output format
OpenIndiana logo
[printable version]

groupmod(1M)		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 specified 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 <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.)

       -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
		  characters.	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 groupmod 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.

FILES
       /etc/group    group file

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

       ┌─────────────────────────────┬─────────────────────────────┐
       │      ATTRIBUTE TYPE	     │	    ATTRIBUTE VALUE	   │
       ├─────────────────────────────┼─────────────────────────────┤
       │Availability		     │SUNWcs			   │
       └─────────────────────────────┴─────────────────────────────┘

SEE ALSO
       users(1B),   groupadd(1M),   groupdel(1M),   logins(1M),	  useradd(1M),
       userdel(1M), usermod(1M), group(4), attributes(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 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			  11 Dec 2009			  groupmod(1M)
[top]

List of man pages available for OpenIndiana

Copyright (c) for man pages and the logo by the respective OS vendor.

For those who want to learn more, the polarhome community provides shell access and support.

[legal] [privacy] [GNU] [policy] [cookies] [netiquette] [sponsors] [FAQ]
Tweet
Polarhome, production since 1999.
Member of Polarhome portal.
Based on Fawad Halim's script.
....................................................................
Vote for polarhome
Free Shell Accounts :: the biggest list on the net