xref: /openbsd-src/usr.sbin/user/groupmod.8 (revision f2da64fbbbf1b03f09f390ab01267c93dfd77c4c)
1.\" $OpenBSD: groupmod.8,v 1.18 2013/07/16 11:13:34 schwarze 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. All advertising materials mentioning features or use of this software
15.\"    must display the following acknowledgement:
16.\"	This product includes software developed by Alistair G. Crooks.
17.\" 4. The name of the author may not be used to endorse or promote
18.\"    products derived from this software without specific prior written
19.\"    permission.
20.\"
21.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS
22.\" OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
23.\" WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
24.\" ARE DISCLAIMED.  IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY
25.\" DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
26.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE
27.\" GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
28.\" INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY,
29.\" WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING
30.\" NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
31.\" SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
32.\"
33.\"
34.Dd $Mdocdate: July 16 2013 $
35.Dt GROUPMOD 8
36.Os
37.Sh NAME
38.Nm groupmod
39.Nd modify an existing group on the system
40.Sh SYNOPSIS
41.Nm groupmod
42.Op Fl ov
43.Op Fl g Ar gid
44.Op Fl n Ar newname
45.Ar group
46.Sh DESCRIPTION
47The
48.Nm
49utility modifies an existing group.
50The options are as follows:
51.Bl -tag -width Ds
52.It Fl g Ar gid
53Gives the numeric group identifier to be used for the new group.
54.It Fl n Ar newname
55Gives the new name which the group shall have.
56.It Fl o
57Allows the new group to have a GID which is already in use for another group.
58.It Fl v
59Enables verbose mode - explain the commands as they are executed.
60.El
61.Sh EXIT STATUS
62.Ex -std groupmod
63.Sh SEE ALSO
64.Xr group 5 ,
65.Xr groupadd 8 ,
66.Xr groupdel 8 ,
67.Xr groupinfo 8 ,
68.Xr user 8
69.Sh HISTORY
70The
71.Nm
72utility first appeared in
73.Ox 2.7 .
74.Sh AUTHORS
75The
76.Nm
77utility was written by
78.An Alistair G. Crooks Aq Mt agc@NetBSD.org .
79