include/linux/dma-attrs.h

   1 #ifndef _DMA_ATTR_H
   2 #define _DMA_ATTR_H
   3
   4 #include <linux/bitmap.h>
   5 #include <linux/bitops.h>
   6 #include <linux/bug.h>
   7
   8 /**
   9  * an enum dma_attr represents an attribute associated with a DMA
  10  * mapping. The semantics of each attribute should be defined in
  11  * Documentation/DMA-attributes.txt.
  12  */
  13 enum dma_attr {
  14         DMA_ATTR_WRITE_BARRIER,
  15         DMA_ATTR_WEAK_ORDERING,
  16         DMA_ATTR_WRITE_COMBINE,
  17         DMA_ATTR_NON_CONSISTENT,
  18         DMA_ATTR_NO_KERNEL_MAPPING,
  19         DMA_ATTR_SKIP_CPU_SYNC,
  20         DMA_ATTR_FORCE_CONTIGUOUS,
  21         DMA_ATTR_ALLOC_SINGLE_PAGES,
  22         DMA_ATTR_MAX,
  23 };
  24
  25 #define __DMA_ATTRS_LONGS BITS_TO_LONGS(DMA_ATTR_MAX)
  26
  27 /**
  28  * struct dma_attrs - an opaque container for DMA attributes
  29  * @flags - bitmask representing a collection of enum dma_attr
  30  */
  31 struct dma_attrs {
  32         unsigned long flags[__DMA_ATTRS_LONGS];
  33 };
  34
  35 #define DEFINE_DMA_ATTRS(x)                                     \
  36         struct dma_attrs x = {                                  \
  37                 .flags = { [0 ... __DMA_ATTRS_LONGS-1] = 0 },   \
  38         }
  39
  40 static inline void init_dma_attrs(struct dma_attrs *attrs)
  41 {
  42         bitmap_zero(attrs->flags, __DMA_ATTRS_LONGS);
  43 }
  44
  45 #ifdef CONFIG_HAVE_DMA_ATTRS
  46 /**
  47  * dma_set_attr - set a specific attribute
  48  * @attr: attribute to set
  49  * @attrs: struct dma_attrs (may be NULL)
  50  */
  51 static inline void dma_set_attr(enum dma_attr attr, struct dma_attrs *attrs)
  52 {
  53         if (attrs == NULL)
  54                 return;
  55         BUG_ON(attr >= DMA_ATTR_MAX);
  56         __set_bit(attr, attrs->flags);
  57 }
  58
  59 /**
  60  * dma_get_attr - check for a specific attribute
  61  * @attr: attribute to set
  62  * @attrs: struct dma_attrs (may be NULL)
  63  */
  64 static inline int dma_get_attr(enum dma_attr attr, struct dma_attrs *attrs)
  65 {
  66         if (attrs == NULL)
  67                 return 0;
  68         BUG_ON(attr >= DMA_ATTR_MAX);
  69         return test_bit(attr, attrs->flags);
  70 }
  71 #else /* !CONFIG_HAVE_DMA_ATTRS */
  72 static inline void dma_set_attr(enum dma_attr attr, struct dma_attrs *attrs)
  73 {
  74 }
  75
  76 static inline int dma_get_attr(enum dma_attr attr, struct dma_attrs *attrs)
  77 {
  78         return 0;
  79 }
  80 #endif /* CONFIG_HAVE_DMA_ATTRS */
  81 #endif /* _DMA_ATTR_H */