1.\" $OpenBSD: groupadd.8,v 1.17 2016/11/29 03:59:31 jsg Exp $ 2.\" $NetBSD: groupadd.8,v 1.9 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 GROUPADD 8 33.Os 34.Sh NAME 35.Nm groupadd 36.Nd add a group to the system 37.Sh SYNOPSIS 38.Nm groupadd 39.Op Fl ov 40.Op Fl g Ar gid 41.Ar group 42.Sh DESCRIPTION 43The 44.Nm 45utility adds a group to the system. 46The options are as follows: 47.Bl -tag -width Ds 48.It Fl g Ar gid 49Gives the numeric group identifier to be used for the new group. 50.It Fl o 51Allows the new group to have a GID which is already in use for another group. 52.It Fl v 53Enables verbose mode - explain the commands as they are executed. 54.El 55.Sh EXIT STATUS 56.Ex -std groupadd 57.Sh SEE ALSO 58.Xr group 5 , 59.Xr groupdel 8 , 60.Xr groupinfo 8 , 61.Xr groupmod 8 , 62.Xr user 8 63.Sh HISTORY 64The 65.Nm 66utility first appeared in 67.Ox 2.7 . 68.Sh AUTHORS 69The 70.Nm 71utility was written by 72.An Alistair G. Crooks Aq Mt agc@NetBSD.org . 73