mm: add variant of pagevec_lookup_range_tag() taking number of pages
[sfrench/cifs-2.6.git] / include / linux / pagevec.h
1 /* SPDX-License-Identifier: GPL-2.0 */
2 /*
3  * include/linux/pagevec.h
4  *
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.
7  */
8
9 #ifndef _LINUX_PAGEVEC_H
10 #define _LINUX_PAGEVEC_H
11
12 /* 14 pointers + two long's align the pagevec structure to a power of two */
13 #define PAGEVEC_SIZE    14
14
15 struct page;
16 struct address_space;
17
18 struct pagevec {
19         unsigned long nr;
20         unsigned long cold;
21         struct page *pages[PAGEVEC_SIZE];
22 };
23
24 void __pagevec_release(struct pagevec *pvec);
25 void __pagevec_lru_add(struct pagevec *pvec);
26 unsigned pagevec_lookup_entries(struct pagevec *pvec,
27                                 struct address_space *mapping,
28                                 pgoff_t start, unsigned nr_entries,
29                                 pgoff_t *indices);
30 void pagevec_remove_exceptionals(struct pagevec *pvec);
31 unsigned pagevec_lookup_range(struct pagevec *pvec,
32                               struct address_space *mapping,
33                               pgoff_t *start, pgoff_t end);
34 static inline unsigned pagevec_lookup(struct pagevec *pvec,
35                                       struct address_space *mapping,
36                                       pgoff_t *start)
37 {
38         return pagevec_lookup_range(pvec, mapping, start, (pgoff_t)-1);
39 }
40
41 unsigned pagevec_lookup_range_tag(struct pagevec *pvec,
42                 struct address_space *mapping, pgoff_t *index, pgoff_t end,
43                 int tag, unsigned nr_pages);
44 unsigned pagevec_lookup_range_nr_tag(struct pagevec *pvec,
45                 struct address_space *mapping, pgoff_t *index, pgoff_t end,
46                 int tag, unsigned max_pages);
47 static inline unsigned pagevec_lookup_tag(struct pagevec *pvec,
48                 struct address_space *mapping, pgoff_t *index, int tag,
49                 unsigned nr_pages)
50 {
51         return pagevec_lookup_range_tag(pvec, mapping, index, (pgoff_t)-1, tag,
52                                         nr_pages);
53 }
54
55 static inline void pagevec_init(struct pagevec *pvec, int cold)
56 {
57         pvec->nr = 0;
58         pvec->cold = cold;
59 }
60
61 static inline void pagevec_reinit(struct pagevec *pvec)
62 {
63         pvec->nr = 0;
64 }
65
66 static inline unsigned pagevec_count(struct pagevec *pvec)
67 {
68         return pvec->nr;
69 }
70
71 static inline unsigned pagevec_space(struct pagevec *pvec)
72 {
73         return PAGEVEC_SIZE - pvec->nr;
74 }
75
76 /*
77  * Add a page to a pagevec.  Returns the number of slots still available.
78  */
79 static inline unsigned pagevec_add(struct pagevec *pvec, struct page *page)
80 {
81         pvec->pages[pvec->nr++] = page;
82         return pagevec_space(pvec);
83 }
84
85 static inline void pagevec_release(struct pagevec *pvec)
86 {
87         if (pagevec_count(pvec))
88                 __pagevec_release(pvec);
89 }
90
91 #endif /* _LINUX_PAGEVEC_H */