gss_canonicalize_name()--Reduce GSS Internal Name to Mechanism Name
Syntax
#include <gssapi.h> OM_uint32 gss_canonicalize_name( OM_uint32 * minor_status, gss_name_t input_name, gss_OID mech_type, gss_name_t * output_name);Service Program Name: QSYS/QKRBGSS
Default public authority: *USE
Threadsafe: Yes
The gss_canonicalize_name() routine takes a GSS internal name that contains multiple internal representations and returns a new GSS internal name with a single name representation that corresponds to the specified security mechanism. A name that represents a single security mechanism is called a mechanism name.
Parameters
- minor_status (Output)
- A status code from the security mechanism.
- input_name (Input)
- The name to be processed. An error is returned if
GSS_C_NO_NAME is specified for this parameter.
- mech_type (Input)
- The security mechanism to be used.
The following security mechanisms are supported:
gss_mech_krb5_old Beta Kerberos V5 mechanism gss_mech_krb5 Kerberos V5 mechanism
- output_name (Output)
- The mechanism name. The gss_name_t returned by this parameter should be released by calling the gss_release_name() function when it is no longer needed.
Return Value
The return value is one of the following status codes:
- GSS_S_BAD_MECH
- The specified mechanism is not supported.
- GSS_S_BAD_NAME
- The input name is not valid.
- GSS_S_BAD_NAMETYPE
- The input name does not contain an element for the mechanism.
- 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. |
API introduced: V5R1
[ Back to top | Security APIs | UNIX-Type APIs | APIs by category ]