REVNETGROUP(8) BSD System Manager's Manual REVNETGROUP(8)

NAME
     rreevvnneettggrroouupp - generate reverse netgroup data

SYNOPSIS
     rreevvnneettggrroouupp -uu -hh [-ff netgroupfile]

DESCRIPTION
     rreevvnneettggrroouupp processes the contents of a file in netgroup(5) format into
     what is called reverse netgroup form. That is, where the original file
     shows netgroup memberships in terms of which members reside in a particu-
     lar group, the reverse netgroup format specifies what groups are associ-
     ated with a particular member. This information is used to generate the
     nneettggrroouupp..bbyyuusseerr and nneettggrroouupp..bbyyhhoossttss YP maps. These reverse netgroup maps
     are used to help speed up netgroup lookups, particularly for the
     iinnnneettggrr() library function.

     For example, the standard //eettcc//nneettggrroouupp file may list a netgroup and a
     list of its members. Here, the netgroup is considered the key and the
     member names are the data.  By contrast, the reverse nneettggrroouupp..bbyyuusseerrss
     database lists each unique member as the key and the netgroups to which
     the members belong become the data. Seperate databases are created to
     hold information pertaining to users and hosts; this allows netgroup
     username lookups and netgroup hostname lookups to be performed using
     independent keyspaces.

     By constructing these reverse netgroup databases (and the corresponding
     YP maps) in advance, the getnetgrent(3) library functions are spared from
     having to work out the dependencies themselves on the fly. This is impor-
     tant on networks with large numbers of users and hosts, since it can take
     a considerable amount of time to process very large netgroup databases.

     The rreevvnneettggrroouupp command prints its results on the standard output. It is
     usually called only by //vvaarr//yypp//<>//MMaakkeeffiillee when rebuilding the YP
     netgroup maps.

OOPPTTIIOONNSS
     The rreevvnneettggrroouupp command supports the following options:

     -uu    Generate netgroup.byuser output; only username information in the
           original netgroup file is processed.

     -hh    Generate netgroup.byhost output; only hostname information in the
           original netgroup file is processed. (Note at least one of the -uu
           or -hh flags must be specified.)

     [-ff netgroupfile]
           The rreevvnneettggrroouupp command uses //eettcc//nneettggrroouupp as its default input
           file. The -ff flag allows the user to specify an alternate input
           file. Specifying ``-'' as the input file causes rreevvnneettggrroouupp to read
           from the standard input.

FILES     /var/yp/Makefile          The Makefile that calls mmaakkeeddbbmm and
                                       rreevvnneettggrroouupp to build the YP databases.
     /etc/netgroup                     The default netgroup database file.
                                       This file is most often found only on
                                       the YP master server.

SEE ALSO
     getnetgrent(3), yp(8), netgroup(5), makedbm(8)

AUTHOR     Bill Paul 

BSD                            October 24, 1995                            BSD