sasl_auxprop_request(3) [redhat man page]

sasl_auxprop_request(10 July 2001)										sasl_auxprop_request(10 July 2001)

NAME

       sasl_auxprop_request - Request Auxilliary Properties from SASL

SYNOPSIS

       #include <sasl/sasl.h>

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

DESCRIPTION

       sasl_auxprop_request  will  request  that  the  SASL library obtain properties from any auxilliary property plugins that might be installed
       (such as the user's home directory from an LDAP server for example).  Such lookup occurs just after username cannonicalization is complete.
       Therefore, the request should be made before the call to sasl_server_start(3), but after the call to sasl_server_new(3).

       conn the sasl_conn_t for which the request is being made.

       propnames  a  NULL-terminated  array  of  property names to request.  Note that this array must persist until a call to sasl_dispose on the
       sasl_conn_t.

RETURN VALUE

       Returns SASL_OK on success.  See sasl_errors(3) for meanings of other return codes.

CONFORMING TO

       RFC 2222

SEE ALSO

       sasl(3), sasl_errors(3), sasl_auxprop(3), sasl_auxprop_getctx(3), sasl_server_new(3), sasl_server_start(3)

SASL man pages							       SASL					sasl_auxprop_request(10 July 2001)

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.10							    22 Aug 2003 				       sasl_auxprop_request(3SASL)