man pages section 3: Networking Library Functions

Exit Print View

Updated: July 2014
 
 

sasl_server_userdb_checkpass_t(3SASL)

Name

sasl_server_userdb_checkpass_t - plaintext password verification callback function

Synopsis

cc [ flag ... ] file ... –lsasl   [ library ... ]
#include <sasl/sasl.h>

int sasl_sasl_server_userdb_checkpass_t(sasl_conn_t *conn, void *context,
     const char *user, const char *pass, unsigned passlen, struct propctx *propctx);

Description

Use the sasl_sasl_server_userdb_checkpass_t() callback function to verify a plaintext password against the callback supplier's user database. Verification allows additional ways to encode the userPassword property.

Parameters

conn

The SASL connection context.

context

The context from the callback record.

user

A null-terminated user name with user@realm syntax.

pass

The password to check. This string cannot be null-terminated.

passlen

The length of pass.

propctx

The property context to fill in with userPassword.

Return Values

Like other SASL callback functions, sasl_server_userdb_checkpass_t() returns an integer that corresponds to a SASL error code. See <sasl.h> for a complete list of SASL error codes.

Errors

SASL_OK

The call to sasl_server_userdb_checkpass_t() was successful.

See sasl_errors(3SASL) for information on SASL error codes.

Attributes

See attributes(5) for descriptions of the following attributes:

ATTRIBUTE TYPE
ATTRIBUTE VALUE
Availability
system/library/security/libsasl
Interface Stability
Committed
MT-Level
MT–Safe

See also

sasl_errors(3SASL), attributes(5)