yppasswd(3yp)yppasswd(3yp)Name
yppasswd - update user password in yellow pages password map.
Syntax
#include <rpcsvc/yppasswd.h>
yppasswd(oldpass, newpw)
char *oldpass;
struct passwd *newpw;
Description
The routine uses Remote Procedure Call (RPC) and External Data Representation (XDR) routines to update a user password in a Yellow Pages
password map. The RPC and XDR elements that are used are listed below under the RPC INFO heading.
If oldpass is indeed the old user password, this routine replaces the password entry with newpw. It returns 0 if successful.
RPC Information
program number:
YPPASSWDPROG
xdr routines:
xdr_ppasswd(xdrs, yp)
XDR *xdrs;
struct yppasswd *yp;
xdr_yppasswd(xdrs, pw)
XDR *xdrs;
struct passwd *pw;
procs:
YPPASSWDPROC_UPDATE
Takes struct yppasswd as argument, returns integer.
Same behavior as yppasswd() wrapper.
Uses UNIX authentication.
versions:
YPPASSWDVERS_ORIG
structures:
struct yppasswd {
char *oldpass; /* old (unencrypted) password */
struct passwd newpw; /* new pw structure */
};
See Alsoyppasswd(1yp), yppasswdd(8yp)yppasswd(3yp)
Check Out this Related Man Page
yppasswd(1) User Commands yppasswd(1)NAME
yppasswd - change your network password in the NIS database
SYNOPSIS
yppasswd [username]
DESCRIPTION
The yppasswd utility changes the network password associated with the user username in the Network Information Service (NIS) database. If
the user has done a keylogin(1), and a publickey/secretkey pair exists for the user in the NIS publickey.byname map, yppasswd also re-
encrypts the secretkey with the new password. The NIS password may be different from the local one on your own machine.
yppasswd prompts for the old NIS password, and then for the new one. You must type in the old password correctly for the change to take
effect. The new password must be typed twice, to forestall mistakes.
New passwords must be at least four characters long, if they use a sufficiently rich alphabet, and at least six characters long if mono-
case. These rules are relaxed if you are insistent enough. Only the owner of the name or the super-user may change a password; superuser on
the root master will not be prompted for the old password, and does not need to follow password construction requirements.
The NIS password daemon, rpc.yppasswdd must be running on your NIS server in order for the new password to take effect.
ATTRIBUTES
See attributes(5) for descriptions of the following attributes:
+-----------------------------+-----------------------------+
| ATTRIBUTE TYPE | ATTRIBUTE VALUE |
+-----------------------------+-----------------------------+
|Availability |SUNWnisu |
+-----------------------------+-----------------------------+
SEE ALSO keylogin(1), login(1), nis+(1), nispasswd(1), passwd(1), getpwnam(3C), getspnam(3C), secure_rpc(3NSL), nsswitch.conf(4), attributes(5)WARNINGS
Even after the user has successfully changed his or her password using this command, the subsequent login(1) using the new password will be
successful only if the user's password and shadow information is obtained from NIS. See getpwnam(3C), getspnam(3C), and nsswitch.conf(4).
NOTES
The use of yppasswd is discouraged, as it is now only a wrapper around the passwd(1) command, which should be used instead. Using passwd(1)
with the -r nis option (see nis+(1)) will achieve the same results, and will be consistent across all the different name services avail-
able.
BUGS
The update protocol passes all the information to the server in one RPC call, without ever looking at it. Thus, if you type your old pass-
word incorrectly, you will not be notified until after you have entered your new password.
SunOS 5.10 28 Nov 2001 yppasswd(1)