Index for Section 8

Alphabetical listing for G

Bottom of page

groupadd(8)
NAME
  groupadd - Adds a new group definition

SYNOPSIS
  /usr/sbin/groupadd [-g gid [-o]] [-P] [-x extended_option] group_name

OPTIONS
  -g gid
      Specifies the group identifier (GID) of the new group being added.  The
      GID must be a non-negative decimal integer.

  -o  Allows a group identification (GID) number to be duplicated (non-
      unique).	This option can be used only with the -g option.

  -P  Creates a PC group only.

  -x extended_option
      The following extended_option attributes are available. The PC
      attributes will only be applicable if the Advanced Server for UNIX
      (ASU) is configured.  The extended_option attributes can be specified
      as a space-delimited list after a single -x option.

      distributed=n
	  Indicates that the group is distributed. The value of the
	  distributed=n attribute can be 0 or 1.  If set to 0, the group is
	  added to the local system. If set to 1, the group is added to the
	  NIS master database on the running system.  When this attribute is
	  set, the local attribute is automatically set to the opposite
	  value.

      local=n
	  Indicates that the group is local. The value of the local=n
	  attribute can be 0 or 1. If set to 1, the group is added to the
	  local database. If set to 0, the group information is added to the
	  NIS master database.	When this attribute is set, the distributed
	  attribute is automatically set to the opposite value.

      members=string
	  A comma-delimited list of members that will be added to the UNIX
	  user's group.	 You can specify the user (login) name or the account
	  UID.

      pc_group_description=string
	  Specifies a text string that provides a description of the PC
	  group.

      pc_group_members=user,user....
	  Specifies a comma delimited list of PC users to be added to the
	  current list of members of a PC group. Note that this adds, but
	  does not replace members.

  group_name
      Specifies the name of the new group.  The group name can be any
      printable characters, with the exception of the colon (:) and newline
      (\n) characters.


DESCRIPTION
  The groupadd command is part of a set of command-line interfaces (CLI) that
  are used to create and administer user groups on the system.	When the
  Advanced Server for UNIX (ASU) is installed and running, the groupadd
  command can also be used to administer PC groups for users who are also
  holders of Windows NT domain accounts. Accounts can also be created with
  the /usr/bin/X11/dxaccounts graphical user interface (GUI), although the
  extended options are only available from the CLI utilities such as useradd
  and groupmod.

  Different options are available depending on how the local system is
  configured:

    ·  In the default UNIX environment, user account management is compliant
       with the IEEE POSIX Draft P13873.3 standard.

    ·  The CLI is backwards-compatible, so all existing local scripts will
       function.  However, you should consider testing your account
       management scripts before use.

  The groupadd command lets the system administrator create new groups on the
  system, by specifying the group name and GID. When the GID is not specified
  (with the -g option), the GID defaults to the next available (unique)
  number.

  The -x option lets the system administrator specify whether the new group
  is local or distributed over a network.  If this option is not specified on
  the command line, the system adds the new group to the appropriate database
  as specified by the system defaults.

  The default behavior on the system for the groupadd command is
  distributed=0 and local=1.  With these values, the system adds the group to
  the local database by default.  Setting the distributed= and local=
  attributes to the same value (for example, distributed=0 and local=0)
  produces an error.

  You must have superuser privilege to execute this command.

RESTRICTIONS
  You cannot specify more than 255 characters on a single command line.
  However, lines can be split to an appropriate length.	 If you try and enter
  too many new groups, the group file may be corrupted.

  The pc_synchronize default value is not used for groupadd, groupmod, and
  groupdel. UNIX and PC groups cannot be synchronized and therefore must be
  created separately. Use the command groupadd -P xdomain to create a PC
  group named xdomain.	    Then, use the command groupadd xdomain to create
  a UNIX group named xdomain.

EXIT STATUS
  The groupadd command exits with one of the following values:

  0   Success.

  1   Failure.

  2   Warning.






EXAMPLES
   1.  The following example adds the group, newgroup, to the group database
       with a system-provided GID:
	    % groupadd newgroup

   2.  The following example adds the group, newgroup, to the group database
       with a GID of 451:
	    % groupadd -g 451 newgroup

   3.  The following example adds the group, newgroup, to the NIS master
       database
	    % groupadd -x distributed=1 newgroup

   4.  The following example adds the PC group, projectX with members JoeMc
       and HiteshC:
	    % groupadd -x members=JoeMc,HiteshC, \
	    projectX

   5.  The following example adds the PC group, newgroup and provides a
       description field "common project group":
	    % groupadd -P -x pc_group_description="common project group" \
	    projectX



FILES
  The groupadd command operates on files for the specific level of system
  security.

SEE ALSO
  Commands:  groupdel(8), groupmod(8), useradd(8), userdel(8), usermod(8)

  System Administration

  Security

  Advanced Server for UNIX administration and configuration documents.

Index for Section 8

Alphabetical listing for G

Top of page