gss_display_name()--Get Textual Representation of Internal GSS Name

Syntax

 #include <gssapi.h>

 OM_uint32 gss_display_name(
     OM_uint32 *    minor_status,
     gss_name_t     input_name,
     gss_buffer_t   output_name_buffer,  
     gss_OID *      output_name_type);

  Service Program Name: QSYS/QKRBGSS

  Default public authority: *USE

  Threadsafe: Yes

The gss_display_name() function returns the textual representation of an opaque internal name. The syntax of the text representation is determined by the mechanism that was used to convert the name.

Parameters

minor_status (Output): A status code from the security mechanism.
input_name (Input): The internal name to be converted to a text string.
output_name_buffer (Output): Return buffer for the character string.
output_name_type (Output): The name type corresponding to the returned character string. The gss_OID value returned for this parameter points to read-only storage and must not be released by the application.

Return Value

The return value is one of the following status codes:

GSS_S_BAD_NAME: The provided name is not valid.
GSS_S_BAD_NAMETYPE: The internal name provided does not have an internal representation for any of the supported mechanisms.
GSS_S_COMPLETE: The routine completed successfully.
GSS_S_FAILURE: The routine failed for reasons that are not defined at the GSS level. The minor_status return parameter contains a mechanism-dependent error code describing the reason for the failure.

Authorities

Object Referred to	Data Authority Required
Each directory in the path name preceding the configuration file	*X
Configuration file	*R

Error Messages

Message ID	Error Message Text
CPE3418 E	Possible APAR condition or hardware failure.

Usage Notes

Kerberos names are formatted as principal-name@realm-name.
Not every coded character set identifier (CCSID) contains the '@' character; however, alternative CCSID values often are available. For example, instead of using Greece 423, run the job with a default CCSID of 875.

API introduced: V5R1

[ Back to top | Security APIs | UNIX-Type APIs | APIs by category ]