diff options
author | Aaron Campbell <aaron@cvs.openbsd.org> | 2000-03-19 17:57:20 +0000 |
---|---|---|
committer | Aaron Campbell <aaron@cvs.openbsd.org> | 2000-03-19 17:57:20 +0000 |
commit | 480390dc59325200978ed49a1b26f00a94c91baa (patch) | |
tree | 062c09ac43a080a68cd77af35c77fcac0d938f46 /usr.sbin/ypserv | |
parent | fb660b4c0cea9ae33d3d4dac0984c52ed7b6eeb0 (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.8 | 16 | ||||
-rw-r--r-- | usr.sbin/ypserv/mkalias/mkalias.8 | 21 | ||||
-rw-r--r-- | usr.sbin/ypserv/mknetid/mknetid.8 | 18 | ||||
-rw-r--r-- | usr.sbin/ypserv/revnetgroup/revnetgroup.8 | 37 | ||||
-rw-r--r-- | usr.sbin/ypserv/stdethers/stdethers.8 | 6 | ||||
-rw-r--r-- | usr.sbin/ypserv/stdhosts/stdhosts.8 | 6 | ||||
-rw-r--r-- | usr.sbin/ypserv/ypinit/ypinit.8 | 12 | ||||
-rw-r--r-- | usr.sbin/ypserv/yppush/yppush.8 | 10 | ||||
-rw-r--r-- | usr.sbin/ypserv/ypserv/ypserv.8 | 26 | ||||
-rw-r--r-- | usr.sbin/ypserv/yptest/yptest.8 | 3 | ||||
-rw-r--r-- | usr.sbin/ypserv/ypxfr/ypxfr.8 | 19 |
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 |