krb5_cc_generate_new()--Create a New Credentials Cache


  Syntax
 #include <krb5.h>

 krb5_error_code krb5_cc_generate_new(  
     krb5_context     context,
     krb5_const char *      type,  
     krb5_ccache *      ccache); 
  Service Program Name: QSYS/QKRBGSS

  Default Public Authority: *USE

  Threadsafe: Yes

The krb5_cc_generate_new() function creates a new credentials cache with a unique name. The krb5_cc_initialize() function must be called to set the cache principal before storing any credentials in the cache.


Authorities

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


Parameters

context  (Input)
The Kerberos context.

type  (Input)
The credentials cache type (for example, FILE).

ccache  (Output)
The credentials cache handle. The krb5_cc_close() or krb5_cc_destroy() routine should be called to release the handle when it is no longer needed.

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 ]