opensolaris man page for sasl_auxprop_request

sasl_auxprop_request(3SASL)		      Simple Authentication Security Layer Library Functions		       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		     |SUNWlibsasl		   |
       +-----------------------------+-----------------------------+
       |Interface Stability	     |Evolving			   |
       +-----------------------------+-----------------------------+
       |MT-Level		     |Safe			   |
       +-----------------------------+-----------------------------+

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

SunOS 5.11							    22 Aug 2003 				       sasl_auxprop_request(3SASL)