---
name: "groupmod"
section: "8"
platform: "openbsd"
package: "man"
version: "8.0-current-20261101"
release: "OpenBSD 8.0-current (2026-11-01)"
platforms: ["linux", "openbsd"]
url: "https://new.carta.tech/groupmod"
---

# groupmod(8)

modify an existing group on the system

## NAME

**groupmod** – modify an existing group on the system

## SYNOPSIS

**groupmod** \[**-ov**\] \[**-g** *gid*\] \[**-n** *newname*\] *group*

## DESCRIPTION

The **groupmod** utility modifies an existing group. The options are as follows:

- **-g** *gid*

  Gives the numeric group identifier to be used for the new group.

- **-n** *newname*

  Gives the new name which the group shall have.

- **-o**

  Allows the new group to have a GID which is already in use for another group.

- **-v**

  Enables verbose mode - explain the commands as they are executed.

## EXIT STATUS

The **groupmod** utility exits 0 on success, and \>0 if an error occurs.

## SEE ALSO

[group(5)](/group/5.md), [groupadd(8)](/groupadd/8.md), [groupdel(8)](/groupdel/8.md), [groupinfo(8)](/groupinfo/8.md), user(8)

## HISTORY

The **groupmod** utility first appeared in OpenBSD 2.7.

## AUTHORS

The **groupmod** utility was written by Alistair G. Crooks ⟨*agc@NetBSD.org*⟩.