gss_inquire_saslname_for_mech(3) API function

SYNOPSIS

#include <gss.h>

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

ARGUMENTS

OM_uint32 * minor_status
(Integer, modify) Mechanism specific status code.
const gss_OID desired_mech
(OID, read) Identifies the GSS-API mechanism to query.
gss_buffer_t 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().
gss_buffer_t 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().
gss_buffer_t 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().

DESCRIPTION

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.

REPORTING BUGS

Report bugs to <[email protected]>. GNU Generic Security Service home page: http://www.gnu.org/software/gss/ General help using GNU software: http://www.gnu.org/gethelp/

COPYRIGHT

Copyright © 2003-2013 Simon Josefsson.
Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved.