|
|
HP-UX Reference > Ggroupadd(1M)HP-UX 11i Version 2: December 2007 Update |
|
NAMEgroupadd — add a new group to the system DESCRIPTIONThe groupadd command creates a new group on the system by adding the appropriate entry to the /etc/group file. The groupadd command expects the group argument, 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 (\n). OptionsThe groupadd command may be used with the following options:
NETWORKING FEATURESThe groupadd 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 groupadd is used on a system where NIS is installed, it may fail with the error group x is not unique (return value 9) if the group specified is not present in the local /etc/group 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 GID # is not unique (return value 4). RETURN VALUEThe groupadd command exits with one of the following values:
EXAMPLESAdd the group project1 to the /etc/group file. groupadd project1 Add the group project12 to the /etc/group file with the group ID 111 as long as no group currently exists with a group ID of 111. groupadd -g 111 project12 WARNINGSAs many users may try to write the /etc/passwd file simultaneously, a passwd locking mechanism was deviced. If this locking fails after subsequent retrying, groupadd terminates. SEE ALSOusers(1), groupdel(1M), groupmod(1M), logins(1M), useradd(1M), userdel(1M), usermod(1M), group(4). |
|