Commit | Line | Data |
---|---|---|
1da177e4 | 1 | /* |
f30c2269 | 2 | * include/linux/writeback.h |
1da177e4 LT |
3 | */ |
4 | #ifndef WRITEBACK_H | |
5 | #define WRITEBACK_H | |
6 | ||
e8edc6e0 | 7 | #include <linux/sched.h> |
f5ff8422 | 8 | #include <linux/fs.h> |
e8edc6e0 | 9 | |
54848d73 WF |
10 | DECLARE_PER_CPU(int, dirty_throttle_leaks); |
11 | ||
ffd1f609 | 12 | /* |
1a12d8bd WF |
13 | * The 1/4 region under the global dirty thresh is for smooth dirty throttling: |
14 | * | |
15 | * (thresh - thresh/DIRTY_FULL_SCOPE, thresh) | |
16 | * | |
ffd1f609 WF |
17 | * Further beyond, all dirtier tasks will enter a loop waiting (possibly long |
18 | * time) for the dirty pages to drop, unless written enough pages. | |
19 | * | |
20 | * The global dirty threshold is normally equal to the global dirty limit, | |
21 | * except when the system suddenly allocates a lot of anonymous memory and | |
22 | * knocks down the global dirty threshold quickly, in which case the global | |
23 | * dirty limit will follow down slowly to prevent livelocking all dirtier tasks. | |
24 | */ | |
1a12d8bd WF |
25 | #define DIRTY_SCOPE 8 |
26 | #define DIRTY_FULL_SCOPE (DIRTY_SCOPE / 2) | |
ffd1f609 | 27 | |
1da177e4 LT |
28 | struct backing_dev_info; |
29 | ||
1da177e4 LT |
30 | /* |
31 | * fs/fs-writeback.c | |
32 | */ | |
33 | enum writeback_sync_modes { | |
34 | WB_SYNC_NONE, /* Don't wait on anything */ | |
35 | WB_SYNC_ALL, /* Wait on every mapping */ | |
1da177e4 LT |
36 | }; |
37 | ||
0e175a18 CW |
38 | /* |
39 | * why some writeback work was initiated | |
40 | */ | |
41 | enum wb_reason { | |
42 | WB_REASON_BACKGROUND, | |
43 | WB_REASON_TRY_TO_FREE_PAGES, | |
44 | WB_REASON_SYNC, | |
45 | WB_REASON_PERIODIC, | |
46 | WB_REASON_LAPTOP_TIMER, | |
47 | WB_REASON_FREE_MORE_MEM, | |
48 | WB_REASON_FS_FREE_SPACE, | |
49 | WB_REASON_FORKER_THREAD, | |
50 | ||
51 | WB_REASON_MAX, | |
52 | }; | |
53 | extern const char *wb_reason_name[]; | |
54 | ||
1da177e4 LT |
55 | /* |
56 | * A control structure which tells the writeback code what to do. These are | |
57 | * always on the stack, and hence need no locking. They are always initialised | |
58 | * in a manner such that unspecified fields are set to zero. | |
59 | */ | |
60 | struct writeback_control { | |
1da177e4 LT |
61 | long nr_to_write; /* Write this many pages, and decrement |
62 | this for each page written */ | |
63 | long pages_skipped; /* Pages which were not written */ | |
64 | ||
65 | /* | |
95468fd4 | 66 | * For a_ops->writepages(): if start or end are non-zero then this is |
1da177e4 LT |
67 | * a hint that the filesystem need only write out the pages inside that |
68 | * byterange. The byte at `end' is included in the writeout request. | |
69 | */ | |
111ebb6e OH |
70 | loff_t range_start; |
71 | loff_t range_end; | |
1da177e4 | 72 | |
4cd9069a RK |
73 | enum writeback_sync_modes sync_mode; |
74 | ||
22905f77 | 75 | unsigned for_kupdate:1; /* A kupdate writeback */ |
b17621fe | 76 | unsigned for_background:1; /* A background writeback */ |
6e6938b6 | 77 | unsigned tagged_writepages:1; /* tag-and-write to avoid livelock */ |
22905f77 | 78 | unsigned for_reclaim:1; /* Invoked from the page allocator */ |
111ebb6e | 79 | unsigned range_cyclic:1; /* range_start is cyclic */ |
1da177e4 LT |
80 | }; |
81 | ||
1da177e4 LT |
82 | /* |
83 | * fs/fs-writeback.c | |
84 | */ | |
03ba3782 | 85 | struct bdi_writeback; |
1da177e4 | 86 | int inode_wait(void *); |
0e175a18 CW |
87 | void writeback_inodes_sb(struct super_block *, enum wb_reason reason); |
88 | void writeback_inodes_sb_nr(struct super_block *, unsigned long nr, | |
89 | enum wb_reason reason); | |
90 | int writeback_inodes_sb_if_idle(struct super_block *, enum wb_reason reason); | |
91 | int writeback_inodes_sb_nr_if_idle(struct super_block *, unsigned long nr, | |
92 | enum wb_reason reason); | |
b6e51316 | 93 | void sync_inodes_sb(struct super_block *); |
0e175a18 CW |
94 | long writeback_inodes_wb(struct bdi_writeback *wb, long nr_pages, |
95 | enum wb_reason reason); | |
03ba3782 | 96 | long wb_do_writeback(struct bdi_writeback *wb, int force_wait); |
0e175a18 | 97 | void wakeup_flusher_threads(long nr_pages, enum wb_reason reason); |
1da177e4 LT |
98 | |
99 | /* writeback.h requires fs.h; it, too, is not included from here. */ | |
100 | static inline void wait_on_inode(struct inode *inode) | |
101 | { | |
102 | might_sleep(); | |
eaff8079 | 103 | wait_on_bit(&inode->i_state, __I_NEW, inode_wait, TASK_UNINTERRUPTIBLE); |
1da177e4 | 104 | } |
1c0eeaf5 JE |
105 | static inline void inode_sync_wait(struct inode *inode) |
106 | { | |
107 | might_sleep(); | |
108 | wait_on_bit(&inode->i_state, __I_SYNC, inode_wait, | |
109 | TASK_UNINTERRUPTIBLE); | |
110 | } | |
111 | ||
1da177e4 LT |
112 | |
113 | /* | |
114 | * mm/page-writeback.c | |
115 | */ | |
c2c4986e | 116 | #ifdef CONFIG_BLOCK |
31373d09 | 117 | void laptop_io_completion(struct backing_dev_info *info); |
1da177e4 | 118 | void laptop_sync_completion(void); |
31373d09 MG |
119 | void laptop_mode_sync(struct work_struct *work); |
120 | void laptop_mode_timer_fn(unsigned long data); | |
c2c4986e JA |
121 | #else |
122 | static inline void laptop_sync_completion(void) { } | |
123 | #endif | |
232ea4d6 | 124 | void throttle_vm_writeout(gfp_t gfp_mask); |
a756cf59 | 125 | bool zone_dirty_ok(struct zone *zone); |
1da177e4 | 126 | |
c42843f2 WF |
127 | extern unsigned long global_dirty_limit; |
128 | ||
1da177e4 LT |
129 | /* These are exported to sysctl. */ |
130 | extern int dirty_background_ratio; | |
2da02997 | 131 | extern unsigned long dirty_background_bytes; |
1da177e4 | 132 | extern int vm_dirty_ratio; |
2da02997 | 133 | extern unsigned long vm_dirty_bytes; |
704503d8 AD |
134 | extern unsigned int dirty_writeback_interval; |
135 | extern unsigned int dirty_expire_interval; | |
195cf453 | 136 | extern int vm_highmem_is_dirtyable; |
1da177e4 LT |
137 | extern int block_dump; |
138 | extern int laptop_mode; | |
139 | ||
2da02997 | 140 | extern int dirty_background_ratio_handler(struct ctl_table *table, int write, |
8d65af78 | 141 | void __user *buffer, size_t *lenp, |
2da02997 DR |
142 | loff_t *ppos); |
143 | extern int dirty_background_bytes_handler(struct ctl_table *table, int write, | |
8d65af78 | 144 | void __user *buffer, size_t *lenp, |
2da02997 | 145 | loff_t *ppos); |
04fbfdc1 | 146 | extern int dirty_ratio_handler(struct ctl_table *table, int write, |
8d65af78 | 147 | void __user *buffer, size_t *lenp, |
04fbfdc1 | 148 | loff_t *ppos); |
2da02997 | 149 | extern int dirty_bytes_handler(struct ctl_table *table, int write, |
8d65af78 | 150 | void __user *buffer, size_t *lenp, |
2da02997 | 151 | loff_t *ppos); |
04fbfdc1 | 152 | |
1da177e4 | 153 | struct ctl_table; |
8d65af78 | 154 | int dirty_writeback_centisecs_handler(struct ctl_table *, int, |
1da177e4 LT |
155 | void __user *, size_t *, loff_t *); |
156 | ||
16c4042f WF |
157 | void global_dirty_limits(unsigned long *pbackground, unsigned long *pdirty); |
158 | unsigned long bdi_dirty_limit(struct backing_dev_info *bdi, | |
159 | unsigned long dirty); | |
cf0ca9fe | 160 | |
e98be2d5 | 161 | void __bdi_update_bandwidth(struct backing_dev_info *bdi, |
c42843f2 | 162 | unsigned long thresh, |
af6a3113 | 163 | unsigned long bg_thresh, |
c42843f2 WF |
164 | unsigned long dirty, |
165 | unsigned long bdi_thresh, | |
166 | unsigned long bdi_dirty, | |
e98be2d5 WF |
167 | unsigned long start_time); |
168 | ||
1da177e4 | 169 | void page_writeback_init(void); |
fa5a734e AM |
170 | void balance_dirty_pages_ratelimited_nr(struct address_space *mapping, |
171 | unsigned long nr_pages_dirtied); | |
172 | ||
173 | static inline void | |
174 | balance_dirty_pages_ratelimited(struct address_space *mapping) | |
175 | { | |
176 | balance_dirty_pages_ratelimited_nr(mapping, 1); | |
177 | } | |
178 | ||
0ea97180 MS |
179 | typedef int (*writepage_t)(struct page *page, struct writeback_control *wbc, |
180 | void *data); | |
181 | ||
0ea97180 MS |
182 | int generic_writepages(struct address_space *mapping, |
183 | struct writeback_control *wbc); | |
5b41d924 ES |
184 | void tag_pages_for_writeback(struct address_space *mapping, |
185 | pgoff_t start, pgoff_t end); | |
0ea97180 MS |
186 | int write_cache_pages(struct address_space *mapping, |
187 | struct writeback_control *wbc, writepage_t writepage, | |
188 | void *data); | |
1da177e4 | 189 | int do_writepages(struct address_space *mapping, struct writeback_control *wbc); |
a200ee18 | 190 | void set_page_dirty_balance(struct page *page, int page_mkwrite); |
2d1d43f6 | 191 | void writeback_set_ratelimit(void); |
92c09c04 NK |
192 | void tag_pages_for_writeback(struct address_space *mapping, |
193 | pgoff_t start, pgoff_t end); | |
1da177e4 | 194 | |
2f800fbd WF |
195 | void account_page_redirty(struct page *page); |
196 | ||
1da177e4 LT |
197 | /* pdflush.c */ |
198 | extern int nr_pdflush_threads; /* Global so it can be exported to sysctl | |
199 | read-only. */ | |
200 | ||
201 | ||
202 | #endif /* WRITEBACK_H */ |