yppasswd.3n (2010 09)

ManualsBrandsHP ManualsSoftwareHP-UX Manpages

yppasswd(3N) yppasswd(3N)

NAME

yppasswd() - update user password in Network Information Service

SYNOPSIS

cc [ﬂag]... ﬁle...

-lnsl [library ]...

#include <pwd.h>

#include <rpcsvc/yppasswd.h>

int yppasswd(char *oldpass, struct passwd *newpw);

DESCRIPTION

If oldpass is the old, unencrypted user password, this routine replaces the password entry with the

encrypted newpw .

RPC Info

Program number:

YPPASSWDPROG

XDR routines:

xdr_yppasswd(xdrs, yp)

XDR *xdrs;

struct yppasswd *yp;

xdr_passwd(xdrs, pw)

XDR *xdrs;

struct passwd *pw;

Procs:

YPPASSWDPROC_UPDATE

Takes struct yppasswd as an argument; returns an integer. Behaves the same as the

yppasswd ( ) function. Uses UNIX authentication.

Versions:

YPPASSWDVERS

Structures:

struct yppasswd {

char *oldpass; /* old (unencrypted) password */

struct passwd newpw; /* new pw structure */

};

MULTITHREAD USAGE

Thread Safe: Yes

Cancel Safe: Yes

Fork Safe: No

Async-cancel Safe: No

Async-signal Safe: No

These functions can be called safely in a multithreaded environment. They may be cancellation points in

that they call functions that are cancel points.

In a multithreaded environment, these functions are not safe to be called by a child process after

fork()

and before exec(). These functions should not be called by a multithreaded application that support

asynchronous cancellation or asynchronous signals.

RETURN VALUE

yppasswd() returns 0 if successful and -1 if an error occurs.

AUTHOR

yppasswd() was developed by Sun Microsystems, Inc.