kmsSession.h revision 4f14b0f29aa144cc03efdde5508ae126ae197acf
/*
* CDDL HEADER START
*
* The contents of this file are subject to the terms of the
* Common Development and Distribution License (the "License").
* You may not use this file except in compliance with the License.
*
* You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE
* See the License for the specific language governing permissions
* and limitations under the License.
*
* When distributing Covered Code, include this CDDL HEADER in each
* file and include the License file at usr/src/OPENSOLARIS.LICENSE.
* If applicable, add the following below this CDDL HEADER, with the
* fields enclosed by brackets "[]" replaced with your own identifying
* information: Portions Copyright [yyyy] [name of copyright owner]
*
* CDDL HEADER END
*/
/*
*/
#ifndef _KMSSESSION_H
#define _KMSSESSION_H
#ifdef __cplusplus
extern "C" {
#endif
#include <stdio.h>
#include <pthread.h>
#define K_SOLARIS_PLATFORM
#include "KMSAgent.h"
#define KMSTOKEN_SESSION_MAGIC 0xECF00004
#define CRYPTO_OPERATION_ACTIVE 0x01
#define CRYPTO_OPERATION_UPDATE 0x02
typedef struct {
void *context;
typedef struct {
char *label;
} objlabel_t;
#define KMSOFFSETOF(s, m) ((size_t)(&(((s *)0)->m)))
/*
* Data stored in the KMS profile config file.
*/
typedef struct {
int transTimeout;
int failoverLimit;
int discoveryFreq;
int securityMode;
typedef struct session {
/* Place holder for parameters passed in the C_OpenSession */
/* Pointers to form the global session list */
/*
* The following structure is used to link the to-be-freed sessions
* into a linked list. The sessions on this linked list have
* not yet been freed via free() after C_CloseSession() call; instead
* they are added to this list. The actual free will take place when
* the number of sessions queued reaches MAX_SES_TO_BE_FREED, at which
* time the first session in the list will be freed.
*/
#define MAX_SES_TO_BE_FREED 300
typedef struct ses_to_be_freed_list {
extern CK_ULONG kms_session_cnt;
extern CK_ULONG kms_session_rw_cnt;
/*
* Flag definitions for ses_close_sync
*/
/* count to become zero */
/*
* This macro is used to decrement the session reference count by one.
*
* The caller of this macro uses the argument lock_held to indicate that
* whether the caller holds the lock on the session or not.
*
* REFRELE macro does the following:
* 1) Get the session lock if the caller does not hold it.
* 2) Decrement the session reference count by one.
* 3) If the session reference count becomes zero after being decremented,
* and there is a closing session thread in the wait state, then
* call pthread_cond_signal() to wake up that thread who is blocked
* in the session deletion routine due to non-zero reference ount.
* 4) Always release the session lock.
*/
#define REFRELE(s, ses_lock_held) { \
if (!ses_lock_held) \
(void) pthread_mutex_lock(&s->session_mutex); \
if ((--((s)->ses_refcnt) == 0) && \
(s->ses_close_sync & SESSION_REFCNT_WAITING)) { \
(void) pthread_mutex_unlock(&s->session_mutex); \
(void) pthread_cond_signal(&s->ses_free_cond); \
} else { \
(void) pthread_mutex_unlock(&s->session_mutex); \
} \
}
/*
* Function Prototypes.
*/
void
void
void
void
void kms_acquire_all_slots_mutexes();
void kms_release_all_slots_mutexes();
#ifdef __cplusplus
}
#endif
#endif /* _KMSSESSION_H */