groupadd(1m) [hpux man page]

groupadd(1M)															      groupadd(1M)

NAME

       groupadd - add a new group to the system

SYNOPSIS

       gid group

DESCRIPTION

       The  command  creates a new group on the system by adding the appropriate entry to the file.  The command must be used with the group argu-
       ment, which is the name of the new group.  The name consists of a string of printable characters that may not include a colon or newline

       Refer to usergroupname(5) to understand the functionality changes with the Numeric User Group Name feature.

   Options
       The command uses the following options:

	      Specify the group ID
			for the new group.  gid must be a non-negative decimal integer less than as defined in the header file.   By  default  the
			next available unique group ID in the valid range is allocated.  Group IDs in the range 0-99 are reserved.

	      Allow the gid to be non-unique (that is, a duplicate).

   NIS
       The  command  is aware of NIS user entries.  Only local groups may be added with this command.  Attempts to add an NIS group will result in
       an error.  NIS groups must be administered from the NIS server.	If is used on a system where NIS is installed, it may fail with the error

       (return value 9) if the group specified is not present in the local file, but is an NIS group (see group(4)).  NIS groups are also  checked
       when verifying uniqueness of the new gid, which may result in the error

       (return value 4).

RETURN VALUE

       The command exits with one of the following values:

	      No error.
	      Invalid command syntax.
	      Invalid argument supplied to an option.
	      gid  is not unique (when is not used).
	      group
		   is not unique.
	      Cannot modify the
		   file.
	      file or
		   file busy. Another command may be modifying the file.
	      Unable to open
		   file or file is non-existent.

EXAMPLES

       Add the group to the file.

       Add the group to the file with the group ID as long as no group currently exists with a group ID of

WARNINGS

       Because	many users may try to write the file simultaneously, a password locking mechanism was devised.	If this locking fails after subse-
       quent retrying, terminates.

FILES

SEE ALSO

       users(1), groupdel(1M), groupmod(1M), logins(1M), useradd(1M), userdel(1M), usermod(1M), group(4), usergroupname(5).

STANDARDS CONFORMANCE

																      groupadd(1M)

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 will be  201. (Group IDs from
                0-99 are reserved by SunOS for future applications.)

       -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 message  will
                be  written  if  the  string  exceeds MAXGLEN, which is usually set at 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

       /etc/group

       /usr/include/userdefs.h

ATTRIBUTES

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

       +-----------------------------+-----------------------------+
       |      ATTRIBUTE TYPE         |      ATTRIBUTE VALUE        |
       +-----------------------------+-----------------------------+
       |Availability                 |SUNWcsu                      |
       +-----------------------------+-----------------------------+

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 or NIS+ is being used  to  supplement  the
       local  /etc/group  file with additional entries, groupadd cannot change information supplied by the network name service. However, groupadd
       will verify the uniqueness of group name and group ID against the external name service.

SunOS 5.10                                                          27 Mar 1998                                                       groupadd(1M)