HP Open Source Security for OpenVMS Volume 3: Kerberos > Chapter 6 KRB5 (Kerberos V5) Application Programming Interface

krb5_cc_set_default_name — Set default CC name

  Table of Contents

  Glossary

  Index

C Prototype

krb5_error_code krb5_cc_set_default_name (
krb5_context context,
const char *name );

Arguments

context (input/output) 

The context structure.

name (input/output)  

The default credentials cache name.

Description

This routine sets the default credentials cache name. If the default name is not passed in the argument name, it defaults to the first valid entry of the following values: the KRB5CCNAME logical name, the file krb5cc_<PID> in a [.TMP] directory in the user’s login directory (where <PID> is the user’s process ID). If the KRB5CCNAME logical name is defined, it must not be a system-wide logical name.

Return Values

This routine returns the following KRB5 status codes:

0

Successful completion.

KV5M_CONTEXT

Bad magic number for krb5_context structure.
ENOMEM

Insufficient memory.