HP-UX Reference (11i v2 03/08) - 1M System Administration Commands N-Z (vol 4)

y
yppasswdd(1M) yppasswdd(1M)
NAME
yppasswdd - daemon for modifying Network Information Service passwd database
SYNOPSIS
/usr/lib/netsvc/yp/rpc.yppasswdd
passwd_file [-l log_file][
-nogecos][-noshell]
[
-nopw][-nohome][
-m [ arg1 arg2 ... ] ]
Remarks
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
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
yppasswdd recognizes the following options and command-line arguments:
-l log_file Log diagnostic and error messages to log_file. These messages are not avail-
able 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 exe-
cutes
make to update the NIS passwd database (see ypmake(1M) Any argu-
ments 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
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 data-
base 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
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.
Section 1M−−934 Hewlett-Packard Company − 1 − HP-UX 11i Version 2: August 2003