Syntax

#include "slapi-plugin.h"
int slapi_pw_find( struct berval **vals, struct berval *v );

Parameters

The function has the following parameters:

vals	Pointer to the array of berval structures containing the values of an attribute that stores passwords (for example, the userpassword attribute). To get this value of the attribute, call the slapi_entry_attr_find() function.
v	Pointer to the berval structure containing the password that you want to check (for example, you can get this value from the SLAPI_BIND_CREDENTIALS parameter in the parameter block).

Returns

0 if the password specified by v was found in vals, or a non-zero value if the password v was not found in vals.

Description

When the Netscape Directory Server stores the password for an entry in the userpassword attribute, it encrypts the password using the scheme specified in the passwdhash directive of the slapd.conf configuration file. The scheme can be crypt or sha or "" (for cleartext).

If you need to determine if a given password is one of the values of the userpassword attribute, you can call the slapi_pw_find() function. This function determines which password scheme was used to store the password and uses the appropriate comparison function to compare a given value against the encrypted values of the userpassword attribute.

Example

[To be added]

See Also