mirror/freebsd
1
0
Fork 0
mirror of https://git.FreeBSD.org/src.git synced 2024-12-30 12:04:07 +00:00
Code Issues Releases Activity
3dc4256892
freebsd/libexec/revnetgroup/revnetgroup.8

152 lines
4.5 KiB
Groff
Raw Normal View History

Import the first cut of my (finally finished) revnetgroup program. This program parses the /etc/netgroup file into netgroup.byuser and netgroup.byhost format for NIS. I used hash tables to store the initial netgroup data in memory and to construct the 'reverse' netgroup output. It seems just as fast as the SunOS revnetgroup, which is surprising considering this is my first attempt at using hash tables in a real application. :) Note that I canibalized a large chunk of getnetgrent.c to save myself from having to write my own netgroup parsing functions.
1995-10-26 16:25:29 +00:00
.\" Copyright (c) 1995
.\" Bill Paul <wpaul@ctr.columbia.edu>. All rights reserved.
.\"
.\" Redistribution and use in source and binary forms, with or without
.\" modification, are permitted provided that the following conditions
.\" are met:
.\" 1. Redistributions of source code must retain the above copyright
.\" notice, this list of conditions and the following disclaimer.
.\" 2. Redistributions in binary form must reproduce the above copyright
.\" notice, this list of conditions and the following disclaimer in the
.\" documentation and/or other materials provided with the distribution.
.\" 3. All advertising materials mentioning features or use of this software
.\" must display the following acknowledgement:
.\" This product includes software developed by Bill Paul.
.\" 4. Neither the name of the University nor the names of its contributors
.\" may be used to endorse or promote products derived from this software
.\" without specific prior written permission.
.\"
.\" THIS SOFTWARE IS PROVIDED BY Bill Paul AND CONTRIBUTORS ``AS IS'' AND
.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
.\" ARE DISCLAIMED. IN NO EVENT SHALL Bill Paul OR CONTRIBUTORS BE LIABLE
.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
.\" SUCH DAMAGE.
.\"
$Id$ -> $FreeBSD$
1999-08-28 00:22:10 +00:00
.\" $FreeBSD$
Import the first cut of my (finally finished) revnetgroup program. This program parses the /etc/netgroup file into netgroup.byuser and netgroup.byhost format for NIS. I used hash tables to store the initial netgroup data in memory and to construct the 'reverse' netgroup output. It seems just as fast as the SunOS revnetgroup, which is surprising considering this is my first attempt at using hash tables in a real application. :) Note that I canibalized a large chunk of getnetgrent.c to save myself from having to write my own netgroup parsing functions.
1995-10-26 16:25:29 +00:00
.\"
.Dd October 24, 1995
.Dt REVNETGROUP 8
.Os
.Sh NAME
.Nm revnetgroup
.Nd "generate reverse netgroup data"
.Sh SYNOPSIS
mdoc(7) police: use the new features of the Nm macro.
2000-11-20 14:42:24 +00:00
.Nm
Import the first cut of my (finally finished) revnetgroup program. This program parses the /etc/netgroup file into netgroup.byuser and netgroup.byhost format for NIS. I used hash tables to store the initial netgroup data in memory and to construct the 'reverse' netgroup output. It seems just as fast as the SunOS revnetgroup, which is surprising considering this is my first attempt at using hash tables in a real application. :) Note that I canibalized a large chunk of getnetgrent.c to save myself from having to write my own netgroup parsing functions.
1995-10-26 16:25:29 +00:00
.Fl u
Use warn(3). Hardcode progname instead of using argv[0]. Use Pa for file name.
1997-11-25 07:14:34 +00:00
.Op Fl f Ar netgroup_file
mdoc(7) police: use the new features of the Nm macro.
2000-11-20 14:42:24 +00:00
.Nm
Import the first cut of my (finally finished) revnetgroup program. This program parses the /etc/netgroup file into netgroup.byuser and netgroup.byhost format for NIS. I used hash tables to store the initial netgroup data in memory and to construct the 'reverse' netgroup output. It seems just as fast as the SunOS revnetgroup, which is surprising considering this is my first attempt at using hash tables in a real application. :) Note that I canibalized a large chunk of getnetgrent.c to save myself from having to write my own netgroup parsing functions.
1995-10-26 16:25:29 +00:00
.Fl h
.Op Fl f Ar netgroup_file
.Sh DESCRIPTION
The .Nm utility
2002-07-06 19:19:48 +00:00
The
.Nm
utility processes the contents of a file in
Import the first cut of my (finally finished) revnetgroup program. This program parses the /etc/netgroup file into netgroup.byuser and netgroup.byhost format for NIS. I used hash tables to store the initial netgroup data in memory and to construct the 'reverse' netgroup output. It seems just as fast as the SunOS revnetgroup, which is surprising considering this is my first attempt at using hash tables in a real application. :) Note that I canibalized a large chunk of getnetgrent.c to save myself from having to write my own netgroup parsing functions.
1995-10-26 16:25:29 +00:00
.Xr netgroup 5
format into what is called
.Pa reverse netgroup
form. That is, where the original file shows
netgroup memberships in terms of which members reside in a particular
group, the reverse netgroup format specifies what groups are associated
with a particular member. This information is used to generate the
Use warn(3). Hardcode progname instead of using argv[0]. Use Pa for file name.
1997-11-25 07:14:34 +00:00
.Pa netgroup.byuser
Import the first cut of my (finally finished) revnetgroup program. This program parses the /etc/netgroup file into netgroup.byuser and netgroup.byhost format for NIS. I used hash tables to store the initial netgroup data in memory and to construct the 'reverse' netgroup output. It seems just as fast as the SunOS revnetgroup, which is surprising considering this is my first attempt at using hash tables in a real application. :) Note that I canibalized a large chunk of getnetgrent.c to save myself from having to write my own netgroup parsing functions.
1995-10-26 16:25:29 +00:00
and
Use warn(3). Hardcode progname instead of using argv[0]. Use Pa for file name.
1997-11-25 07:14:34 +00:00
.Pa netgroup.byhosts
.Tn NIS
maps. These reverse netgroup maps are used to help speed up
Import the first cut of my (finally finished) revnetgroup program. This program parses the /etc/netgroup file into netgroup.byuser and netgroup.byhost format for NIS. I used hash tables to store the initial netgroup data in memory and to construct the 'reverse' netgroup output. It seems just as fast as the SunOS revnetgroup, which is surprising considering this is my first attempt at using hash tables in a real application. :) Note that I canibalized a large chunk of getnetgrent.c to save myself from having to write my own netgroup parsing functions.
1995-10-26 16:25:29 +00:00
netgroup lookups, particularly for the
.Fn innetgr
library function.
.Pp
For example, the standard
Use warn(3). Hardcode progname instead of using argv[0]. Use Pa for file name.
1997-11-25 07:14:34 +00:00
.Pa /etc/netgroup
Import the first cut of my (finally finished) revnetgroup program. This program parses the /etc/netgroup file into netgroup.byuser and netgroup.byhost format for NIS. I used hash tables to store the initial netgroup data in memory and to construct the 'reverse' netgroup output. It seems just as fast as the SunOS revnetgroup, which is surprising considering this is my first attempt at using hash tables in a real application. :) Note that I canibalized a large chunk of getnetgrent.c to save myself from having to write my own netgroup parsing functions.
1995-10-26 16:25:29 +00:00
file may list a netgroup and a list of its members. Here, the
netgroup is considered the
Use warn(3). Hardcode progname instead of using argv[0]. Use Pa for file name.
1997-11-25 07:14:34 +00:00
.Em key
Import the first cut of my (finally finished) revnetgroup program. This program parses the /etc/netgroup file into netgroup.byuser and netgroup.byhost format for NIS. I used hash tables to store the initial netgroup data in memory and to construct the 'reverse' netgroup output. It seems just as fast as the SunOS revnetgroup, which is surprising considering this is my first attempt at using hash tables in a real application. :) Note that I canibalized a large chunk of getnetgrent.c to save myself from having to write my own netgroup parsing functions.
1995-10-26 16:25:29 +00:00
and the member names are the
Use warn(3). Hardcode progname instead of using argv[0]. Use Pa for file name.
1997-11-25 07:14:34 +00:00
.Em data .
Import the first cut of my (finally finished) revnetgroup program. This program parses the /etc/netgroup file into netgroup.byuser and netgroup.byhost format for NIS. I used hash tables to store the initial netgroup data in memory and to construct the 'reverse' netgroup output. It seems just as fast as the SunOS revnetgroup, which is surprising considering this is my first attempt at using hash tables in a real application. :) Note that I canibalized a large chunk of getnetgrent.c to save myself from having to write my own netgroup parsing functions.
1995-10-26 16:25:29 +00:00
By contrast, the reverse
Use warn(3). Hardcode progname instead of using argv[0]. Use Pa for file name.
1997-11-25 07:14:34 +00:00
.Pa netgroup.byusers
Import the first cut of my (finally finished) revnetgroup program. This program parses the /etc/netgroup file into netgroup.byuser and netgroup.byhost format for NIS. I used hash tables to store the initial netgroup data in memory and to construct the 'reverse' netgroup output. It seems just as fast as the SunOS revnetgroup, which is surprising considering this is my first attempt at using hash tables in a real application. :) Note that I canibalized a large chunk of getnetgrent.c to save myself from having to write my own netgroup parsing functions.
1995-10-26 16:25:29 +00:00
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.
.Pp
By constructing these reverse netgroup databases (and the corresponding
Use warn(3). Hardcode progname instead of using argv[0]. Use Pa for file name.
1997-11-25 07:14:34 +00:00
.Tn NIS
maps) in advance, the
Import the first cut of my (finally finished) revnetgroup program. This program parses the /etc/netgroup file into netgroup.byuser and netgroup.byhost format for NIS. I used hash tables to store the initial netgroup data in memory and to construct the 'reverse' netgroup output. It seems just as fast as the SunOS revnetgroup, which is surprising considering this is my first attempt at using hash tables in a real application. :) Note that I canibalized a large chunk of getnetgrent.c to save myself from having to write my own netgroup parsing functions.
1995-10-26 16:25:29 +00:00
.Xr getnetgrent 3
library functions are spared from having to work out the dependencies
themselves on the fly. This is important on networks with large numbers
of users and hosts, since it can take a considerable amount of time
to process very large netgroup databases.
.Pp
The
Use warn(3). Hardcode progname instead of using argv[0]. Use Pa for file name.
1997-11-25 07:14:34 +00:00
.Nm
The .Nm utility
2002-07-06 19:19:48 +00:00
utility prints its results on the standard output. It is usually called
Import the first cut of my (finally finished) revnetgroup program. This program parses the /etc/netgroup file into netgroup.byuser and netgroup.byhost format for NIS. I used hash tables to store the initial netgroup data in memory and to construct the 'reverse' netgroup output. It seems just as fast as the SunOS revnetgroup, which is surprising considering this is my first attempt at using hash tables in a real application. :) Note that I canibalized a large chunk of getnetgrent.c to save myself from having to write my own netgroup parsing functions.
1995-10-26 16:25:29 +00:00
only by
Use warn(3). Hardcode progname instead of using argv[0]. Use Pa for file name.
1997-11-25 07:14:34 +00:00
.Pa /var/yp/Makefile
when rebuilding the
.Tn NIS
netgroup maps.
Import the first cut of my (finally finished) revnetgroup program. This program parses the /etc/netgroup file into netgroup.byuser and netgroup.byhost format for NIS. I used hash tables to store the initial netgroup data in memory and to construct the 'reverse' netgroup output. It seems just as fast as the SunOS revnetgroup, which is surprising considering this is my first attempt at using hash tables in a real application. :) Note that I canibalized a large chunk of getnetgrent.c to save myself from having to write my own netgroup parsing functions.
1995-10-26 16:25:29 +00:00
.Sh OPTIONS
The
Use warn(3). Hardcode progname instead of using argv[0]. Use Pa for file name.
1997-11-25 07:14:34 +00:00
.Nm
The .Nm utility
2002-07-06 19:19:48 +00:00
utility supports the following options:
Use warn(3). Hardcode progname instead of using argv[0]. Use Pa for file name.
1997-11-25 07:14:34 +00:00
.Bl -tag -width indent
Import the first cut of my (finally finished) revnetgroup program. This program parses the /etc/netgroup file into netgroup.byuser and netgroup.byhost format for NIS. I used hash tables to store the initial netgroup data in memory and to construct the 'reverse' netgroup output. It seems just as fast as the SunOS revnetgroup, which is surprising considering this is my first attempt at using hash tables in a real application. :) Note that I canibalized a large chunk of getnetgrent.c to save myself from having to write my own netgroup parsing functions.
1995-10-26 16:25:29 +00:00
.It Fl u
Use warn(3). Hardcode progname instead of using argv[0]. Use Pa for file name.
1997-11-25 07:14:34 +00:00
Generate
.Pa netgroup.byuser
output; only username information in the
Import the first cut of my (finally finished) revnetgroup program. This program parses the /etc/netgroup file into netgroup.byuser and netgroup.byhost format for NIS. I used hash tables to store the initial netgroup data in memory and to construct the 'reverse' netgroup output. It seems just as fast as the SunOS revnetgroup, which is surprising considering this is my first attempt at using hash tables in a real application. :) Note that I canibalized a large chunk of getnetgrent.c to save myself from having to write my own netgroup parsing functions.
1995-10-26 16:25:29 +00:00
original netgroup file is processed.
.It Fl h
Use warn(3). Hardcode progname instead of using argv[0]. Use Pa for file name.
1997-11-25 07:14:34 +00:00
Generate
.Pa netgroup.byhost
output; only hostname information in the
Import the first cut of my (finally finished) revnetgroup program. This program parses the /etc/netgroup file into netgroup.byuser and netgroup.byhost format for NIS. I used hash tables to store the initial netgroup data in memory and to construct the 'reverse' netgroup output. It seems just as fast as the SunOS revnetgroup, which is surprising considering this is my first attempt at using hash tables in a real application. :) Note that I canibalized a large chunk of getnetgrent.c to save myself from having to write my own netgroup parsing functions.
1995-10-26 16:25:29 +00:00
original netgroup file is processed. (Note at least one of the
.Fl u
or
.Fl h
flags must be specified.)
.It Op Fl f Ar netgroup_file
The
Use warn(3). Hardcode progname instead of using argv[0]. Use Pa for file name.
1997-11-25 07:14:34 +00:00
.Nm
The .Nm utility
2002-07-06 19:19:48 +00:00
utility uses
Use warn(3). Hardcode progname instead of using argv[0]. Use Pa for file name.
1997-11-25 07:14:34 +00:00
.Pa /etc/netgroup
Import the first cut of my (finally finished) revnetgroup program. This program parses the /etc/netgroup file into netgroup.byuser and netgroup.byhost format for NIS. I used hash tables to store the initial netgroup data in memory and to construct the 'reverse' netgroup output. It seems just as fast as the SunOS revnetgroup, which is surprising considering this is my first attempt at using hash tables in a real application. :) Note that I canibalized a large chunk of getnetgrent.c to save myself from having to write my own netgroup parsing functions.
1995-10-26 16:25:29 +00:00
as its default input file. The
.Fl f
flag allows the user to specify an alternate input file. Specifying ``-''
as the input file causes
Use warn(3). Hardcode progname instead of using argv[0]. Use Pa for file name.
1997-11-25 07:14:34 +00:00
.Nm
Import the first cut of my (finally finished) revnetgroup program. This program parses the /etc/netgroup file into netgroup.byuser and netgroup.byhost format for NIS. I used hash tables to store the initial netgroup data in memory and to construct the 'reverse' netgroup output. It seems just as fast as the SunOS revnetgroup, which is surprising considering this is my first attempt at using hash tables in a real application. :) Note that I canibalized a large chunk of getnetgrent.c to save myself from having to write my own netgroup parsing functions.
1995-10-26 16:25:29 +00:00
to read from the standard input.
.El
.Sh FILES
Use warn(3). Hardcode progname instead of using argv[0]. Use Pa for file name.
1997-11-25 07:14:34 +00:00
.Bl -tag -width /var/yp/Makefile -compact
Import the first cut of my (finally finished) revnetgroup program. This program parses the /etc/netgroup file into netgroup.byuser and netgroup.byhost format for NIS. I used hash tables to store the initial netgroup data in memory and to construct the 'reverse' netgroup output. It seems just as fast as the SunOS revnetgroup, which is surprising considering this is my first attempt at using hash tables in a real application. :) Note that I canibalized a large chunk of getnetgrent.c to save myself from having to write my own netgroup parsing functions.
1995-10-26 16:25:29 +00:00
.It Pa /var/yp/Makefile
Use warn(3). Hardcode progname instead of using argv[0]. Use Pa for file name.
1997-11-25 07:14:34 +00:00
the Makefile that calls
Import the first cut of my (finally finished) revnetgroup program. This program parses the /etc/netgroup file into netgroup.byuser and netgroup.byhost format for NIS. I used hash tables to store the initial netgroup data in memory and to construct the 'reverse' netgroup output. It seems just as fast as the SunOS revnetgroup, which is surprising considering this is my first attempt at using hash tables in a real application. :) Note that I canibalized a large chunk of getnetgrent.c to save myself from having to write my own netgroup parsing functions.
1995-10-26 16:25:29 +00:00
.Nm yp_mkdb
and
mdoc(7) police: use the new features of the Nm macro.
2000-11-20 14:42:24 +00:00
.Nm
Use warn(3). Hardcode progname instead of using argv[0]. Use Pa for file name.
1997-11-25 07:14:34 +00:00
to build the
.Tn NIS
databases
Import the first cut of my (finally finished) revnetgroup program. This program parses the /etc/netgroup file into netgroup.byuser and netgroup.byhost format for NIS. I used hash tables to store the initial netgroup data in memory and to construct the 'reverse' netgroup output. It seems just as fast as the SunOS revnetgroup, which is surprising considering this is my first attempt at using hash tables in a real application. :) Note that I canibalized a large chunk of getnetgrent.c to save myself from having to write my own netgroup parsing functions.
1995-10-26 16:25:29 +00:00
.It Pa /etc/netgroup
Use warn(3). Hardcode progname instead of using argv[0]. Use Pa for file name.
1997-11-25 07:14:34 +00:00
the default netgroup database file. This file is most often found
only on the
.Tn NIS
master server
Import the first cut of my (finally finished) revnetgroup program. This program parses the /etc/netgroup file into netgroup.byuser and netgroup.byhost format for NIS. I used hash tables to store the initial netgroup data in memory and to construct the 'reverse' netgroup output. It seems just as fast as the SunOS revnetgroup, which is surprising considering this is my first attempt at using hash tables in a real application. :) Note that I canibalized a large chunk of getnetgrent.c to save myself from having to write my own netgroup parsing functions.
1995-10-26 16:25:29 +00:00
.El
.Sh SEE ALSO
Sort cross references.
1997-01-13 00:25:51 +00:00
.Xr getnetgrent 3 ,
Import the first cut of my (finally finished) revnetgroup program. This program parses the /etc/netgroup file into netgroup.byuser and netgroup.byhost format for NIS. I used hash tables to store the initial netgroup data in memory and to construct the 'reverse' netgroup output. It seems just as fast as the SunOS revnetgroup, which is surprising considering this is my first attempt at using hash tables in a real application. :) Note that I canibalized a large chunk of getnetgrent.c to save myself from having to write my own netgroup parsing functions.
1995-10-26 16:25:29 +00:00
.Xr netgroup 5 ,
yp(4) -> yp(8). PR: docs/30797
2002-01-14 16:59:03 +00:00
.Xr yp 8 ,
Sort cross references.
1997-01-13 00:25:51 +00:00
.Xr yp_mkdb 8
.Sh AUTHOR -. .Sh AUTHORS. Use .An/.Aq.
1998-03-19 07:37:22 +00:00
.Sh AUTHORS
Use warn(3). Hardcode progname instead of using argv[0]. Use Pa for file name.
1997-11-25 07:14:34 +00:00
.An Bill Paul Aq wpaul@ctr.columbia.edu
Reference in New Issue Copy Permalink