/*-
 * Copyright (c) 2003
 *	Fraunhofer Institute for Open Communication Systems (FhG Fokus).
 * 	All rights reserved.
 *
 * Redistribution and use in source and binary forms, with or without
 * modification, are permitted provided that the following conditions
 * are met:
 * 1. Redistributions of source code must retain the above copyright
 *    notice, this list of conditions and the following disclaimer.
 * 2. Redistributions in binary form must reproduce the above copyright
 *    notice, this list of conditions and the following disclaimer in the
 *    documentation and/or other materials provided with the distribution.
 *
 * THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND
 * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
 * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
 * ARE DISCLAIMED.  IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE
 * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
 * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
 * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
 * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
 * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
 * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
 * SUCH DAMAGE.
 *
 * Author: Hartmut Brandt <harti@freebsd.org>
 */

/*
 * This implements pools of DMA-able buffers that conserve DMA address space
 * by putting several buffers into one page and that allow to map between
 * 32-bit handles for the buffer and buffer addresses (to use 32-bit network
 * interfaces on 64bit machines). This assists network interfaces that may need
 * huge numbers of mbufs.
 *
 * $FreeBSD$
 */
#ifndef _SYS_MBPOOL_H_
#define	_SYS_MBPOOL_H_

#ifdef _KERNEL

#include <sys/queue.h>

/* opaque */
struct mbpool;

/* size of reserved area at end of each chunk */
#define	MBPOOL_TRAILER_SIZE	4

/* maximum value of max_pages */
#define	MBPOOL_MAX_MAXPAGES	((1 << 14) - 1)

/* maximum number of chunks per page */
#define	MBPOOL_MAX_CHUNKS	(1 << 9)

/* initialize a pool */
int mbp_create(struct mbpool **, const char *, bus_dma_tag_t, u_int,
	size_t, size_t);

/* destroy a pool */
void mbp_destroy(struct mbpool *);

/* allocate a chunk and set used and on card */
void *mbp_alloc(struct mbpool *, bus_addr_t *, uint32_t *);

/* free a chunk */
void mbp_free(struct mbpool *, void *);

/* free a chunk that is an external mbuf */
int mbp_ext_free(struct mbuf *, void *, void *);

/* free all buffers that are marked to be on the card */
void mbp_card_free(struct mbpool *);

/* count used buffers and buffers on card */
void mbp_count(struct mbpool *, u_int *, u_int *, u_int *);

/* get the buffer from a handle and clear card bit */
void *mbp_get(struct mbpool *, uint32_t);

/* get the buffer from a handle and don't clear card bit */
void *mbp_get_keep(struct mbpool *, uint32_t);

/* sync the chunk */
void mbp_sync(struct mbpool *, uint32_t, bus_addr_t, bus_size_t, u_int);

#endif	/* _KERNEL */
#endif	/* _SYS_MBPOOL_H_ */