krb5_rc_destroy()--Delete Replay Cache

Syntax

 #include <krb5.h>

 krb5_error_code krb5_rc_destroy(
     krb5_context     context,  
     krb5_rcache      rcache);

  Service Program Name: QSYS/QKRBGSS
  Default Public Authority: *USE

  Threadsafe: Yes

The krb5_rc_destroy() function closes and deletes a replay cache. The cache handle may not be used once this routine completes.

Authorities

When the replay cache is of type "dfl" (see krb5_rc_resolve() for more information on replay cache types), the default behavior is that the replay cache file is created in the /QIBM/UserData/OS400/NetworkAuthentication/replay directory. The placement of the replay cache file can be changed by setting the KRB5RCACHEDIR or KRB5RCACHENAME environment variable, or by specifying a different path with the krb5_rc_resolve() function.

If the default directory is not used, the following authorities are required:

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

If the default directory is used, the following authorities are required:

Object Referred to	Data Authority Required
Each directory in the path name preceding the replay cache file	*X
Replay cache file	*RW

Parameters

context (Input): The Kerberos context.
rcache (Input): The replay 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 ]