summaryrefslogtreecommitdiff
path: root/Base/usr/share/man/man8/groupadd.md
blob: 8268cf62dc811affaa313e850de6d09f6344e4ae (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
## Name

groupadd - add a new group to the system group file

## Synopsis

```**sh
# groupadd [options] <group>
```

## Description

This program adds a new group to the system.

This program must be run as root.

## Options

* `-g`, `--gid` _gid_: The group identifier for the new group. If not specified, an unused GID above `100` will be auto-generated.

## Exit Values

* 0 - Success
* 1 - Couldn't update the group file
* 3 - Invalid argument to option
* 4 - GID already in use

## Files

* `/etc/group` - new group information (such GID) is appended to this file.

## Examples

```sh
# groupadd -g 110 contributors
# groupadd maintainers
```