include/linux/backing-dev.h

   1 /*
   2  * include/linux/backing-dev.h
   3  *
   4  * low-level device information and state which is propagated up through
   5  * to high-level code.
   6  */
   7
   8 #ifndef _LINUX_BACKING_DEV_H
   9 #define _LINUX_BACKING_DEV_H
  10
  11 #include <asm/atomic.h>
  12
  13 struct page;
  14
  15 /*
  16  * Bits in backing_dev_info.state
  17  */
  18 enum bdi_state {
  19         BDI_pdflush,            /* A pdflush thread is working this device */
  20         BDI_write_congested,    /* The write queue is getting full */
  21         BDI_read_congested,     /* The read queue is getting full */
  22         BDI_unused,             /* Available bits start here */
  23 };
  24
  25 typedef int (congested_fn)(void *, int);
  26
  27 struct backing_dev_info {
  28         unsigned long ra_pages; /* max readahead in PAGE_CACHE_SIZE units */
  29         unsigned long state;    /* Always use atomic bitops on this */
  30         unsigned int capabilities; /* Device capabilities */
  31         congested_fn *congested_fn; /* Function pointer if device is md/dm */
  32         void *congested_data;   /* Pointer to aux data for congested func */
  33         void (*unplug_io_fn)(struct backing_dev_info *, struct page *);
  34         void *unplug_io_data;
  35 };
  36
  37 static inline int bdi_init(struct backing_dev_info *bdi)
  38 {
  39         return 0;
  40 }
  41
  42 static inline void bdi_destroy(struct backing_dev_info *bdi)
  43 {
  44 }
  45
  46 /*
  47  * Flags in backing_dev_info::capability
  48  * - The first two flags control whether dirty pages will contribute to the
  49  *   VM's accounting and whether writepages() should be called for dirty pages
  50  *   (something that would not, for example, be appropriate for ramfs)
  51  * - These flags let !MMU mmap() govern direct device mapping vs immediate
  52  *   copying more easily for MAP_PRIVATE, especially for ROM filesystems
  53  */
  54 #define BDI_CAP_NO_ACCT_DIRTY   0x00000001      /* Dirty pages shouldn't contribute to accounting */
  55 #define BDI_CAP_NO_WRITEBACK    0x00000002      /* Don't write pages back */
  56 #define BDI_CAP_MAP_COPY        0x00000004      /* Copy can be mapped (MAP_PRIVATE) */
  57 #define BDI_CAP_MAP_DIRECT      0x00000008      /* Can be mapped directly (MAP_SHARED) */
  58 #define BDI_CAP_READ_MAP        0x00000010      /* Can be mapped for reading */
  59 #define BDI_CAP_WRITE_MAP       0x00000020      /* Can be mapped for writing */
  60 #define BDI_CAP_EXEC_MAP        0x00000040      /* Can be mapped for execution */
  61 #define BDI_CAP_VMFLAGS \
  62         (BDI_CAP_READ_MAP | BDI_CAP_WRITE_MAP | BDI_CAP_EXEC_MAP)
  63
  64 #if defined(VM_MAYREAD) && \
  65         (BDI_CAP_READ_MAP != VM_MAYREAD || \
  66          BDI_CAP_WRITE_MAP != VM_MAYWRITE || \
  67          BDI_CAP_EXEC_MAP != VM_MAYEXEC)
  68 #error please change backing_dev_info::capabilities flags
  69 #endif
  70
  71 extern struct backing_dev_info default_backing_dev_info;
  72 void default_unplug_io_fn(struct backing_dev_info *bdi, struct page *page);
  73
  74 int writeback_acquire(struct backing_dev_info *bdi);
  75 int writeback_in_progress(struct backing_dev_info *bdi);
  76 void writeback_release(struct backing_dev_info *bdi);
  77
  78 static inline int bdi_congested(struct backing_dev_info *bdi, int bdi_bits)
  79 {
  80         if (bdi->congested_fn)
  81                 return bdi->congested_fn(bdi->congested_data, bdi_bits);
  82         return (bdi->state & bdi_bits);
  83 }
  84
  85 static inline int bdi_read_congested(struct backing_dev_info *bdi)
  86 {
  87         return bdi_congested(bdi, 1 << BDI_read_congested);
  88 }
  89
  90 static inline int bdi_write_congested(struct backing_dev_info *bdi)
  91 {
  92         return bdi_congested(bdi, 1 << BDI_write_congested);
  93 }
  94
  95 static inline int bdi_rw_congested(struct backing_dev_info *bdi)
  96 {
  97         return bdi_congested(bdi, (1 << BDI_read_congested)|
  98                                   (1 << BDI_write_congested));
  99 }
 100
 101 void clear_bdi_congested(struct backing_dev_info *bdi, int rw);
 102 void set_bdi_congested(struct backing_dev_info *bdi, int rw);
 103 long congestion_wait(int rw, long timeout);
 104
 105 #define bdi_cap_writeback_dirty(bdi) \
 106         (!((bdi)->capabilities & BDI_CAP_NO_WRITEBACK))
 107
 108 #define bdi_cap_account_dirty(bdi) \
 109         (!((bdi)->capabilities & BDI_CAP_NO_ACCT_DIRTY))
 110
 111 #define mapping_cap_writeback_dirty(mapping) \
 112         bdi_cap_writeback_dirty((mapping)->backing_dev_info)
 113
 114 #define mapping_cap_account_dirty(mapping) \
 115         bdi_cap_account_dirty((mapping)->backing_dev_info)
 116
 117
 118 #endif          /* _LINUX_BACKING_DEV_H */