groupadd man page on OpenIndiana

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

groupadd(1M)		System Administration Commands		  groupadd(1M)

NAME
       groupadd - add (create) a new group definition on the system

SYNOPSIS
       /usr/sbin/groupadd [-g gid [-o]] group

DESCRIPTION
       The  groupadd  command  creates a new group definition on the system by
       adding the appropriate entry to the /etc/group file.

OPTIONS
       The following options are supported:

       -g gid	 Assigns the group id gid for the new  group.  This  group  id
		 must  be  a  non-negative  decimal  integer  below  MAXUID as
		 defined in /usr/include/sys/param.h. The group ID defaults to
		 the  next  available (unique) number above the highest number
		 currently assigned. For example, if groups 100, 105, and  200
		 are assigned as groups, the next default group number is 201.
		 (Group IDs from 0−99 are reserved by SunOS for future	appli‐
		 cations.)

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

OPERANDS
       The following operands are supported:

       group	A  string  consisting of characters from the set of lower case
		alphabetic characters and numeric characters. A	 warning  mes‐
		sage is written if the string exceeds MAXGLEN-1, which is usu‐
		ally eight characters. The group field must contain  at	 least
		one  character; it accepts lower case or numeric characters or
		a combination of both, and must not contain  a	colon  (:)  or
		NEWLINE.

EXIT STATUS
       The following exit values are returned:

       0     Successful completion.

       2     Invalid  command syntax. A usage message for the groupadd command
	     is displayed.

       3     An invalid argument was provided to an option.

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

       9     The group is not unique.

       10    The /etc/group file cannot be updated.

FILES
	   o	  /etc/group

	   o	  /usr/include/userdefs.h

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

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

SEE ALSO
       users(1B), groupdel(1M), groupmod(1M), grpck(1M), logins(1M), pwck(1M),
       useradd(1M), userdel(1M), usermod(1M), group(4), attributes(5)

NOTES
       groupadd only adds a group definition to the local system. If a network
       name service such  as  NIS  is  being  used  to	supplement  the	 local
       /etc/group  file with additional entries, groupadd cannot change infor‐
       mation supplied by the network name service. However, groupadd verifies
       the  uniqueness	of  group  name and group ID against the external name
       service.

       If the number of characters in a group entry exceeds 2047, group	 main‐
       tenance commands, such as groupdel(1M) and groupmod(1M), fail.

SunOS 5.11			  22 Feb 2010			  groupadd(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