1.\" $NetBSD: ypserv.8,v 1.14 2002/02/08 01:38:58 ross Exp $ 2.\" 3.\" Copyright (c) 1994 Mats O Jansson <moj@stacken.kth.se> 4.\" All rights reserved. 5.\" 6.\" Redistribution and use in source and binary forms, with or without 7.\" modification, are permitted provided that the following conditions 8.\" are met: 9.\" 1. Redistributions of source code must retain the above copyright 10.\" notice, this list of conditions and the following disclaimer. 11.\" 2. Redistributions in binary form must reproduce the above copyright 12.\" notice, this list of conditions and the following disclaimer in the 13.\" documentation and/or other materials provided with the distribution. 14.\" 3. All advertising materials mentioning features or use of this software 15.\" must display the following acknowledgement: 16.\" This product includes software developed by Mats O Jansson 17.\" 4. The name of the author may not be used to endorse or promote products 18.\" derived from this software without specific prior written permission. 19.\" 20.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS 21.\" OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED 22.\" WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE 23.\" ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY 24.\" DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL 25.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS 26.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) 27.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT 28.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY 29.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF 30.\" SUCH DAMAGE. 31.\" 32.Dd June 27, 1994 33.Dt YPSERV 8 34.Os 35.Sh NAME 36.Nm ypserv 37.Nd YP server daemon 38.Sh SYNOPSIS 39.Nm "" 40.Op Fl dfl 41.Sh DESCRIPTION 42.Nm 43is a fundamental part of the network information system called 44.Tn YP . 45This server provides information from 46.Tn YP 47maps to the 48.Tn YP 49clients on the network. 50.Pp 51A 52.Tn YP 53map is stored on the server as a 54.Xr db 3 55database. A number of 56.Tn YP 57maps is grouped together in a domain. 58.Nm 59determines the domains it serves by looking for a directory with 60the domain name in 61.Ar /var/yp . 62.Pp 63In an effort to improve the security of 64.Tn YP 65(which has, historically, not been very good), this 66.Nm 67has support for libwrap-based access control. See 68.Xr hosts_access 5 69for more information. The 70.Em daemon 71used for access control is the name which 72.Nm 73was invoked as (typically 74.Dq ypserv 75). If a host is not allowed to query this 76.Tn YP 77server, 78.Nm 79will return the 80.Tn YP 81result code YP_NODOM. 82.Pp 83The process pid of the 84.Nm 85process can be found in the file 86.Pa /var/run/ypserv.pid . 87.Pp 88The options are as follows: 89.Bl -tag -width indent 90.It Fl d 91Use internet Domain Name System. If a query to map 92.Pa hosts.byname 93or 94.Pa hosts.byaddr 95fails, make a DNS query and return the result if successful. 96.It Fl f 97Run in the foreground. 98.It Fl l 99Enable logging of all requests. 100.El 101.Pp 102All messages are sent to the system log with the facility LOG_DAEMON. 103Error messages have the priority LOG_ERR. Refused requests are logged 104with the priority LOG_WARNING. All other messages are logged with the 105priority LOG_INFO. 106.Sh FILES 107.Bl -tag -width /var/run/ypserv.pid -compact 108.It Pa /var/run/ypserv.pid 109.El 110.Sh SEE ALSO 111.Xr syslog 3 , 112.Xr hosts_access 5 , 113.Xr syslogd 8 , 114.Xr yp 8 , 115.Xr ypbind 8 , 116.Xr ypinit 8 117.Sh AUTHORS 118This implementation of 119.Nm 120was originally written by Mats O Jansson \*[Lt]moj@stacken.kth.se\*[Gt]. 121The access control code was later re-written from scratch by 122Jason R. Thorpe \*[Lt]thorpej@NetBSD.ORG\*[Gt]. 123