ypmake(1M)                                                       ypmake(1M)




 NAME    [Toc]    [Back]
      ypmake - create or rebuild Network Information Service databases

 SYNOPSIS    [Toc]    [Back]
      /var/yp/ypmake [DIR=source_directory] [DOM=NIS_domain] \
         [NOPUSH=1] [PWFILE=passwd_file] [map [map ...]]

      cd /var/yp; make [DIR=source_directory] [DOM=NIS_domain] \
         [NOPUSH=1] [PWFILE=passwd_file] [map ...]

    Remarks    [Toc]    [Back]
      The Network Information Service (NIS) was formerly known as Yellow
      Pages (yp).  Although the name has changed, the functionality of the
      service remains the same.

 DESCRIPTION    [Toc]    [Back]
      ypmake is a shell script that builds one or more Network Information
      Service (NIS) maps (databases) on a master NIS server.  If no
      arguments are specified, ypmake either creates maps if they do not
      already exist or rebuilds maps that are not current.  These maps are
      constructed from ASCII files.  ypmake then executes yppush to notify
      slave NIS servers of the change and make the slave servers copy the
      updated maps to their machines (see yppush(1M)).

      If any maps are supplied on the command line, ypmake creates or
      updates those maps only.  Permissible names for maps are the filenames
      in /etc listed under FILES below.  In addition, specific maps can be
      named, such as netgroup.byuser or rpc.bynumber.

      The make command can be used instead of ypmake (see make(1)).  The
      Makefile no longer calls the ypmake script but now actually constructs
      the maps.  All NIS commands have been modified to use the Makefile
      instead of ypmake.  The Makefile and ypmake can co-exist, but it is
      recommended that you consider using the Makefile which is the standard
      mechanism for building maps on other vendor's machines.

      Both the Makefile and ypmake script use four variables:

           DIR=source_directory     The directory containing the ASCII
                                    source files from which maps are
                                    constructed.  DIR defaults to /etc.

           DOM=NIS_domain           Causes ypmake to construct maps for the
                                    specified NIS_domain.  DOM defaults to
                                    the NIS domain shown by domainname (see
                                    domainname(1)).

           NOPUSH=1                 When non-null (null by default), NOPUSH
                                    inhibits copying the new or updated
                                    databases to the slave NIS servers.
                                    Only slave NIS servers in the specified



 Hewlett-Packard Company            - 1 -   HP-UX 11i Version 2: August 2003






 ypmake(1M)                                                       ypmake(1M)




                                    domain receive yppush notification when
                                    NOPUSH is null.

           NOPUSH=2                 Does the same thing as NOPUSH=1 and
                                    sends a "clear current map" request to
                                    the local ypserv process.

           PWFILE=passwd_file       Specifies the full pathname of the ASCII
                                    file that ypmake should use when
                                    building the NIS passwd maps.  PWFILE
                                    defaults to $DIR/passwd.

      The order of arguments passed to ypmake is unimportant, but the maps
      are built or updated in the left-to-right order provided.

      Refer to ypfiles(4) and ypserv(1M) for an overview of Network
      Information Service.

 DIAGNOSTICS    [Toc]    [Back]
      ypmake returns one of the following exit codes upon completion:

           0    Normal termination; no problems.
           1    One or more unrecognized arguments were passed.
           2    The NIS domain name is not set.
           3    The subdirectory used to contain maps for a specific NIS
                domain, /var/yp/domain_name, does not exist or is not
                writable.
           4    An error was encountered when building at least one of the
                maps.
           5    One or more maps' ASCII files do not exist or are
                unreadable.

 EXAMPLES    [Toc]    [Back]
      Create or rebuild the password databases (both the passwd.byname and
      passwd.byuid maps) from /etc/passwd and use yppush to copy the
      databases to any slave NIS servers in the default NIS domain:

           ypmake passwd.byname

      Create or rebuild the hosts databases from /etc/hosts but do not copy
      the databases to any slave NIS servers:

           ypmake hosts NOPUSH=1

      Create or rebuild the network maps from /nis/sourcefiles/networks and
      copy the maps to any slave NIS servers in NIS domain DAE_NIS:

           ypmake DOM=DAE_NIS networks DIR=/nis/sourcefiles

 AUTHOR    [Toc]    [Back]
      ypmake was developed by Sun Microsystems, Inc.



 Hewlett-Packard Company            - 2 -   HP-UX 11i Version 2: August 2003






 ypmake(1M)                                                       ypmake(1M)




 FILES    [Toc]    [Back]
      /etc/group
      /etc/hosts
      /etc/netgroup
      /etc/networks
      /etc/passwd
      /etc/protocols
      /etc/publickey
      /etc/rpc
      /etc/services

 SEE ALSO    [Toc]    [Back]
      domainname(1), make(1), makedbm(1M), ypinit(1M), yppush(1M),
      ypserv(1M), group(4), hosts(4), netgroup(4), networks(4), passwd(4),
      protocols(4), publickey(4), rpc(4), services(4), ypfiles(4).


 Hewlett-Packard Company            - 3 -   HP-UX 11i Version 2: August 2003