yppasswdd(1M)                                                 yppasswdd(1M)




 NAME    [Toc]    [Back]
      yppasswdd - daemon for modifying Network Information Service passwd
      database

 SYNOPSIS    [Toc]    [Back]
      /usr/lib/netsvc/yp/rpc.yppasswdd passwd_file [-l log_file]
           [-nogecos] [-noshell] [-nopw] [-nohome] [-m [arg1 arg2 ...]]

    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]
      The yppasswdd daemon handles password change requests from yppasswd
      (see yppasswd(1)).  It changes a password entry in passwd_file, which
      must be in the format defined by passwd(4).  The change is made only
      if the old password provided by yppasswd matches the encrypted
      password of that entry.

      yppasswdd should be executed only on the master Network Information
      Service (NIS) server for the passwd database (map).  The yppasswdd
      daemon is not executed by default, nor can it be started by inetd (see
      inetd(1M)).  To enable automatic startup of yppasswdd at boot time,
      the NIS_MASTER_SERVER variable should be set to 1 in file
      /etc/rc.config.d/namesvrs on the master NIS server.

    Options    [Toc]    [Back]
      yppasswdd recognizes the following options and command-line arguments:

           -l log_file         Log diagnostic and error messages to
                               log_file.  These messages are not available
                               if yppasswdd is started without the -l
                               option.

                               Information logged to the file includes date
                               and time of the message, the host name,
                               process ID and name of the function
                               generating the message, and the message
                               itself.  Note that different services can
                               share a single log file because enough
                               information is included to uniquely identify
                               each message.

           -nogecos -noshell -nopw -nohome
                               If these are given, then these fields may not
                               be changed remotely using passwd(1).  -nohome
                               is HP specific.

           -m [arg1 arg2 ...]  After passwd_file is modified, and if using
                               the -m option, yppasswdd executes make to



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






 yppasswdd(1M)                                                 yppasswdd(1M)




                               update the NIS passwd database (see
                               ypmake(1M) Any arguments following the -m
                               flag are passed to make.

                               To ensure that the passwd map is rebuilt to
                               contain the new password and all slave NIS
                               servers have their passwd maps properly
                               updated to include the change, always use the
                               -m option to yppasswdd, but do not use the
                               NOPUSH=1 argument to make.

 EXAMPLES    [Toc]    [Back]
      Assume the yppasswdd daemon is started on the master NIS server as
      follows:

           /usr/lib/netsvc/yp/rpc.yppasswdd /var/yp/src/passwd \
                                  -l /var/adm/yppasswdd.log \
                                  -m passwd DIR=/var/yp/src

      This indicates that the ASCII file from which the NIS passwd database
      is built is /var/yp/src/passwd.  When this file is updated by a
      request from yppasswd, the NIS passwd database is rebuilt and copied
      to all slave NIS servers in the master's NIS domain (see
      domainname(1)).

      Log messages are written to the file /var/adm/yppasswdd.log.

 WARNINGS    [Toc]    [Back]
      yppasswdd uses lock file /var/adm/ptmp to get exclusive access to
      passwd_file when updating it.  The file /var/adm/ptmp may persist if
      passwd_file is being updated and

           +  The system crashes or

           +  yppasswdd is killed using SIGKILL (see kill(1) and signal(2)).

      File /var/adm/ptmp must be removed before yppasswdd can function
      properly again.

      vipw also uses /var/adm/ptmp when updating /etc/passwd (see vipw(1M)).
      As a result, yppasswdd competes with vipw when it updates passwd_file
      if passwd_file is /etc/passwd.

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

 FILES    [Toc]    [Back]
      /var/adm/ptmp  lock file used when updating passwd_file

 SEE ALSO    [Toc]    [Back]
      domainname(1), yppasswd(1), vipw(1M), ypmake(1M), yppasswd(3N),



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






 yppasswdd(1M)                                                 yppasswdd(1M)




      passwd(4), publickey(4), ypfiles(4).


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