include/linux/pagevec.h

   1 /*
   2  * include/linux/pagevec.h
   3  *
   4  * In many places it is efficient to batch an operation up against multiple
   5  * pages.  A pagevec is a multipage container which is used for that.
   6  */
   7
   8 #ifndef _LINUX_PAGEVEC_H
   9 #define _LINUX_PAGEVEC_H
  10
  11 /* 14 pointers + two long's align the pagevec structure to a power of two */
  12 #define PAGEVEC_SIZE    14
  13
  14 struct page;
  15 struct address_space;
  16
  17 struct pagevec {
  18         unsigned long nr;
  19         unsigned long cold;
  20         struct page *pages[PAGEVEC_SIZE];
  21 };
  22
  23 void __pagevec_release(struct pagevec *pvec);
  24 void __pagevec_lru_add(struct pagevec *pvec);
  25 unsigned pagevec_lookup_entries(struct pagevec *pvec,
  26                                 struct address_space *mapping,
  27                                 pgoff_t start, unsigned nr_entries,
  28                                 pgoff_t *indices);
  29 void pagevec_remove_exceptionals(struct pagevec *pvec);
  30 unsigned pagevec_lookup_range(struct pagevec *pvec,
  31                               struct address_space *mapping,
  32                               pgoff_t *start, pgoff_t end, unsigned nr_pages);
  33 static inline unsigned pagevec_lookup(struct pagevec *pvec,
  34                                       struct address_space *mapping,
  35                                       pgoff_t *start, unsigned nr_pages)
  36 {
  37         return pagevec_lookup_range(pvec, mapping, start, (pgoff_t)-1,
  38                                     nr_pages);
  39 }
  40
  41 unsigned pagevec_lookup_tag(struct pagevec *pvec,
  42                 struct address_space *mapping, pgoff_t *index, int tag,
  43                 unsigned nr_pages);
  44
  45 static inline void pagevec_init(struct pagevec *pvec, int cold)
  46 {
  47         pvec->nr = 0;
  48         pvec->cold = cold;
  49 }
  50
  51 static inline void pagevec_reinit(struct pagevec *pvec)
  52 {
  53         pvec->nr = 0;
  54 }
  55
  56 static inline unsigned pagevec_count(struct pagevec *pvec)
  57 {
  58         return pvec->nr;
  59 }
  60
  61 static inline unsigned pagevec_space(struct pagevec *pvec)
  62 {
  63         return PAGEVEC_SIZE - pvec->nr;
  64 }
  65
  66 /*
  67  * Add a page to a pagevec.  Returns the number of slots still available.
  68  */
  69 static inline unsigned pagevec_add(struct pagevec *pvec, struct page *page)
  70 {
  71         pvec->pages[pvec->nr++] = page;
  72         return pagevec_space(pvec);
  73 }
  74
  75 static inline void pagevec_release(struct pagevec *pvec)
  76 {
  77         if (pagevec_count(pvec))
  78                 __pagevec_release(pvec);
  79 }
  80
  81 #endif /* _LINUX_PAGEVEC_H */