krb5_cc_destroy()--Close and Delete Credentials Cache

Syntax

 #include <krb5.h>

 krb5_error_code krb5_cc_destroy(  
     krb5_context     context,
     krb5_ccache      ccache);

  Service Program Name: QSYS/QKRBGSS

  Default Public Authority: *USE

  Threadsafe: Yes

The krb5_cc_destroy() function closes and deletes a credentials cache. Once this function is completed, the cache handle may not be used.

Authorities

When the credentials cache is of type "FILE" (see krb5_cc_resolve() for more information on cache types), the default behavior is that the credentials cache file is created in the /QIBM/UserData/OS400/NetworkAuthentication/creds directory. The placement of the credentials cache file can be changed by setting the KRB5CCNAME environment variable.

If the credentials cache file does not reside in the default directory, the following authorities are required:

Object Referred to	Data Authority Required	Object Authority Required
Each directory in the path name preceding the credentials cache file	*X	None
Parent directory of the credentials cache file	*WX	None
Credentials cache file	*RW	*OBJEXIST

If the credentials cache file resides in the default directory, the following authorities are required:

Object Referred to	Data Authority Required	Object Authority Required
All directories in the path name	*X	None
Credentials cache file	*RW	None

Parameters

context (Input): The Kerberos context.
ccache (Input): The credentials cache handle.

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.

API introduced: V5R1

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