ypmake(1M)

NAME
     ypmake - rebuild and distribute NIS databases

SYNOPSIS
     /var/yp/ypmake [ [ make-options ] map ]

DESCRIPTION
     On NIS master machines, ypmake uses the file /var/yp/make.script and the
     optional file /var/yp/local.make.script to build the network information
     service (NIS) databases.  With no arguments, ypmake creates dbm(3B)
     databases for any NIS maps that are out-of-date, and then executes
     yppush(1M) to notify slave servers that there has been a change.

     If invoked with map, ypmake will update that map only.  Typing ypmake
     passwd will create and yppush the password database (assuming it is out-
     of-date).  Likewise, ypmake hosts and ypmake networks will create
     databases from the host and network files, /etc/hosts and /etc/networks
     and yppush the databases to the slave servers.  With the -u option,
     ypmake will always create the map.

     cron(1M) executes ypmake at regular intervals in order to maintain
     consistency between NIS servers' databases.  Once a day, ypmake calls
     ypmake to rebuild and transfers copies of all of the NIS databases to the
     slave servers, and moves the log file /var/yp/ypmake.log to
     /var/yp/ypmake.log.old to keep it from growing too large.

     ypmake reads the file /etc/config/ypmaster.options so that users may
     configure the following variables:

     ALIASES   full pathname of the aliases file used to build the aliases
               database. (Default is /usr/lib/aliases.)

     DIR       the directory of the source files. (Default is /etc.)

     DOM       used to construct a domain other than the master's default
               domain;

     NOPUSH    when non-null, inhibits doing a yppush of the new database
               files. (Default is the null string.)

     PWFILE    full pathname of the password file used to build the passwd
               database. (Default is /etc/passwd.)

     YPDIR     directory containing NIS programs (e.g., makedbm, yppush,
               etc.).  (Default is /usr/sbin.)

     For instance, to change the location of the password file used by ypmake
     to /etc/passwd.yp, include:

          PWFILE=/etc/passwd.yp

     in /etc/config/ypmaster.options.  The variables can also be specified as
     arguments on the ypmake command line.

     To have local NIS maps updated by ypmake, create the file
     /var/yp/local.make.script and add rules similar to the ones in
     make.script.  The first rule in local.make.script should be depend on
     ``all.''  For example, to have a map called phonenumbers, the file should
     follow this style:

          PHNUMS = /usr/local/phonenums
          localall: all phonenumbers
          phonenumbers: phonenumbers.time
          phonenumbers.time:
               commands to create the NIS database go here...


     Refer to ypfiles(4) and ypserv(1M) for an overview of NIS.

EXAMPLES
     To create and push the hosts map only it's out-of-date:

          ypmake hosts

     To always create and push the hosts and passwd map:

          ypmake -u hosts passwd

     To always create but not push the aliases map:

          ypmake -u NOPUSH=1 aliases


FILES
     /var/yp/make.script
     /var/yp/local.make.script
     /var/yp/ypmake.log
     /var/yp/ypmake.log.old

SEE ALSO
     cron(1M), make(1), makedbm(1M), ypserv(1M)