1.\" Copyright (c) 1995 2.\" Bill Paul <wpaul@ctr.columbia.edu>. All rights reserved. 3.\" 4.\" Redistribution and use in source and binary forms, with or without 5.\" modification, are permitted provided that the following conditions 6.\" are met: 7.\" 1. Redistributions of source code must retain the above copyright 8.\" notice, this list of conditions and the following disclaimer. 9.\" 2. Redistributions in binary form must reproduce the above copyright 10.\" notice, this list of conditions and the following disclaimer in the 11.\" documentation and/or other materials provided with the distribution. 12.\" 3. All advertising materials mentioning features or use of this software 13.\" must display the following acknowledgement: 14.\" This product includes software developed by Bill Paul. 15.\" 4. Neither the name of the University nor the names of its contributors 16.\" may be used to endorse or promote products derived from this software 17.\" without specific prior written permission. 18.\" 19.\" THIS SOFTWARE IS PROVIDED BY Bill Paul AND CONTRIBUTORS ``AS IS'' AND 20.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE 21.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE 22.\" ARE DISCLAIMED. IN NO EVENT SHALL Bill Paul OR CONTRIBUTORS BE LIABLE 23.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL 24.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS 25.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) 26.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT 27.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY 28.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF 29.\" SUCH DAMAGE. 30.\" 31.\" $Id: revnetgroup.8,v 1.5 1997/11/25 07:14:34 charnier Exp $ 32.\" 33.Dd October 24, 1995 34.Dt REVNETGROUP 8 35.Os 36.Sh NAME 37.Nm revnetgroup 38.Nd "generate reverse netgroup data" 39.Sh SYNOPSIS 40.Nm revnetgroup 41.Fl u 42.Op Fl f Ar netgroup_file 43.Nm revnetgroup 44.Fl h 45.Op Fl f Ar netgroup_file 46.Sh DESCRIPTION 47.Nm Revnetgroup 48processes the contents of a file in 49.Xr netgroup 5 50format into what is called 51.Pa reverse netgroup 52form. That is, where the original file shows 53netgroup memberships in terms of which members reside in a particular 54group, the reverse netgroup format specifies what groups are associated 55with a particular member. This information is used to generate the 56.Pa netgroup.byuser 57and 58.Pa netgroup.byhosts 59.Tn NIS 60maps. These reverse netgroup maps are used to help speed up 61netgroup lookups, particularly for the 62.Fn innetgr 63library function. 64.Pp 65For example, the standard 66.Pa /etc/netgroup 67file may list a netgroup and a list of its members. Here, the 68netgroup is considered the 69.Em key 70and the member names are the 71.Em data . 72By contrast, the reverse 73.Pa netgroup.byusers 74database lists each unique 75member as the key and the netgroups to which the members belong become 76the data. Seperate databases are created to hold information pertaining 77to users and hosts; this allows netgroup username lookups 78and netgroup hostname lookups to be performed using independent keyspaces. 79.Pp 80By constructing these reverse netgroup databases (and the corresponding 81.Tn NIS 82maps) in advance, the 83.Xr getnetgrent 3 84library functions are spared from having to work out the dependencies 85themselves on the fly. This is important on networks with large numbers 86of users and hosts, since it can take a considerable amount of time 87to process very large netgroup databases. 88.Pp 89The 90.Nm 91command prints its results on the standard output. It is usually called 92only by 93.Pa /var/yp/Makefile 94when rebuilding the 95.Tn NIS 96netgroup maps. 97.Pp 98.Sh OPTIONS 99The 100.Nm 101command supports the following options: 102.Bl -tag -width indent 103.It Fl u 104Generate 105.Pa netgroup.byuser 106output; only username information in the 107original netgroup file is processed. 108.It Fl h 109Generate 110.Pa netgroup.byhost 111output; only hostname information in the 112original netgroup file is processed. (Note at least one of the 113.Fl u 114or 115.Fl h 116flags must be specified.) 117.It Op Fl f Ar netgroup_file 118The 119.Nm 120command uses 121.Pa /etc/netgroup 122as its default input file. The 123.Fl f 124flag allows the user to specify an alternate input file. Specifying ``-'' 125as the input file causes 126.Nm 127to read from the standard input. 128.El 129.Sh FILES 130.Bl -tag -width /var/yp/Makefile -compact 131.It Pa /var/yp/Makefile 132the Makefile that calls 133.Nm yp_mkdb 134and 135.Nm revnetgroup 136to build the 137.Tn NIS 138databases 139.It Pa /etc/netgroup 140the default netgroup database file. This file is most often found 141only on the 142.Tn NIS 143master server 144.El 145.Sh SEE ALSO 146.Xr getnetgrent 3 , 147.Xr yp 4 , 148.Xr netgroup 5 , 149.Xr yp_mkdb 8 150.Sh AUTHORS 151.An Bill Paul Aq wpaul@ctr.columbia.edu 152