Files
shadow/docs/man/groupmod.8.md
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.2 KiB

groupmod(8) - modify a group definition

NAME

groupmod - modify a group definition

SYNOPSIS

groupmod [options] GROUP

DESCRIPTION

The groupmod command modifies the definition of the specified GROUP by modifying the appropriate entries in the group and gshadow databases.

OPTIONS

-g, --gid GID
Change the group ID to GID.
-n, --new-name NEW_GROUP
Change the name of the group to NEW_GROUP.
-o, --non-unique
Allow using a non-unique (duplicate) GID when used with -g.
-p, --password PASSWORD
Change the group password to the encrypted PASSWORD.
-P, --prefix PREFIX_DIR
Use PREFIX_DIR as a prefix for system file paths.
-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.
6
Group does not exist.
9
Group name already in use.
10
Cannot update group file.

FILES

/etc/group
Group account information.
/etc/gshadow
Secure group account information.

SEE ALSO

groupadd(8), groupdel(8)