summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorAaron Campbell <aaron@cvs.openbsd.org>1999-03-01 06:02:51 +0000
committerAaron Campbell <aaron@cvs.openbsd.org>1999-03-01 06:02:51 +0000
commit98bd0f53979c247f5e277c5bb76ce12c4933513f (patch)
treedc8a37cc595250c337df89ce4229a93e0b8cac36
parent5ba12d137211cbf792d84bf06eac1bed06e6855e (diff)
.Ar -> .Pa, rearrange Xr's, remove redundant .Nm arguments, other cleanup; d@
-rw-r--r--usr.sbin/ypserv/ypserv/ypserv.865
1 files changed, 36 insertions, 29 deletions
diff --git a/usr.sbin/ypserv/ypserv/ypserv.8 b/usr.sbin/ypserv/ypserv/ypserv.8
index cc34665acc8..cb826bfadb6 100644
--- a/usr.sbin/ypserv/ypserv/ypserv.8
+++ b/usr.sbin/ypserv/ypserv/ypserv.8
@@ -1,4 +1,4 @@
-.\" $OpenBSD: ypserv.8,v 1.10 1998/09/01 16:38:25 deraadt Exp $
+.\" $OpenBSD: ypserv.8,v 1.11 1999/03/01 06:02:50 aaron Exp $
.\" Copyright (c) 1994 Mats O Jansson <moj@stacken.kth.se>
.\" All rights reserved.
.\"
@@ -35,13 +35,13 @@
.Nm ypserv
.Nd YP server daemon
.Sh SYNOPSIS
-.Nm ypserv
+.Nm
.Op Fl 1
.Op Fl a Ar aclfile
.Op Fl d
.Op Fl x
.Sh DESCRIPTION
-.Nm Ypserv
+.Nm
is a fundamental part of the network information system called YP.
This server provides information from YP maps to the YP clients
on the network.
@@ -49,64 +49,71 @@ on the network.
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.
-.Ar Ypserv
+.Nm
determines the domains it serves by looking for a directory with
the domain name in
-.Ar /var/yp .
+.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
has a new file occurred named
-.Ar /var/yp/securenet .
+.Pa /var/yp/securenet .
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
.Xr securenet 5
-another format was implemented
-.Xr ypserv.acl 5 .
+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
.Fl a
(use full path).
.Pp
-The file used can be reread by sending a SIGHUP to ypserv. The process pid
+The file used can be reread by sending a
+.Dv SIGHUP
+to
+.Nm ypserv .
+The process PID
can be found in the file
-.Nm /var/run/ypserv.pid
-.
+.Pa /var/run/ypserv.pid .
.Pp
If a host isn't secure all queries to the server will result in a YP_NODOM
result.
.Pp
If the file
-.Nm /var/yp/ypserv.log
+.Pa /var/yp/ypserv.log
exists then messages will be written to the file.
.Pp
If a directory named the same as the system domainname exists in
-.Nm /var/yp/
-(ie. the domainname is
-.Nm foo
-and directory
-.Nm /var/yp/foo
-exists), then ypserv will be automatically started at boot time.
+.Pa /var/yp
+(i.e., the domainname is
+.Dq foo
+and the directory
+.Pa /var/yp/foo
+exists), then
+.Nm
+will be automatically started at boot time.
.Pp
The options are as follows:
.Bl -tag -width indent
.It Fl 1
-Allow ypserv to answer old YP version 1 requests.
+Allow
+.Nm
+to answer old YP version 1 requests.
.It Fl a Ar aclfile
Don't use
-.Ar /var/yp/securenet .
-Use another file with another file format. For futher information see
-man page for
-.Ar ypserv.acl .
+.Pa /var/yp/securenet .
+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
-.Ar hosts.byname
+.Dq hosts.byname
or
-.Ar hosts.byaddr
+.Dq hosts.byaddr
fails, make a DNS query and return the result if successful.
Alternately, if these maps were built on the YP master using
.Nm makedbm
@@ -117,7 +124,7 @@ then DNS queries will be done without needing to specify
Terminate the server after processing
.Ar aclfile
or
-.Ar /var/yp/securenet .
+.Pa /var/yp/securenet .
.El
.Sh FILES
.Bl -tag -width /var/yp/ypserv.log -compact
@@ -126,9 +133,9 @@ or
.It Pa /var/run/ypserv.pid
.El
.Sh SEE ALSO
-.Xr yp 8 ,
-.Xr ypserv.acl 5 ,
+.Xr ypbind 1 ,
.Xr securenet 5 ,
-.Xr ypbind 1
+.Xr ypserv.acl 5 ,
+.Xr yp 8
.Sh AUTHOR
Mats O Jansson <moj@stacken.kth.se>