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 ]