NAME

       sasl_auxprop_request - Cyrus SASL documentation

SYNOPSIS

       #include <sasl/sasl.h>

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

DESCRIPTION

       int sasl_auxprop_request(sasl_conn_t *conn, const char **propnames)
              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).

              Parameters

                     • 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(3) on the sasl_conn_t.

              Returns
                     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)

AUTHOR

       The Cyrus Team

COPYRIGHT

       1993-2024, The Cyrus Team