Previous: Miscellaneous Routines, Up: Standard GSS API


3.10 SASL GS2 Routines

gss_inquire_mech_for_saslname

— Function: OM_uint32 gss_inquire_mech_for_saslname (OM_uint32 * minor_status, const gss_buffer_t sasl_mech_name, gss_OID * mech_type)

minor_status: (Integer, modify) Mechanism specific status code.

sasl_mech_name: (buffer, character-string, read) Buffer with SASL mechanism name.

mech_type: (OID, modify, optional) Actual mechanism used. The OID returned via this parameter will be a pointer to static storage that should be treated as read-only; In particular the application should not attempt to free it. Specify NULL if not required.

Output GSS-API mechanism OID of mechanism associated with given @sasl_mech_name.

Returns:

GSS_S_COMPLETE: Successful completion.

GSS_S_BAD_MECH: There is no GSS-API mechanism known as @sasl_mech_name.

gss_inquire_saslname_for_mech

— Function: OM_uint32 gss_inquire_saslname_for_mech (OM_uint32 * minor_status, const gss_OID desired_mech, gss_buffer_t sasl_mech_name, gss_buffer_t mech_name, gss_buffer_t mech_description)

minor_status: (Integer, modify) Mechanism specific status code.

desired_mech: (OID, read) Identifies the GSS-API mechanism to query.

sasl_mech_name: (buffer, character-string, modify, optional) Buffer to receive SASL mechanism name. The application must free storage associated with this name after use with a call to gss_release_buffer().

mech_name: (buffer, character-string, modify, optional) Buffer to receive human readable mechanism name. The application must free storage associated with this name after use with a call to gss_release_buffer().

mech_description: (buffer, character-string, modify, optional) Buffer to receive description of mechanism. The application must free storage associated with this name after use with a call to gss_release_buffer().

Output the SASL mechanism name of a GSS-API mechanism. It also returns a name and description of the mechanism in a user friendly form.

Returns:

GSS_S_COMPLETE: Successful completion.

GSS_S_BAD_MECH: The @desired_mech OID is unsupported.