1*7a3d14ecSjsg.\" $OpenBSD: groupinfo.8,v 1.15 2016/11/29 03:59:31 jsg Exp $ 23c76c7c0Smillert.\" $NetBSD: groupinfo.8,v 1.3 2000/10/03 19:32:23 bjh21 Exp $ 3e02380dbSjakob.\" 4e02380dbSjakob.\" Copyright (c) 1999 Alistair G. Crooks. All rights reserved. 5e02380dbSjakob.\" 6e02380dbSjakob.\" Redistribution and use in source and binary forms, with or without 7e02380dbSjakob.\" modification, are permitted provided that the following conditions 8e02380dbSjakob.\" are met: 9e02380dbSjakob.\" 1. Redistributions of source code must retain the above copyright 10e02380dbSjakob.\" notice, this list of conditions and the following disclaimer. 11e02380dbSjakob.\" 2. Redistributions in binary form must reproduce the above copyright 12e02380dbSjakob.\" notice, this list of conditions and the following disclaimer in the 13e02380dbSjakob.\" documentation and/or other materials provided with the distribution. 14*7a3d14ecSjsg.\" 3. The name of the author may not be used to endorse or promote 15e02380dbSjakob.\" products derived from this software without specific prior written 16e02380dbSjakob.\" permission. 17e02380dbSjakob.\" 18e02380dbSjakob.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS 19e02380dbSjakob.\" OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED 20e02380dbSjakob.\" WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE 21e02380dbSjakob.\" ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY 22e02380dbSjakob.\" DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL 23e02380dbSjakob.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE 24e02380dbSjakob.\" GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS 25e02380dbSjakob.\" INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, 26e02380dbSjakob.\" WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING 27e02380dbSjakob.\" NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS 28e02380dbSjakob.\" SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. 29e02380dbSjakob.\" 30e02380dbSjakob.\" 31*7a3d14ecSjsg.Dd $Mdocdate: November 29 2016 $ 32e02380dbSjakob.Dt GROUPINFO 8 338aa50653Sjakob.Os 34e02380dbSjakob.Sh NAME 35e02380dbSjakob.Nm groupinfo 366a289adfSjmc.Nd display group information 37e02380dbSjakob.Sh SYNOPSIS 3824a3a9d1Smpech.Nm groupinfo 396a289adfSjmc.Op Fl e 40e02380dbSjakob.Ar group 41e02380dbSjakob.Sh DESCRIPTION 42e02380dbSjakobThe 43e02380dbSjakob.Nm 446a289adfSjmcutility displays the name, group ID (GID), 456a289adfSjmcand members of the specified 466a289adfSjmc.Ar group . 47e02380dbSjakob.Pp 486a289adfSjmcThe options are as follows: 49e02380dbSjakob.Bl -tag -width Ds 50e02380dbSjakob.It Fl e 516a289adfSjmcDo not display anything (quiet mode). 524fb31a24SjmcThis form of the command is useful for 53e02380dbSjakobscripts which need to check whether a particular group 544fb31a24Sjmcname or GID is already in use on the system. 55e02380dbSjakob.El 56e02380dbSjakob.Pp 573c76c7c0SmillertThe 583c76c7c0Smillert.Ar group 596a289adfSjmcargument may be either a group name or a GID. 60741b6f30Sjmc.Sh EXIT STATUS 61e02380dbSjakobThe 62e02380dbSjakob.Nm 636a289adfSjmcutility exits 0 if 646a289adfSjmc.Ar group 656a289adfSjmcexists, and non-zero if it does not. 66e02380dbSjakob.Sh SEE ALSO 676a289adfSjmc.Xr group 5 , 686806f038Smillert.Xr passwd 5 , 696a289adfSjmc.Xr group 8 , 706a289adfSjmc.Xr userinfo 8 71e02380dbSjakob.Sh HISTORY 72e02380dbSjakobThe 73e02380dbSjakob.Nm 74e02380dbSjakobutility first appeared in 75f88889abSjakob.Ox 2.7 . 76b5667098Smpech.Sh AUTHORS 77e02380dbSjakobThe 78e02380dbSjakob.Nm 796806f038Smillertutility was written by 8044e68d47Sschwarze.An Alistair G. Crooks Aq Mt agc@NetBSD.org . 816a289adfSjmc.Sh CAVEATS 826a289adfSjmcIf the specified 836a289adfSjmc.Ar group 846a289adfSjmcis the primary group of a user, but that user is not listed as a 856a289adfSjmcmember of the 866a289adfSjmc.Ar group 876a289adfSjmcin the 886a289adfSjmc.Xr group 5 896a289adfSjmcfile, the 906a289adfSjmc.Nm 916a289adfSjmcutility fails to list that user as a member of the 926a289adfSjmc.Ar group . 93