mirror of https://github.com/uutils/shadow.git synced 2026-06-10 16:14:57 -07:00

Files

T

Pierre Warnier 81d0e1776d docs/fixes: man pages, benchmarks, BSD research, Copilot findings

Fixes #56 — 14 man pages in docs/man/ (markdown format).
Fixes #67 — 8 Copilot findings fixed:
  - useradd: proper date validation (Feb 31 rejected)
  - userdel/usermod: --root wired to SysRoot
  - usermod: --expiredate validates input
  - usermod: --login validates name + updates shadow/group
  - userdel: -f separated from -r behavior
  - useradd: home dir resolved through SysRoot
  - skel: preserves directory permissions
Fixes #69 — benchmark script (benches/benchmark.sh)
Fixes #70 — FreeBSD/NetBSD reference (docs/FREEBSD-NETBSD-REFERENCE.md)

456 tests, zero clippy warnings.

2026-03-24 13:05:40 +01:00

1.6 KiB

Raw Blame History

groupadd(8) - create a new group

NAME

groupadd - create a new group

SYNOPSIS

groupadd [options] GROUP

DESCRIPTION

The groupadd command creates a new group account using the values specified on the command line plus the default values from the system. The new group will be entered into the system files (/etc/group and /etc/gshadow) as needed.

OPTIONS

-f, --force: Exit successfully if the group already exists, and cancel -g if the GID is already used (a new GID will be allocated instead).
-g, --gid GID: Use GID for the new group.
-K, --key KEY=VALUE: Override /etc/login.defs defaults (GID_MIN, GID_MAX, SYS_GID_MIN, SYS_GID_MAX). Can be specified multiple times.
-o, --non-unique: Allow creating a group with a non-unique (duplicate) GID.
-p, --password PASSWORD: Set the encrypted password for the new group.
-P, --prefix PREFIX_DIR: Use PREFIX_DIR as a prefix for system file paths.
-r, --system: Create a system group (allocated from the system GID range defined in /etc/login.defs).
-R, --root CHROOT_DIR: Apply changes in the CHROOT_DIR directory.

EXIT STATUS

0: Success.
2: Invalid command syntax.
3: Invalid argument to option.
4: GID already in use (and no -o or -f).
9: Group name already in use.
10: Cannot update group file.

FILES

/etc/group: Group account information.
/etc/gshadow: Secure group account information.
/etc/login.defs: Shadow password suite configuration.

1.6 KiB Raw Blame History