xref: /openbsd-src/usr.sbin/user/groupmod.8 (revision 7a3d14ecb20e7bd4167711f8dc52b019326d4275)
1*7a3d14ecSjsg.\" $OpenBSD: groupmod.8,v 1.19 2016/11/29 03:59:31 jsg Exp $
26806f038Smillert.\" $NetBSD: groupmod.8,v 1.10 2003/02/14 16:11:37 grant Exp $
3e02380dbSjakob.\"
4e02380dbSjakob.\" Copyright (c) 1999 Alistair G. Crooks.  All rights reserved.
5e02380dbSjakob.\"
6e02380dbSjakob.\" Redistribution and use in source and binary forms, with or without
7e02380dbSjakob.\" modification, are permitted provided that the following conditions
8e02380dbSjakob.\" are met:
9e02380dbSjakob.\" 1. Redistributions of source code must retain the above copyright
10e02380dbSjakob.\"    notice, this list of conditions and the following disclaimer.
11e02380dbSjakob.\" 2. Redistributions in binary form must reproduce the above copyright
12e02380dbSjakob.\"    notice, this list of conditions and the following disclaimer in the
13e02380dbSjakob.\"    documentation and/or other materials provided with the distribution.
14*7a3d14ecSjsg.\" 3. The name of the author may not be used to endorse or promote
15e02380dbSjakob.\"    products derived from this software without specific prior written
16e02380dbSjakob.\"    permission.
17e02380dbSjakob.\"
18e02380dbSjakob.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS
19e02380dbSjakob.\" OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
20e02380dbSjakob.\" WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
21e02380dbSjakob.\" ARE DISCLAIMED.  IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY
22e02380dbSjakob.\" DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
23e02380dbSjakob.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE
24e02380dbSjakob.\" GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
25e02380dbSjakob.\" INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY,
26e02380dbSjakob.\" WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING
27e02380dbSjakob.\" NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
28e02380dbSjakob.\" SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
29e02380dbSjakob.\"
30e02380dbSjakob.\"
31*7a3d14ecSjsg.Dd $Mdocdate: November 29 2016 $
32e02380dbSjakob.Dt GROUPMOD 8
338aa50653Sjakob.Os
34e02380dbSjakob.Sh NAME
35e02380dbSjakob.Nm groupmod
36e02380dbSjakob.Nd modify an existing group on the system
37e02380dbSjakob.Sh SYNOPSIS
3824a3a9d1Smpech.Nm groupmod
393c76c7c0Smillert.Op Fl ov
40e02380dbSjakob.Op Fl g Ar gid
41e02380dbSjakob.Op Fl n Ar newname
42e02380dbSjakob.Ar group
43e02380dbSjakob.Sh DESCRIPTION
44e02380dbSjakobThe
45e02380dbSjakob.Nm
46bcc26b90Steduutility modifies an existing group.
47e02380dbSjakobThe options are as follows:
48e02380dbSjakob.Bl -tag -width Ds
49e02380dbSjakob.It Fl g Ar gid
500f5c715dSsobradoGives the numeric group identifier to be used for the new group.
513f397614Sjmc.It Fl n Ar newname
520f5c715dSsobradoGives the new name which the group shall have.
53e02380dbSjakob.It Fl o
540f5c715dSsobradoAllows the new group to have a GID which is already in use for another group.
55e02380dbSjakob.It Fl v
560f5c715dSsobradoEnables verbose mode - explain the commands as they are executed.
57e02380dbSjakob.El
58741b6f30Sjmc.Sh EXIT STATUS
59e4281b20Ssobrado.Ex -std groupmod
60e02380dbSjakob.Sh SEE ALSO
61e02380dbSjakob.Xr group 5 ,
622465c7a7Smillert.Xr groupadd 8 ,
633f397614Sjmc.Xr groupdel 8 ,
642465c7a7Smillert.Xr groupinfo 8 ,
65e02380dbSjakob.Xr user 8
66e02380dbSjakob.Sh HISTORY
67e02380dbSjakobThe
68e02380dbSjakob.Nm
69e02380dbSjakobutility first appeared in
70f88889abSjakob.Ox 2.7 .
71b5667098Smpech.Sh AUTHORS
72e02380dbSjakobThe
73e02380dbSjakob.Nm
746806f038Smillertutility was written by
7544e68d47Sschwarze.An Alistair G. Crooks Aq Mt agc@NetBSD.org .
76