krb5_cc_default_name()--Get Name of the Default Credentials Cache

Syntax

 #include <krb5.h>

 char * krb5_cc_default_name(
     krb5_context     context);

  Service Program Name: QSYS/QKRBGSS

  Default Public Authority: *USE

  Threadsafe: Conditional. See Usage Notes.

The krb5_cc_default_name() function returns the name of the default credentials cache for the current user. If the KRB5CCNAME environment variable is set, this is the name of the default cache. Otherwise, the name is obtained from the file specified by the _EUV_SEC_KRB5CCNAME_FILE environment variable. If this environment variable is not set, the name is obtained from the krb5ccname in the HOME directory. If this file does not exist or if there is no default credentials cache name set in the file, a new credentials cache file is created.

Authorities

No authorities are required.

Parameters

context (Input): The Kerberos context.

Return Value

The name of the default credentials cache for the current user. This is a pointer to read-only storage and must not be freed by the application. If an error occurs, the function return value is NULL.

Error Messages

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

Usage Notes

The krb5_cc_default_name() routine uses static storage within the Kerberos context to hold the default name; therefore, this routine is not threadsafe unless a separate context is used for each thread.

API introduced: V5R1

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