YP(8)                   OpenBSD System Manager's Manual                  YP(8)

NAME
     yp - description of the YP subsystem



SYNOPSIS
     ypinit [-m] domain
     ypinit [-s] server domain

     ypbind [-ypset]
     ypbind [-ypsetme]

     ypset [-h host] [-d domain] server

     yppoll [-h host] [-d domain] mapname

     ypcat [-kt] [-d domainname] mapname
     ypcat -x

     ypmatch [-kt] [-d domainname] key ... mapname
     ypmatch -x

     ypwhich [-d domain] [[-t] -m [mname] | host]
     ypwhich -x

     ypserv [-a aclfile] [-d] [-x]

     ypxfr [-bcf] [-d domain] [-h host] [-s domain] [-C tid prog ipadd port]
            mapname

     yppush [-d domainname] [-h hostname] [-v] mapname

DESCRIPTION
     The YP subsystem allows network management of passwd, group, and hosts
     file entries through the functions getpwent(3),  getgrent(3) and gethost-
     byname(3) (as well as number of other databases and functions).  YP also
     provides hooks for numerous other client programs such as amd(8) and
     bootparamd(8) to access distributed and shareable versions of their maps
     through YP.

     ypinit is used to initialize YP as a server or master.  This creates var-
     ious files in /var/yp. If setup as a server, the required databases are
     automatically copied from the specified server.

     The YP client subsystem is started automatically in /etc/rc if the direc-
     tory /var/yp/binding exists.  The client subsystem can be turned on and
     off by creating or deleting that directory.  ypbind(8) will create that
     directory if run by hand.

     The YP server subsystem is started automatically in /etc/rc if the direc-
     tory /var/yp/DOMAINNAME exists.  This directory is automatically created
     by ypinit(8) (which initializes the machine as a YP server.)

     If ypbind cannot find a server, the system behaves the same way as Sun's
     code does: it hangs.

SEE ALSO
     domainname(1),  group(5),  passwd(5),  ypbind(8),  ypcat(1),  yppoll(8),
     ypmatch(1),  ypset(8),  ypwhich(1),  ypclnt(3),  ypserv(8),  ypinit(8),
     yppush(8),  ypxfr(8),  rpc.yppasswdd(8)

HISTORY
     This free YP subsystem is thought to be compatible with Sun's implementa-
     tion.  The name YP stands for Yellow Pee.


     The ypbind, library components, and userland programs were implemented by
     Theo de Raadt <deraadt@theos.com>.  The server component was implemented
     by Mats O Jansson <moj@stacken.kth.se>.

OpenBSD 2.3                      April 5, 1993                               2