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

krb5_get_server_rcache — Create a replay cache for server use

  Table of Contents

  Glossary

  Index

C Prototype

krb5_error_code krb5_get_server_rcache(
krb5_context context,
const krb5_data *piece,
krb5_rcache *ret_rcache );

Arguments

context (input/output) 

The context structure.

piece (input)  

Used to distinguish this replay cache from others in use on the system. Typically, piece is the first component of the principal name for the client or server that is calling krb5_get_server_rcache.

ret_rcache (output)  

A handle to an open rcache.

Description

This routine generates a replay cache name, allocates space for its handle, and opens it.

Upon successful return, ret_rcache is filled in to contain a handle to an open rcache, which should be closed with krb5_rc_close.

Return Values

This routine returns the following KRB5 status code:

0

Successful completion.

ENOMEM Insufficient memory.