Man page or keyword search:   man All Sections 1 - General Commands 2 - System Calls 3 - Subroutines, Functions 4 - Special Files 5 - File Formats 6 - Games and Screensavers 7 - Macros and Conventions 8 - Maintenence Commands 9 - Kernel Interface New Commands Server 4.4BSD AIX Alpinelinux Archlinux Aros BSDOS BSDi Bifrost CentOS Cygwin Darwin Debian DigitalUNIX DragonFly ElementaryOS Fedora FreeBSD Gentoo GhostBSD HP-UX Haiku Hurd IRIX Inferno JazzOS Kali Knoppix LinuxMint MacOSX Mageia Mandriva Manjaro Minix MirBSD NeXTSTEP NetBSD OPENSTEP OSF1 OpenBSD OpenDarwin OpenIndiana OpenMandriva OpenServer OpenSuSE OpenVMS Oracle PC-BSD Peanut Pidora Plan9 QNX Raspbian RedHat Scientific Slackware SmartOS Solaris SuSE SunOS Syllable Tru64 UNIXv7 Ubuntu Ultrix UnixWare Xenix YellowDog aLinux   16655 pages apropos Keyword Search (all sections) Output format html ascii pdf view pdf save postscript

GROUPMOD(1M)							  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

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

				 Aug 27, 2008			  GROUPMOD(1M)

Vote for polarhome