extern struct diagnostic* cyrus_login

(BP_CONNECTION* bp,
  char* serverName,
  sasl_conn_callback_t callback1,
  void* clientData1,
  sasl_interact_callback_t callback2,
  void* clientData2)

Tune using SASL, and update the connection's configuration structure accordingly.

Documentation

Tune using SASL, and update the connection's configuration structure accordingly.

Parameters:

bp - A pointer to the connection structure.

Input Keys:

SASL_CYRUS_SERVICE

The "service name" for this application, defaults to "beep".

SASL_LOCAL_MECHANISM

The SASL mechanism to use; if not present, this is negotiated.

Output Keys:

SASL_LOCAL_MECHANISM

The SASL mechanism used for authentication.

SASL_LOCAL_CODE

The resulting status code. Consult Section 8 of RFC 3080 for an (incomplete) list.

SASL_LOCAL_REASON

A textual message corresponding to SASL_LOCAL_CODE

serverName - The value to use for the serverName attribute of the <start> element (may not be NULL).
callback1 - The routine to invoke to call sasl_client_new or sasl_server_new (cf., callback).
clientData1 - A user-supplied pointer, supplied to callback1.
callback2 - The routine to invoke when a client interaction is needed (cf., callback), if NULL, then cyrus_fillin is used.
clientData2 - A user-supplied pointer, supplied to the callback.

Returns:

On failure, a pointer to a diagnostic structure explaining the reason (which should subsequently be destroyed by calling bp_diagnostic_destroy).

See Also:

cyrus_fillin

Home Alphabetic index