xref: /titanic_41/usr/src/lib/libtnfprobe/tnf_buf.h (revision 7c478bd95313f5f23a4c958a745db2134aa03244)

/*
 * CDDL HEADER START
 *
 * The contents of this file are subject to the terms of the
 * Common Development and Distribution License, Version 1.0 only
 * (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
 * or http://www.opensolaris.org/os/licensing.
 * 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
 */
/*
 *	Copyright (c) 1994, by Sun Microsytems, Inc.
 */

#ifndef _TNF_BUF_H
#define	_TNF_BUF_H

#pragma ident	"%Z%%M%	%I%	%E% SMI"

#ifdef _KERNEL
#include <sys/tnf_com.h>
#else  /* _KERNEL */
#include <tnf/com.h>
#endif

#ifdef __cplusplus
extern "C" {
#endif

/*
 * Size of the file header and forwarding pointer (directory) area combined.
 * Tag and data blocks start this many bytes into the file.
 *
 * The kernel uses a smaller directory area, and uses the saved space
 * as block pool reserved for tag allocations.
 */

#ifdef _KERNEL
#define	TNFW_B_FW_ZONE			0x4000
#define	TNFW_B_TAG_RESERVE		0xc000
#else
#define	TNFW_B_FW_ZONE			0x10000
#define	TNFW_B_TAG_RESERVE		0x8000
#endif
#define	TNFW_B_DATA_BLOCK_BEGIN		(TNFW_B_FW_ZONE + TNFW_B_TAG_RESERVE)

/*
 * CAUTION: do not change integer values of TNF_ALLOC_REUSABLE or
 *		TNF_ALLOC_FIXED
 */
enum tnf_alloc_mode {
	TNF_ALLOC_REUSABLE = 0,
	TNF_ALLOC_FIXED
};

typedef struct {
	tnf_uint32_t		magic;
	tnf_file_header_t	com;
	struct {
		uint_t		hi;
		uint_t		lo[2];
	} next_alloc;
	uint_t			next_tag_alloc;
	uint_t			next_fw_alloc;
} tnf_buf_file_header_t;

typedef struct tnfw_b_pos TNFW_B_POS;

struct tnfw_b_pos {
	tnf_block_header_t 	*tnfw_w_block;
	tnf_block_header_t 	*tnfw_w_uncommitted;
	short 			tnfw_w_write_off;
};

typedef struct {
	boolean_t 		tnfw_w_initialized;
	struct tnfw_b_pos 	tnfw_w_pos;
	struct tnfw_b_pos 	tnfw_w_tag_pos;
	int 			tnfw_w_gen_shift;
	int 			tnfw_w_block_shift;
	pid_t 			tnfw_w_pid;
	u_long 			tnfw_w_block_size;
#ifdef TNFWB_MAY_RELEASE_A_LOCK
	u_long 			tnfw_w_generation;
	boolean_t 		tnfw_w_a_lock_released;
#endif
} TNFW_B_WCB;

typedef enum {
	TNFW_B_OK,
	TNFW_B_NOTCONN,
	TNFW_B_ACKPHT,
	TNFW_B_NO_ALLOC,
	TNFW_B_NO_SPACE,
	TNFW_B_BAD_BLOCK_SIZE,
	TNFW_B_BAD_BLOCK_COUNT,
	TNFW_B_RECORD_TOO_BIG
} TNFW_B_STATUS;

typedef enum {
    TNFW_B_RUNNING = 0,
    TNFW_B_NOBUFFER,
    TNFW_B_FORKED,
    TNFW_B_BROKEN
} TNFW_B_STATE;

/*
 * The STOPPED bit may be or-ed into the state field.
 */
#define	TNFW_B_STOPPED  16
#define	TNFW_B_SET_STOPPED(state)	((state) |= TNFW_B_STOPPED)
#define	TNFW_B_UNSET_STOPPED(state)	((state) &= ~TNFW_B_STOPPED)
#define	TNFW_B_IS_STOPPED(state)	((state) & TNFW_B_STOPPED)


typedef struct {
	TNFW_B_STATE tnf_state;
	volatile char *tnf_buffer;
	int (*tnf_init_callback)(void);
	void (*tnf_fork_callback)(void);
	pid_t tnf_pid;
} TNFW_B_CONTROL;

extern TNFW_B_CONTROL *_tnfw_b_control;

/*
 * structure exported by buffering layer - guaranteed to be filled
 * after tnfw_b_init_buffer is called.
 */
typedef struct {
	char *	fw_file_header;
	char *	fw_block_header;
	char *	fw_root;
} tnf_buf_header_t;

extern tnf_buf_header_t *_tnf_buf_headers_p;

/*
 * External interface
 */

#define	TNFW_B_GIVEBACK(wcb, new_pos)	\
	((wcb)->tnfw_w_pos.tnfw_w_write_off = \
	(((char *)(new_pos) - (char *)((wcb)->tnfw_w_pos.tnfw_w_block) + 7) \
	& ~7), *(int *)(new_pos) = 0)

TNFW_B_STATUS tnfw_b_init_buffer(char *, int, int, boolean_t);
TNFW_B_STATUS tnfw_b_connect(TNFW_B_WCB *, volatile char *);
void * tnfw_b_alloc(TNFW_B_WCB *, size_t, enum tnf_alloc_mode);
TNFW_B_STATUS tnfw_b_xcommit(TNFW_B_WCB *);
TNFW_B_STATUS tnfw_b_xabort(TNFW_B_WCB *);
tnf_uint32_t *tnfw_b_fw_alloc(TNFW_B_WCB *);
void tnfw_b_release_block(TNFW_B_WCB *);

/* Declare lock routines written in assembly language. */
extern int tnfw_b_get_lock(tnf_byte_lock_t *);
extern void tnfw_b_clear_lock(tnf_byte_lock_t *);
extern u_long tnfw_b_atomic_swap(uint_t *, u_long);

#ifdef __cplusplus
}
#endif

#endif /* _TNF_BUF_H */