NAME

       sasl_auxprop_request - Request Auxiliary 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 auxiliary 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 canonicalization 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 4422

SEE ALSO

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