xref: /netbsd-src/usr.sbin/user/groupmod.8 (revision e4d7c2e329d54c97e0c0bd3016bbe74f550c3d5e)
1.\" $NetBSD: groupmod.8,v 1.4 2000/02/28 05:10:56 enami Exp $ */
2.\"
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 November 30, 1999
35.Dt GROUPMOD 8
36.Os NetBSD
37.Sh NAME
38.Nm groupmod
39.Nd modify an existing group on the system
40.Sh SYNOPSIS
41.Nm
42.Op Fl g Ar gid
43.Op Fl n Ar newname
44.Op Fl o
45.Op Fl v
46.Ar group
47.Sh DESCRIPTION
48The
49.Nm
50utility adds a group to the system.
51The options are as follows:
52.Bl -tag -width Ds
53.It Fl g Ar gid
54gives the numeric group identifier to be used for the new group.
55.It Fl n Ar new-group-name
56gives the new name which the group shall have.
57.It Fl o
58allow the new group to have a gid which is already in use for another group.
59.It Fl v
60enables verbose mode - explain the commands as they are executed.
61.El
62.Pp
63The
64.Nm
65utility exits 0 on success, and >0 if an error occurs.
66.Sh SEE ALSO
67.Xr group 5 ,
68.Xr group 8 ,
69.Xr user 8
70.Sh HISTORY
71The
72.Nm
73utility first appeared in
74.Nx 1.5 .
75It is based on the
76.Ar addnerd
77package by the same author.
78.Sh AUTHOR
79The
80.Nm
81utility was written by Alistair G. Crooks (agc@netbsd.org).
82