summaryrefslogtreecommitdiffstats
path: root/libexec/revnetgroup
diff options
context:
space:
mode:
authorru <ru@FreeBSD.org>2004-07-02 21:28:50 +0000
committerru <ru@FreeBSD.org>2004-07-02 21:28:50 +0000
commit20fbd172b22ab587e9d796f4cb8664a235cebe78 (patch)
treeeb02ffe4de6f83302cc7418e7e9a79349dcf6789 /libexec/revnetgroup
parentdebcc07b3a783cc266d834911f64c8c6310602e9 (diff)
downloadFreeBSD-src-20fbd172b22ab587e9d796f4cb8664a235cebe78.zip
FreeBSD-src-20fbd172b22ab587e9d796f4cb8664a235cebe78.tar.gz
Mechanically kill hard sentence breaks.
Diffstat (limited to 'libexec/revnetgroup')
-rw-r--r--libexec/revnetgroup/revnetgroup.833
1 files changed, 22 insertions, 11 deletions
diff --git a/libexec/revnetgroup/revnetgroup.8 b/libexec/revnetgroup/revnetgroup.8
index 18bfa2b..9a6258a 100644
--- a/libexec/revnetgroup/revnetgroup.8
+++ b/libexec/revnetgroup/revnetgroup.8
@@ -50,22 +50,26 @@ utility processes the contents of a file in
.Xr netgroup 5
format into what is called
.Pa reverse netgroup
-form. That is, where the original file shows
+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
+with a particular member.
+This information is used to generate the
.Pa netgroup.byuser
and
.Pa netgroup.byhosts
.Tn NIS
-maps. These reverse netgroup maps are used to help speed up
+maps.
+These reverse netgroup maps are used to help speed up
netgroup lookups, particularly for the
.Fn innetgr
library function.
.Pp
For example, the standard
.Pa /etc/netgroup
-file may list a netgroup and a list of its members. Here, the
+file may list a netgroup and a list of its members.
+Here, the
netgroup is considered the
.Em key
and the member names are the
@@ -74,7 +78,8 @@ By contrast, the reverse
.Pa netgroup.byusers
database lists each unique
member as the key and the netgroups to which the members belong become
-the data. Separate databases are created to hold information pertaining
+the data.
+Separate 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
@@ -83,13 +88,15 @@ By constructing these reverse netgroup databases (and the corresponding
maps) in advance, the
.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
+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
.Nm
-utility prints its results on the standard output. It is usually called
+utility prints its results on the standard output.
+It is usually called
only by
.Pa /var/yp/Makefile
when rebuilding the
@@ -109,7 +116,8 @@ original netgroup file is processed.
Generate
.Pa netgroup.byhost
output; only hostname information in the
-original netgroup file is processed. (Note at least one of the
+original netgroup file is processed.
+(Note at least one of the
.Fl u
or
.Fl h
@@ -119,9 +127,11 @@ The
.Nm
utility uses
.Pa /etc/netgroup
-as its default input file. The
+as its default input file.
+The
.Fl f
-flag allows the user to specify an alternate input file. Specifying ``-''
+flag allows the user to specify an alternate input file.
+Specifying ``-''
as the input file causes
.Nm
to read from the standard input.
@@ -137,7 +147,8 @@ to build the
.Tn NIS
databases
.It Pa /etc/netgroup
-the default netgroup database file. This file is most often found
+the default netgroup database file.
+This file is most often found
only on the
.Tn NIS
master server
OpenPOWER on IntegriCloud