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 ]