NAME

pwdauth, grpauth − password authentication routines

SYNOPSIS

int pwdauth(user, password)
char ∗user;
char ∗password;

int grpauth(group, password)
char ∗group;
char ∗password;

DESCRIPTION

pwdauth() and grpauth() determine whether the given guess at a password is valid for the given user or group. If the password is valid, the functions return 0. 

A password is valid if the password when encrypted matches the encrypted password in the appropriate file.  For pwdauth, if the password.adjunct file exists, the encrypted password will be in either the local or the Yellow Pages version of that file.  Otherwise, either the local or YP passwd file will be used.  For grpauth, the group.adjunct file (if it exists) or the group file (otherwise) will be checked on the local machine and then using the YP.  In all cases, the local files will be checked before the YP files.  Also, if the adjunct files exist, the main file will never be used for authentication even if they include encrypted passwords. 

Both pwdauth() and grpauth() interface to the authentication daemon, rpc.pwdauthd, to do the checking of the adjunct files.  This daemon must be running on any system that provides password authentication. 

FILES

/etc/passwd

/etc/group

SEE ALSO

getgraent(3), getgrent(3), getpwaent(3), getpwent(3), pwdauthd(8C)

Sun Release 4.0  —  Last change: 14 December 1987