ypmake(1M)                                                          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/mdbm_parse and the
     optional file /var/yp/local.make.script to build the network information
     service (NIS) databases.  With no arguments, ypmake creates mdbm(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 updates that map only.  Typing ypmake passwd
     creates and yppushes the password database (assuming it is out-of-date).
     Likewise, ypmake hosts and ypmake networks 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 always creates the map.

     cron(1M) executes ypmake at regular intervals in order to maintain
     consistency between NIS servers' databases.  Once a day, ypmake 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 can
     specify arguments to mdbm_parse.

     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.)

          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.

     PWDIR
          full pathname of the directory of password and, optionally, shadow
          file used to build the passwd database. For example, to use both
          password and shadow files from /etc/yp instead of standard /etc,
          include


          PWDIR=/etc/yp


          in /etc/config/ypmaster.options.

          There is no default value for this variable and if it is not set,
          PWFILE is used. Note that if both PWDIR and PWFILE is specified,
          PWDIR takes precedence, but if neither is set, default value for
          PWFILE is used.

     Other then adding the variables to /etc/config/ypmaster.options, they 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
     mdbm_parse.

     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
     /etc/config/ypmaster.options
     /var/yp/make.script
     /var/yp/local.make.script
     /var/yp/mdbm_parse
     /var/yp/ypmake.log
     /var/yp/ypmake.log.old

SEE ALSO
     cron(1M), make(1), makemdbm(1M), ypserv(1M).

NOTE
     The mdbm_parse script supports building a database for the shadow
     passwords, but this database is not built by default.  Ypmake must be
     explicitly called with a shadow map name argument.

     If support for new databases are added a line must be added to the file
     /var/ns/domains/DOMAIN/nsswitch.conf for the NIS domain in question for
     the server to allow queries to the map.


                                                                        Page 2