Man page or keyword search:   man All Sections 1 - General Commands 2 - System Calls 3 - Subroutines, Functions 4 - Special Files 5 - File Formats 6 - Games and Screensavers 7 - Macros and Conventions 8 - Maintenence Commands 9 - Kernel Interface New Commands Server 4.4BSD AIX Alpinelinux Archlinux Aros BSDOS BSDi Bifrost CentOS Cygwin Darwin Debian DigitalUNIX DragonFly ElementaryOS Fedora FreeBSD Gentoo GhostBSD HP-UX Haiku Hurd IRIX Inferno JazzOS Kali Knoppix LinuxMint MacOSX Mageia Mandriva Manjaro Minix MirBSD NeXTSTEP NetBSD OPENSTEP OSF1 OpenBSD OpenDarwin OpenIndiana OpenMandriva OpenServer OpenSuSE OpenVMS Oracle PC-BSD Peanut Pidora Plan9 QNX Raspbian RedHat Scientific Slackware SmartOS Solaris SuSE SunOS Syllable Tru64 UNIXv7 Ubuntu Ultrix UnixWare Xenix YellowDog aLinux   14857 pages apropos Keyword Search (all sections) Output format html ascii pdf view pdf save postscript

groupadd(8)							   groupadd(8)

NAME
       groupadd - create a new group entry

SYNOPSIS
       groupadd	 [-D  binddn]  [-P  path]  [-g gid [-o]] [-p password] [--pre‐
       ferred-gid gid]
	       [-r] [--service service] [--help] [--usage] [-v] group

DESCRIPTION
       groupadd creates a new group entry using the values  specified  on  the
       command	line. Depending on the command line options the new entry will
       be added to the system files or LDAP database.

       The group name must begin with an alphabetic character and the rest  of
       the  string  should  be from the POSIX portable character class ([A-Za-
       z_][A-Za-z0-9_-.]*).

OPTIONS
       -g, --gid gid
	      Force the new group ID to be the given number. This  value  must
	      be  positive and unique. The default is to use the first free ID
	      after the greatest used one. The range from which the  group  ID
	      is chosen can be specified in /etc/login.defs.

       --preferred-gid gid
	      Set the new group ID to the specified value if possible. If that
	      value is already in use the first free  ID  will	be  chosen  as
	      described above.

       -o, --non-unique
	      Allow duplicate (non-unique) group IDs.

       -p, --password password
	      Encrypted	 password as returned by crypt(3) for the new account.
	      The default is to disable the account.

       -r, --system
	      Create a system group. A system group is an entry	 with  an  GID
	      between	SYSTEM_GID_MIN	 and   SYSTEM_GID_MAX  as  defined  in
	      /etc/login.defs, if no GID is specified.

       --service service
	      Add the group to a special directory. The default is files,  but
	      ldap is also valid.

       -D, --binddn binddn
	      Use the Distinguished Name binddn to bind to the LDAP directory.
	      The user will be prompted for a password for simple  authentica‐
	      tion.

       -P, --path path
	      The  group  file	is located below the specified directory path.
	      groupadd will use this files,  not /etc/group.

       --help Print a list of valid options with a short description.

       --usage
	      Print a short list of valid options.

       -v, --version
	      Print the version number and exit.

FILES
       /etc/group - group account information

SEE ALSO
       login.defs(5), group(5), groupdel(8), groupmod(8)

AUTHOR
       Thorsten Kukuk <kukuk@suse.de>

pwdutils			 December 2003			   groupadd(8)

Vote for polarhome