1 /* SPDX-License-Identifier: GPL-2.0 */
3 * include/linux/pagevec.h
5 * In many places it is efficient to batch an operation up against multiple
6 * pages. A pagevec is a multipage container which is used for that.
9 #ifndef _LINUX_PAGEVEC_H
10 #define _LINUX_PAGEVEC_H
12 #include <linux/xarray.h>
14 /* 15 pointers + header align the pagevec structure to a power of two */
15 #define PAGEVEC_SIZE 15
22 bool percpu_pvec_drained;
23 struct page *pages[PAGEVEC_SIZE];
26 void __pagevec_release(struct pagevec *pvec);
27 void __pagevec_lru_add(struct pagevec *pvec);
28 unsigned pagevec_lookup_entries(struct pagevec *pvec,
29 struct address_space *mapping,
30 pgoff_t start, unsigned nr_entries,
32 void pagevec_remove_exceptionals(struct pagevec *pvec);
33 unsigned pagevec_lookup_range(struct pagevec *pvec,
34 struct address_space *mapping,
35 pgoff_t *start, pgoff_t end);
36 static inline unsigned pagevec_lookup(struct pagevec *pvec,
37 struct address_space *mapping,
40 return pagevec_lookup_range(pvec, mapping, start, (pgoff_t)-1);
43 unsigned pagevec_lookup_range_tag(struct pagevec *pvec,
44 struct address_space *mapping, pgoff_t *index, pgoff_t end,
46 unsigned pagevec_lookup_range_nr_tag(struct pagevec *pvec,
47 struct address_space *mapping, pgoff_t *index, pgoff_t end,
48 xa_mark_t tag, unsigned max_pages);
49 static inline unsigned pagevec_lookup_tag(struct pagevec *pvec,
50 struct address_space *mapping, pgoff_t *index, xa_mark_t tag)
52 return pagevec_lookup_range_tag(pvec, mapping, index, (pgoff_t)-1, tag);
55 static inline void pagevec_init(struct pagevec *pvec)
58 pvec->percpu_pvec_drained = false;
61 static inline void pagevec_reinit(struct pagevec *pvec)
66 static inline unsigned pagevec_count(struct pagevec *pvec)
71 static inline unsigned pagevec_space(struct pagevec *pvec)
73 return PAGEVEC_SIZE - pvec->nr;
77 * Add a page to a pagevec. Returns the number of slots still available.
79 static inline unsigned pagevec_add(struct pagevec *pvec, struct page *page)
81 pvec->pages[pvec->nr++] = page;
82 return pagevec_space(pvec);
85 static inline void pagevec_release(struct pagevec *pvec)
87 if (pagevec_count(pvec))
88 __pagevec_release(pvec);
91 #endif /* _LINUX_PAGEVEC_H */