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