1.\" $NetBSD: groupinfo.8,v 1.13 2014/09/19 16:02:59 wiz Exp $ */ 2.\" 3.\" Copyright (c) 1999 Alistair G. Crooks. All rights reserved. 4.\" 5.\" Redistribution and use in source and binary forms, with or without 6.\" modification, are permitted provided that the following conditions 7.\" are met: 8.\" 1. Redistributions of source code must retain the above copyright 9.\" notice, this list of conditions and the following disclaimer. 10.\" 2. Redistributions in binary form must reproduce the above copyright 11.\" notice, this list of conditions and the following disclaimer in the 12.\" documentation and/or other materials provided with the distribution. 13.\" 3. The name of the author may not be used to endorse or promote 14.\" products derived from this software without specific prior written 15.\" permission. 16.\" 17.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS 18.\" OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED 19.\" WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE 20.\" ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY 21.\" DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL 22.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE 23.\" GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS 24.\" INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, 25.\" WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING 26.\" NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS 27.\" SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. 28.\" 29.\" 30.Dd November 7, 2005 31.Dt GROUPINFO 8 32.Os 33.Sh NAME 34.Nm groupinfo 35.Nd displays group information 36.Sh SYNOPSIS 37.Nm 38.Op Fl ev 39.Ar group 40.Sh DESCRIPTION 41The 42.Nm 43utility retrieves the group information from the system. 44The 45.Nm 46utility is only available if built with 47.Dv EXTENSIONS . 48See 49.Xr group 8 50for more information. 51.Pp 52The following command line options are recognised: 53.Bl -tag -width Ds 54.It Fl e 55Return 0 if the group exists, and non-zero if the 56group does not exist, on the system. 57No information is displayed. 58This form of the command is useful for 59scripts which need to check whether a particular group 60name or gid is already in use on the system. 61.It Fl v 62Perform any actions in a verbose manner. 63.El 64.Pp 65The 66.Ar group 67argument may either be a group's name, or a gid. 68.Sh FILES 69.Bl -tag -width /etc/usermgmt.conf -compact 70.It Pa /etc/usermgmt.conf 71.El 72.Sh EXIT STATUS 73.Ex -std groupinfo 74.Sh SEE ALSO 75.Xr passwd 5 , 76.Xr group 8 77.Sh HISTORY 78The 79.Nm 80utility first appeared in 81.Nx 1.5 . 82It is based on the 83.Ar addnerd 84package by the same author. 85.Sh AUTHORS 86The 87.Nm 88utility was written by 89.An Alistair G. Crooks 90.Aq agc@NetBSD.org . 91