krb5_cc_set_default_name()--Set Default Credentials Cache Name

Syntax

 #include <krb5.h>

 krb5_error_code krb5_cc_set_default_name(  
     krb5_context     context,
     const char*          name);

  Service Program Name: QSYS/QKRBGSS

  Default Public Authority: *USE

  Threadsafe: Yes. See Usage Notes.

The krb5_cc_set_default_name() routine sets the name of the default credentials cache for the Kerberos context. Specifying NULL for the name will cause the normal search order to be used to determine the default credentials cache name. Refer to krb5_cc_default_name() for a description of the search order.

Authorities

None.

Parameters

context (Input): The Kerberos context.
name (Input): The default credentials cache name.

Return Value

If no errors occur, the return value is 0. Otherwise, a Kerberos error code is returned.

Error Messages

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

Usage Notes

The krb5_cc_set_default_name() routines is not thread-safe unless a separate Kerberos context is used for each thread.

API introduced: V5R2

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