blob: 99ba76edc42a4c94a333571e9c5c1d2658e465ca [file] [log] [blame]
Linus Torvalds1da177e2005-04-16 15:20:36 -07001#ifndef _ASM_SCATTERLIST_H
2#define _ASM_SCATTERLIST_H
3
Jean Delvarea9dfd282007-03-06 02:45:12 -08004#include <asm/types.h>
5
Linus Torvalds1da177e2005-04-16 15:20:36 -07006/*
Jens Axboed09d2762007-10-23 12:39:41 +02007 * Drivers must set either ->address or (preferred) page and ->offset
Linus Torvalds1da177e2005-04-16 15:20:36 -07008 * to indicate where data must be transferred to/from.
9 *
Jens Axboed09d2762007-10-23 12:39:41 +020010 * Using page is recommended since it handles highmem data as well as
Linus Torvalds1da177e2005-04-16 15:20:36 -070011 * low mem. ->address is restricted to data which has a virtual mapping, and
Jens Axboed09d2762007-10-23 12:39:41 +020012 * it will go away in the future. Updating to page can be automated very
Linus Torvalds1da177e2005-04-16 15:20:36 -070013 * easily -- something like
14 *
15 * sg->address = some_ptr;
16 *
17 * can be rewritten as
18 *
Jens Axboed09d2762007-10-23 12:39:41 +020019 * sg_set_page(virt_to_page(some_ptr));
Linus Torvalds1da177e2005-04-16 15:20:36 -070020 * sg->offset = (unsigned long) some_ptr & ~PAGE_MASK;
21 *
22 * and that's it. There's no excuse for not highmem enabling YOUR driver. /jens
23 */
24struct scatterlist {
Jens Axboed6ec0842007-10-22 20:01:06 +020025#ifdef CONFIG_DEBUG_SG
26 unsigned long sg_magic;
27#endif
Jens Axboe18dabf42007-10-22 19:57:20 +020028 unsigned long page_link;
Linus Torvalds1da177e2005-04-16 15:20:36 -070029 unsigned int offset; /* for highmem, page offset */
30
31 dma_addr_t dma_address;
32 unsigned int length;
33};
34
35#define ISA_DMA_THRESHOLD (0xffffffffUL)
36
37#endif /* !_ASM_SCATTERLIST_H */