summaryrefslogtreecommitdiff
path: root/usr.sbin/ypserv
diff options
context:
space:
mode:
authorAaron Campbell <aaron@cvs.openbsd.org>2000-03-19 17:57:20 +0000
committerAaron Campbell <aaron@cvs.openbsd.org>2000-03-19 17:57:20 +0000
commit480390dc59325200978ed49a1b26f00a94c91baa (patch)
tree062c09ac43a080a68cd77af35c77fcac0d938f46 /usr.sbin/ypserv
parentfb660b4c0cea9ae33d3d4dac0984c52ed7b6eeb0 (diff)
Remove hard sentence breaks. Add $OpenBSD$ tags where appropriate. Some other
cleanup along the way.
Diffstat (limited to 'usr.sbin/ypserv')
-rw-r--r--usr.sbin/ypserv/makedbm/makedbm.816
-rw-r--r--usr.sbin/ypserv/mkalias/mkalias.821
-rw-r--r--usr.sbin/ypserv/mknetid/mknetid.818
-rw-r--r--usr.sbin/ypserv/revnetgroup/revnetgroup.837
-rw-r--r--usr.sbin/ypserv/stdethers/stdethers.86
-rw-r--r--usr.sbin/ypserv/stdhosts/stdhosts.86
-rw-r--r--usr.sbin/ypserv/ypinit/ypinit.812
-rw-r--r--usr.sbin/ypserv/yppush/yppush.810
-rw-r--r--usr.sbin/ypserv/ypserv/ypserv.826
-rw-r--r--usr.sbin/ypserv/yptest/yptest.83
-rw-r--r--usr.sbin/ypserv/ypxfr/ypxfr.819
11 files changed, 109 insertions, 65 deletions
diff --git a/usr.sbin/ypserv/makedbm/makedbm.8 b/usr.sbin/ypserv/makedbm/makedbm.8
index 8201bd83aa5..d54aed296fa 100644
--- a/usr.sbin/ypserv/makedbm/makedbm.8
+++ b/usr.sbin/ypserv/makedbm/makedbm.8
@@ -1,4 +1,5 @@
-.\" $OpenBSD: makedbm.8,v 1.7 1999/06/05 22:18:23 aaron Exp $
+.\" $OpenBSD: makedbm.8,v 1.8 2000/03/19 17:57:18 aaron Exp $
+.\"
.\" Copyright (c) 1994-97 Mats O Jansson <moj@stacken.kth.se>
.\" All rights reserved.
.\"
@@ -63,14 +64,17 @@ but also try
.Xr db 3
hash format.
.It Fl b
-Interdomain. Include an entry in the database informing a YP server to use
-DNS to get information about unknown hosts. This option will only have
+Interdomain.
+Include an entry in the database informing a YP server to use
+DNS to get information about unknown hosts.
+This option will only have
effect on the two maps hosts.byname and hosts.byaddr.
.It Fl l
-Lowercase. Convert all keys to lower case before adding them to the YP
-database.
+Lowercase.
+Convert all keys to lower case before adding them to the YP database.
.It Fl s
-Secure map. Include an entry in the database informing
+Secure map.
+Include an entry in the database informing
.Xr ypxfr 8
and
.Xr ypserv 8
diff --git a/usr.sbin/ypserv/mkalias/mkalias.8 b/usr.sbin/ypserv/mkalias/mkalias.8
index 333edf91e62..d9c948483ab 100644
--- a/usr.sbin/ypserv/mkalias/mkalias.8
+++ b/usr.sbin/ypserv/mkalias/mkalias.8
@@ -1,4 +1,5 @@
-.\" $OpenBSD: mkalias.8,v 1.3 1999/06/05 22:18:24 aaron Exp $
+.\" $OpenBSD: mkalias.8,v 1.4 2000/03/19 17:57:18 aaron Exp $
+.\"
.\" Copyright (c) 1997 Mats O Jansson <moj@stacken.kth.se>
.\" All rights reserved.
.\"
@@ -46,8 +47,8 @@
.Op Ar output
.Sh DESCRIPTION
.Nm
-is used to convert a mail.aliases map to a mail.byaddr map. This is
-an inverse map of user@host (or user!host) back to alias.
+is used to convert a mail.aliases map to a mail.byaddr map.
+This is an inverse map of user@host (or user!host) back to alias.
.Pp
.Pp
The options are as follows:
@@ -61,21 +62,24 @@ Same as
.Fl e ,
but also check for any MX-record.
.It Fl d
-Assume Domain names are OK. Only useful together with
+Assume Domain names are OK.
+Only useful together with
.Fl e
or
.Fl E .
.It Fl u
-Assume UUCP names are OK. Only useful together with
+Assume UUCP names are OK.
+Only useful together with
.Fl e
or
.Fl E .
.It Fl n
-Capitalize name. eg mats.o.jansson becomes Mats.O.Jansson.
+Capitalize name. e.g., mats.o.jansson becomes Mats.O.Jansson.
.It Ar input
Use this map as input.
.It Ar output
-Use this map as output. If the output map isn't given don't create database.
+Use this map as output.
+If the output map isn't given don't create database.
Can be useful together with
.Fl e
or
@@ -85,7 +89,8 @@ or
.Nm
on SunOS 4.1.x seems to have a
.Fl s .
-Since I don't know what it is supposed to do I haven't implemented it. But it is accepted by the program.
+Since I don't know what it is supposed to do I haven't implemented it.
+But it is accepted by the program.
.Sh SEE ALSO
.Xr yp 8 ,
.Xr ypserv 8
diff --git a/usr.sbin/ypserv/mknetid/mknetid.8 b/usr.sbin/ypserv/mknetid/mknetid.8
index f624915e659..f17b6718b44 100644
--- a/usr.sbin/ypserv/mknetid/mknetid.8
+++ b/usr.sbin/ypserv/mknetid/mknetid.8
@@ -1,4 +1,5 @@
-.\" $OpenBSD: mknetid.8,v 1.6 1999/06/05 22:18:25 aaron Exp $
+.\" $OpenBSD: mknetid.8,v 1.7 2000/03/19 17:57:18 aaron Exp $
+.\"
.\" Copyright (c) 1996 Mats O Jansson <moj@stacken.kth.se>
.\" All rights reserved.
.\"
@@ -60,26 +61,31 @@ The options are as follows:
.It Fl d Ar domain
Which yp-domain if not default yp-domain.
.It Fl q
-Keep quiet about multiple occurrences of a UID. Ignore all but the first.
+Keep quiet about multiple occurrences of a UID.
+Ignore all but the first.
.It Fl p Ar passwdfile
Alternate
.Xr passwd 5
-file. Default is
+file.
+Default is
.Pa /etc/passwd .
.It Fl g Ar groupfile
Alternate
.Xr group 5
-file. Default is
+file.
+Default is
.Pa /etc/group .
.It Fl h Ar hostfile
Alternate
.Xr hosts 5
-file. Default is
+file.
+Default is
.Pa /etc/hosts .
.It Fl m Ar netidfile
Alternate
.Xr netid 5
-file. Default is
+file.
+Default is
.Pa /etc/netid .
file.
.El
diff --git a/usr.sbin/ypserv/revnetgroup/revnetgroup.8 b/usr.sbin/ypserv/revnetgroup/revnetgroup.8
index 3ef4ecc376e..799014fa2f1 100644
--- a/usr.sbin/ypserv/revnetgroup/revnetgroup.8
+++ b/usr.sbin/ypserv/revnetgroup/revnetgroup.8
@@ -1,4 +1,5 @@
-.\" $OpenBSD: revnetgroup.8,v 1.4 1999/07/03 02:11:11 aaron Exp $
+.\" $OpenBSD: revnetgroup.8,v 1.5 2000/03/19 17:57:18 aaron Exp $
+.\"
.\" Copyright (c) 1995
.\" Bill Paul <wpaul@ctr.columbia.edu>. All rights reserved.
.\"
@@ -48,22 +49,25 @@ 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
.Nm netgroup.byuser
and
.Nm netgroup.byhosts
-YP maps. These reverse netgroup maps are used to help speed up
+YP 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
.Nm /etc/netgroup
-file may list a netgroup and a list of its members. Here, the
-netgroup is considered the
+file may list a netgroup and a list of its members.
+Here, the netgroup is considered the
.Pa key
and the member names are the
.Pa data .
@@ -71,7 +75,8 @@ By contrast, the reverse
.Nm 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
@@ -79,14 +84,15 @@ By constructing these reverse netgroup databases (and the corresponding
YP 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 revnetgroup
-command prints its results on the standard output. It is usually called
-only by
+command prints its results on the standard output.
+It is usually called only by
.Nm /var/yp/\<domain\>/Makefile
when rebuilding the YP netgroup maps.
.Sh OPTIONS
@@ -109,9 +115,12 @@ The
.Nm revnetgroup
command uses
.Nm /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
+.Dq -
as the input file causes
.Nm revnetgroup
to read from the standard input.
@@ -125,8 +134,8 @@ and
.Nm revnetgroup
to build the YP databases.
.It Pa /etc/netgroup
-The default netgroup database file. This file is most often found
-only on the YP master server.
+The default netgroup database file.
+This file is most often found only on the YP master server.
.El
.Sh SEE ALSO
.Xr getnetgrent 3 ,
diff --git a/usr.sbin/ypserv/stdethers/stdethers.8 b/usr.sbin/ypserv/stdethers/stdethers.8
index 7d166defe5b..eff0ff6988f 100644
--- a/usr.sbin/ypserv/stdethers/stdethers.8
+++ b/usr.sbin/ypserv/stdethers/stdethers.8
@@ -1,4 +1,5 @@
-.\" $OpenBSD: stdethers.8,v 1.6 1999/07/03 02:11:11 aaron Exp $
+.\" $OpenBSD: stdethers.8,v 1.7 2000/03/19 17:57:18 aaron Exp $
+.\"
.\" Copyright (c) 1995 Mats O Jansson <moj@stacken.kth.se>
.\" All rights reserved.
.\"
@@ -43,7 +44,8 @@ is used to get rid of unwanted information in
.Ar file ,
or the standard input if no
.Ar file
-argument is given. This utility is used by YP when creating YP maps.
+argument is given.
+This utility is used by YP when creating YP maps.
.Sh SEE ALSO
.Xr yp 8 ,
.Xr ypserv 8
diff --git a/usr.sbin/ypserv/stdhosts/stdhosts.8 b/usr.sbin/ypserv/stdhosts/stdhosts.8
index e709bfe44d5..0e00c8c7849 100644
--- a/usr.sbin/ypserv/stdhosts/stdhosts.8
+++ b/usr.sbin/ypserv/stdhosts/stdhosts.8
@@ -1,4 +1,5 @@
-.\" $OpenBSD: stdhosts.8,v 1.7 1999/07/03 02:11:11 aaron Exp $
+.\" $OpenBSD: stdhosts.8,v 1.8 2000/03/19 17:57:18 aaron Exp $
+.\"
.\" Copyright (c) 1994 Mats O Jansson <moj@stacken.kth.se>
.\" All rights reserved.
.\"
@@ -43,7 +44,8 @@ is used to get rid of unwanted information from
.Ar file ,
or the standard input if no
.Ar file
-argument is given. This utility is used by YP when creating YP maps.
+argument is given.
+This utility is used by YP when creating YP maps.
.Sh SEE ALSO
.Xr yp 8 ,
.Xr ypserv 8
diff --git a/usr.sbin/ypserv/ypinit/ypinit.8 b/usr.sbin/ypserv/ypinit/ypinit.8
index ef8b9bfc569..4bac2dc1d1e 100644
--- a/usr.sbin/ypserv/ypinit/ypinit.8
+++ b/usr.sbin/ypserv/ypinit/ypinit.8
@@ -1,4 +1,5 @@
-.\" $OpenBSD: ypinit.8,v 1.3 1999/06/05 22:18:30 aaron Exp $
+.\" $OpenBSD: ypinit.8,v 1.4 2000/03/19 17:57:19 aaron Exp $
+.\"
.\" Copyright (c) 1997 Mats O Jansson <moj@stacken.kth.se>
.\" All rights reserved.
.\"
@@ -48,17 +49,20 @@ may be used to setup a YP server, or to change the ypserver map.
The options are as follows:
.Bl -tag -width indent
.It Fl m Ar domainname
-Setup a master YP server. If
+Setup a master YP server.
+If
.Ar domainname
is not given the default domainname will be used.
.It Fl s Ar master_server Op Ar domainname
-Setup a slave YP server. If
+Setup a slave YP server.
+If
.Ar domainname
is not given the default domainname will be used.
.Ar master_server
must be a running YP master server.
.It Fl u Op Ar domainname
-Update the ypserver map on a YP master server. If
+Update the ypserver map on a YP master server.
+If
.Ar domainname
is not given the default domainname will be used.
.El
diff --git a/usr.sbin/ypserv/yppush/yppush.8 b/usr.sbin/ypserv/yppush/yppush.8
index 0c6296c9c2f..61f82ba6798 100644
--- a/usr.sbin/ypserv/yppush/yppush.8
+++ b/usr.sbin/ypserv/yppush/yppush.8
@@ -1,4 +1,5 @@
-.\" $OpenBSD: yppush.8,v 1.5 1999/06/05 22:18:31 aaron Exp $
+.\" $OpenBSD: yppush.8,v 1.6 2000/03/19 17:57:19 aaron Exp $
+.\"
.\" Copyright (c) 1995 Mats O Jansson <moj@stacken.kth.se>
.\" All rights reserved.
.\"
@@ -45,8 +46,8 @@
.Sh DESCRIPTION
.Nm yppush
is used to distribute an YP map from a master server to any
-slave server in the domain. All servers of the domain is fetched from the YP
-map ypservers.
+slave server in the domain.
+All servers of the domain is fetched from the YP map ypservers.
.Pp
The options are as follows:
.Bl -tag -width indent
@@ -59,7 +60,8 @@ Distribute map only to one host and not to the hosts in the ypserver map.
.\".It Fl t Ar timeout
.\"Set the amount of time to elapse before a timeout is registered.
.It Fl v
-Verbose. Announce what the program is doing.
+Verbose.
+Announce what the program is doing.
.El
.Sh SEE ALSO
.Xr yp 8 ,
diff --git a/usr.sbin/ypserv/ypserv/ypserv.8 b/usr.sbin/ypserv/ypserv/ypserv.8
index fbf58c4ac83..efcbc4a2ee3 100644
--- a/usr.sbin/ypserv/ypserv/ypserv.8
+++ b/usr.sbin/ypserv/ypserv/ypserv.8
@@ -1,4 +1,5 @@
-.\" $OpenBSD: ypserv.8,v 1.13 1999/06/05 22:18:33 aaron Exp $
+.\" $OpenBSD: ypserv.8,v 1.14 2000/03/19 17:57:19 aaron Exp $
+.\"
.\" Copyright (c) 1994 Mats O Jansson <moj@stacken.kth.se>
.\" All rights reserved.
.\"
@@ -48,18 +49,21 @@ on the network.
.Pp
A YP map is stored on the server as a
.Xr db 3
-database. A number of YP maps is grouped together in a domain.
+database.
+A number of YP maps is grouped together in a domain.
.Nm
determines the domains it serves by looking for a directory with
the domain name in
.Pa /var/yp .
.Pp
-YP hasn't been known for high security through the years. In recent years
-security has improved by restricting access to the server. In SunOS 4.1
+YP hasn't been known for high security through the years.
+In recent years
+security has improved by restricting access to the server.
+In SunOS 4.1
has a new file occurred named
.Pa /var/yp/securenet .
-It contains networks the server can assume is secure. For information about
-file format see
+It contains networks the server can assume is secure.
+For information about file format see
.Xr securenet 5 .
.Pp
Before the author of this server had seen
@@ -68,8 +72,8 @@ another format,
.Xr ypserv.acl 5 ,
was implemented.
This file format makes it possible to allow and deny hosts and networks
-access to the server. This file can have any name since it's given by
-the argument to
+access to the server.
+This file can have any name since it's given by the argument to
.Fl a
(use full path).
.Pp
@@ -107,10 +111,12 @@ to answer old YP version 1 requests.
.It Fl a Ar aclfile
Don't use
.Pa /var/yp/securenet .
-Use another file with a different file format. For further information see
+Use another file with a different file format.
+For further information see
.Xr ypserv.acl 5 .
.It Fl d
-Use Internet Domain Name System. If a query to map
+Use Internet Domain Name System.
+If a query to map
.Dq hosts.byname
or
.Dq hosts.byaddr
diff --git a/usr.sbin/ypserv/yptest/yptest.8 b/usr.sbin/ypserv/yptest/yptest.8
index 469897e0b59..9548f7cd072 100644
--- a/usr.sbin/ypserv/yptest/yptest.8
+++ b/usr.sbin/ypserv/yptest/yptest.8
@@ -1,4 +1,5 @@
-.\" $OpenBSD: yptest.8,v 1.6 1999/06/05 22:18:35 aaron Exp $
+.\" $OpenBSD: yptest.8,v 1.7 2000/03/19 17:57:19 aaron Exp $
+.\"
.\" Copyright (c) 1994 Mats O Jansson <moj@stacken.kth.se>
.\" All rights reserved.
.\"
diff --git a/usr.sbin/ypserv/ypxfr/ypxfr.8 b/usr.sbin/ypserv/ypxfr/ypxfr.8
index 7d1092569a9..f0815df3292 100644
--- a/usr.sbin/ypserv/ypxfr/ypxfr.8
+++ b/usr.sbin/ypserv/ypxfr/ypxfr.8
@@ -1,4 +1,5 @@
-.\" $OpenBSD: ypxfr.8,v 1.8 1999/06/05 22:18:36 aaron Exp $
+.\" $OpenBSD: ypxfr.8,v 1.9 2000/03/19 17:57:19 aaron Exp $
+.\"
.\" Copyright (c) 1994 Mats O Jansson <moj@stacken.kth.se>
.\" All rights reserved.
.\"
@@ -28,7 +29,7 @@
.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
.\" SUCH DAMAGE.
.\"
-.\" $OpenBSD: ypxfr.8,v 1.8 1999/06/05 22:18:36 aaron Exp $
+.\" $OpenBSD: ypxfr.8,v 1.9 2000/03/19 17:57:19 aaron Exp $
.\"
.Dd August 18, 1994
.Dt YPXFR 8
@@ -49,7 +50,8 @@
is the utiliy in YP that transfers maps to the local host.
.Pp
Since the YP master transfers a map when it has changed, an YP slave should
-check for missed maps regulary. This can be done via an entry in
+check for missed maps regulary.
+This can be done via an entry in
.Xr crontab 5 .
The scripts
.Ar ypxfr_1perhour , ypxfr_2perday
@@ -61,11 +63,12 @@ The options are as follows:
.Bl -tag -width indent
.It Fl b
Preserve the entry in the database informing a YP server to use
-DNS to get information about unknown hosts. This option will only have
+DNS to get information about unknown hosts.
+This option will only have
effect on the two maps hosts.byname and hosts.byaddr.
.It Fl c
-Don't send a "Clear current map" to local ypserv process. Useful if ypserv
-isn't running localy to avoid timeout message.
+Don't send a "Clear current map" to local ypserv process.
+Useful if ypserv isn't running localy to avoid timeout message.
.It Fl f
Force map transfer, even if version of master is older than local copy.
.It Fl d Ar domain
@@ -75,8 +78,8 @@ Get map from host instead of the maps master host.
.It Fl s Ar domain
Specify a source domain other than the target domain.
.It Fl C Ar tid prog ipadd port
-This option is only used by ypserv. This is to open communication with
-an yppush on another host.
+This option is only used by ypserv.
+This is to open communication with a yppush on another host.
.El
.Sh FILES
.Bl -tag -width /usr/sbin/ypxfr_1perhour -compact