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)