man pages section 3: Networking Library Functions

Exit Print View

Updated: July 2014
 
 

sasl_auxprop_request(3SASL)

Name

sasl_auxprop_request - request auxialliary properties from SASL

Synopsis

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

int sasl_auxprop_request(sasl_conn_t *conn, const char **propnames);

Description

The sasl_auxprop_request() interface requests that the SASL library obtain properties form any auxialiary property plugins that might be installed, for example, the user's home directory from an LDAP server. The lookup occurs just after username canonicalization is complete. Therefore, the request should be made before the call to sasl_server_start(3SASL), but after the call to sasl_server_new(3SASL).

Parameters

conn

The sasl_conn_t for which the request is being made

propnames

A null-terminated array of property names to request. This array must persist until a call to sasl_dispose(3SASL) on the sasl_conn_t.

Errors

sasl_auxprop_request() returns SASL_OK upon success. See sasl_errors(3SASL) for a discussion of other 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
Safe

See also

sasl_dispose(3SASL), sasl_errors(3SASL), sasl_server_new(3SASL), sasl_server_start(3SASL), attributes(5)