bus_private.h revision 167308
1/*- 2 * Copyright (c) 1997, 1998 Justin T. Gibbs. 3 * Copyright (c) 2002 by Thomas Moestl <tmm@FreeBSD.org>. 4 * All rights reserved. 5 * 6 * Redistribution and use in source and binary forms, with or without 7 * modification, are permitted provided that the following conditions 8 * are met: 9 * 1. Redistributions of source code must retain the above copyright 10 * notice, this list of conditions and the following disclaimer. 11 * 2. Redistributions in binary form must reproduce the above copyright 12 * notice, this list of conditions and the following disclaimer in the 13 * documentation and/or other materials provided with the distribution. 14 * 15 * THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR 16 * IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES 17 * OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. 18 * IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, 19 * INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES 20 * (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR 21 * SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER 22 * CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, 23 * OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE 24 * USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. 25 * 26 * from: FreeBSD: src/sys/i386/i386/busdma_machdep.c,v 1.25 2002/01/05 27 * 28 * $FreeBSD: head/sys/sparc64/include/bus_private.h 167308 2007-03-07 21:13:51Z marius $ 29 */ 30 31#ifndef _MACHINE_BUS_PRIVATE_H_ 32#define _MACHINE_BUS_PRIVATE_H_ 33 34#include <sys/queue.h> 35 36/* 37 * Helpers 38 */ 39int sparc64_bus_mem_map(bus_space_tag_t, bus_space_handle_t, bus_size_t, 40 int, vm_offset_t, void **); 41int sparc64_bus_mem_unmap(void *, bus_size_t); 42bus_space_handle_t sparc64_fake_bustag(int, bus_addr_t, struct bus_space_tag *); 43 44struct bus_dmamap_res { 45 struct resource *dr_res; 46 bus_size_t dr_used; 47 SLIST_ENTRY(bus_dmamap_res) dr_link; 48}; 49 50/* 51 * Callers of the bus_dma interfaces must always protect their tags and maps 52 * appropriately against concurrent access. However, when a map is on a LRU 53 * queue, there is a second access path to it; for this case, the locking rules 54 * are given in the parenthesized comments below: 55 * q - locked by the mutex protecting the queue. 56 * p - private to the owner of the map, no access through the queue. 57 * * - comment refers to pointer target. 58 * Only the owner of the map is allowed to insert the map into a queue. Removal 59 * and repositioning (i.e. temporal removal and reinsertion) is allowed to all 60 * if the queue lock is held. 61 */ 62struct bus_dmamap { 63 TAILQ_ENTRY(bus_dmamap) dm_maplruq; /* (q) */ 64 SLIST_HEAD(, bus_dmamap_res) dm_reslist; /* (q, *q) */ 65 int dm_onq; /* (q) */ 66 int dm_flags; /* (p) */ 67}; 68 69/* Flag values. */ 70#define DMF_LOADED 1 /* Map is loaded */ 71#define DMF_COHERENT 2 /* Coherent mapping requested */ 72 73int sparc64_dma_alloc_map(bus_dma_tag_t dmat, bus_dmamap_t *mapp); 74void sparc64_dma_free_map(bus_dma_tag_t dmat, bus_dmamap_t map); 75 76#endif /* !_MACHINE_BUS_PRIVATE_H_ */ 77