]> git.proxmox.com Git - mirror_ubuntu-eoan-kernel.git/blame - drivers/md/bitmap.c
md: move offset, daemon_sleep and chunksize out of bitmap structure
[mirror_ubuntu-eoan-kernel.git] / drivers / md / bitmap.c
CommitLineData
32a7627c
N
1/*
2 * bitmap.c two-level bitmap (C) Peter T. Breuer (ptb@ot.uc3m.es) 2003
3 *
4 * bitmap_create - sets up the bitmap structure
5 * bitmap_destroy - destroys the bitmap structure
6 *
7 * additions, Copyright (C) 2003-2004, Paul Clements, SteelEye Technology, Inc.:
8 * - added disk storage for bitmap
9 * - changes to allow various bitmap chunk sizes
32a7627c
N
10 */
11
12/*
13 * Still to do:
14 *
15 * flush after percent set rather than just time based. (maybe both).
16 * wait if count gets too high, wake when it drops to half.
32a7627c
N
17 */
18
bff61975 19#include <linux/blkdev.h>
32a7627c 20#include <linux/module.h>
32a7627c
N
21#include <linux/errno.h>
22#include <linux/slab.h>
23#include <linux/init.h>
32a7627c
N
24#include <linux/timer.h>
25#include <linux/sched.h>
26#include <linux/list.h>
27#include <linux/file.h>
28#include <linux/mount.h>
29#include <linux/buffer_head.h>
43b2e5d8 30#include "md.h"
ef740c37 31#include "bitmap.h"
32a7627c
N
32
33/* debug macros */
34
35#define DEBUG 0
36
37#if DEBUG
38/* these are for debugging purposes only! */
39
40/* define one and only one of these */
41#define INJECT_FAULTS_1 0 /* cause bitmap_alloc_page to fail always */
42#define INJECT_FAULTS_2 0 /* cause bitmap file to be kicked when first bit set*/
43#define INJECT_FAULTS_3 0 /* treat bitmap file as kicked at init time */
44#define INJECT_FAULTS_4 0 /* undef */
45#define INJECT_FAULTS_5 0 /* undef */
46#define INJECT_FAULTS_6 0
47
48/* if these are defined, the driver will fail! debug only */
49#define INJECT_FATAL_FAULT_1 0 /* fail kmalloc, causing bitmap_create to fail */
50#define INJECT_FATAL_FAULT_2 0 /* undef */
51#define INJECT_FATAL_FAULT_3 0 /* undef */
52#endif
53
54//#define DPRINTK PRINTK /* set this NULL to avoid verbose debug output */
55#define DPRINTK(x...) do { } while(0)
56
57#ifndef PRINTK
58# if DEBUG > 0
59# define PRINTK(x...) printk(KERN_DEBUG x)
60# else
61# define PRINTK(x...)
62# endif
63#endif
64
65static inline char * bmname(struct bitmap *bitmap)
66{
67 return bitmap->mddev ? mdname(bitmap->mddev) : "mdX";
68}
69
32a7627c
N
70
71/*
72 * just a placeholder - calls kmalloc for bitmap pages
73 */
74static unsigned char *bitmap_alloc_page(struct bitmap *bitmap)
75{
76 unsigned char *page;
77
44456d37 78#ifdef INJECT_FAULTS_1
32a7627c
N
79 page = NULL;
80#else
81 page = kmalloc(PAGE_SIZE, GFP_NOIO);
82#endif
83 if (!page)
84 printk("%s: bitmap_alloc_page FAILED\n", bmname(bitmap));
85 else
a654b9d8 86 PRINTK("%s: bitmap_alloc_page: allocated page at %p\n",
32a7627c
N
87 bmname(bitmap), page);
88 return page;
89}
90
91/*
92 * for now just a placeholder -- just calls kfree for bitmap pages
93 */
94static void bitmap_free_page(struct bitmap *bitmap, unsigned char *page)
95{
96 PRINTK("%s: bitmap_free_page: free page %p\n", bmname(bitmap), page);
97 kfree(page);
98}
99
100/*
101 * check a page and, if necessary, allocate it (or hijack it if the alloc fails)
102 *
103 * 1) check to see if this page is allocated, if it's not then try to alloc
104 * 2) if the alloc fails, set the page's hijacked flag so we'll use the
105 * page pointer directly as a counter
106 *
107 * if we find our page, we increment the page's refcount so that it stays
108 * allocated while we're using it
109 */
110static int bitmap_checkpage(struct bitmap *bitmap, unsigned long page, int create)
ee305ace
N
111__releases(bitmap->lock)
112__acquires(bitmap->lock)
32a7627c
N
113{
114 unsigned char *mappage;
115
116 if (page >= bitmap->pages) {
1187cf0a
N
117 /* This can happen if bitmap_start_sync goes beyond
118 * End-of-device while looking for a whole page.
119 * It is harmless.
120 */
32a7627c
N
121 return -EINVAL;
122 }
123
124
125 if (bitmap->bp[page].hijacked) /* it's hijacked, don't try to alloc */
126 return 0;
127
128 if (bitmap->bp[page].map) /* page is already allocated, just return */
129 return 0;
130
131 if (!create)
132 return -ENOENT;
133
134 spin_unlock_irq(&bitmap->lock);
135
136 /* this page has not been allocated yet */
137
138 if ((mappage = bitmap_alloc_page(bitmap)) == NULL) {
139 PRINTK("%s: bitmap map page allocation failed, hijacking\n",
140 bmname(bitmap));
141 /* failed - set the hijacked flag so that we can use the
142 * pointer as a counter */
143 spin_lock_irq(&bitmap->lock);
144 if (!bitmap->bp[page].map)
145 bitmap->bp[page].hijacked = 1;
146 goto out;
147 }
148
149 /* got a page */
150
151 spin_lock_irq(&bitmap->lock);
152
153 /* recheck the page */
154
155 if (bitmap->bp[page].map || bitmap->bp[page].hijacked) {
156 /* somebody beat us to getting the page */
157 bitmap_free_page(bitmap, mappage);
158 return 0;
159 }
160
161 /* no page was in place and we have one, so install it */
162
163 memset(mappage, 0, PAGE_SIZE);
164 bitmap->bp[page].map = mappage;
165 bitmap->missing_pages--;
166out:
167 return 0;
168}
169
170
171/* if page is completely empty, put it back on the free list, or dealloc it */
172/* if page was hijacked, unmark the flag so it might get alloced next time */
173/* Note: lock should be held when calling this */
858119e1 174static void bitmap_checkfree(struct bitmap *bitmap, unsigned long page)
32a7627c
N
175{
176 char *ptr;
177
178 if (bitmap->bp[page].count) /* page is still busy */
179 return;
180
181 /* page is no longer in use, it can be released */
182
183 if (bitmap->bp[page].hijacked) { /* page was hijacked, undo this now */
184 bitmap->bp[page].hijacked = 0;
185 bitmap->bp[page].map = NULL;
186 return;
187 }
188
189 /* normal case, free the page */
190
191#if 0
192/* actually ... let's not. We will probably need the page again exactly when
193 * memory is tight and we are flusing to disk
194 */
195 return;
196#else
197 ptr = bitmap->bp[page].map;
198 bitmap->bp[page].map = NULL;
199 bitmap->missing_pages++;
200 bitmap_free_page(bitmap, ptr);
201 return;
202#endif
203}
204
205
206/*
207 * bitmap file handling - read and write the bitmap file and its superblock
208 */
209
32a7627c
N
210/*
211 * basic page I/O operations
212 */
213
a654b9d8 214/* IO operations when bitmap is stored near all superblocks */
a2ed9615
N
215static struct page *read_sb_page(mddev_t *mddev, long offset,
216 struct page *page,
217 unsigned long index, int size)
a654b9d8
N
218{
219 /* choose a good rdev and read the page from there */
220
221 mdk_rdev_t *rdev;
a654b9d8
N
222 sector_t target;
223
a2ed9615
N
224 if (!page)
225 page = alloc_page(GFP_KERNEL);
a654b9d8
N
226 if (!page)
227 return ERR_PTR(-ENOMEM);
a654b9d8 228
159ec1fc 229 list_for_each_entry(rdev, &mddev->disks, same_set) {
b2d444d7
N
230 if (! test_bit(In_sync, &rdev->flags)
231 || test_bit(Faulty, &rdev->flags))
ab904d63
N
232 continue;
233
0f420358 234 target = rdev->sb_start + offset + index * (PAGE_SIZE/512);
a654b9d8 235
a2ed9615 236 if (sync_page_io(rdev->bdev, target,
e1defc4f 237 roundup(size, bdev_logical_block_size(rdev->bdev)),
a2ed9615 238 page, READ)) {
ab904d63 239 page->index = index;
ce25c31b
N
240 attach_page_buffers(page, NULL); /* so that free_buffer will
241 * quietly no-op */
ab904d63
N
242 return page;
243 }
244 }
245 return ERR_PTR(-EIO);
a654b9d8 246
a654b9d8
N
247}
248
b2d2c4ce
N
249static mdk_rdev_t *next_active_rdev(mdk_rdev_t *rdev, mddev_t *mddev)
250{
251 /* Iterate the disks of an mddev, using rcu to protect access to the
252 * linked list, and raising the refcount of devices we return to ensure
253 * they don't disappear while in use.
254 * As devices are only added or removed when raid_disk is < 0 and
255 * nr_pending is 0 and In_sync is clear, the entries we return will
256 * still be in the same position on the list when we re-enter
257 * list_for_each_continue_rcu.
258 */
259 struct list_head *pos;
260 rcu_read_lock();
261 if (rdev == NULL)
262 /* start at the beginning */
263 pos = &mddev->disks;
264 else {
265 /* release the previous rdev and start from there. */
266 rdev_dec_pending(rdev, mddev);
267 pos = &rdev->same_set;
268 }
269 list_for_each_continue_rcu(pos, &mddev->disks) {
270 rdev = list_entry(pos, mdk_rdev_t, same_set);
271 if (rdev->raid_disk >= 0 &&
b2d2c4ce
N
272 !test_bit(Faulty, &rdev->flags)) {
273 /* this is a usable devices */
274 atomic_inc(&rdev->nr_pending);
275 rcu_read_unlock();
276 return rdev;
277 }
278 }
279 rcu_read_unlock();
280 return NULL;
281}
282
ab6085c7 283static int write_sb_page(struct bitmap *bitmap, struct page *page, int wait)
a654b9d8 284{
b2d2c4ce 285 mdk_rdev_t *rdev = NULL;
ab6085c7 286 mddev_t *mddev = bitmap->mddev;
a654b9d8 287
b2d2c4ce 288 while ((rdev = next_active_rdev(rdev, mddev)) != NULL) {
ab6085c7 289 int size = PAGE_SIZE;
42a04b50 290 long offset = mddev->bitmap_info.offset;
ab6085c7
N
291 if (page->index == bitmap->file_pages-1)
292 size = roundup(bitmap->last_page_size,
e1defc4f 293 bdev_logical_block_size(rdev->bdev));
f0d76d70
N
294 /* Just make sure we aren't corrupting data or
295 * metadata
296 */
42a04b50 297 if (offset < 0) {
f0d76d70 298 /* DATA BITMAP METADATA */
42a04b50 299 if (offset
85bfb4da 300 + (long)(page->index * (PAGE_SIZE/512))
f0d76d70
N
301 + size/512 > 0)
302 /* bitmap runs in to metadata */
4b80991c 303 goto bad_alignment;
58c0fed4 304 if (rdev->data_offset + mddev->dev_sectors
42a04b50 305 > rdev->sb_start + offset)
f0d76d70 306 /* data runs in to bitmap */
4b80991c 307 goto bad_alignment;
0f420358 308 } else if (rdev->sb_start < rdev->data_offset) {
f0d76d70 309 /* METADATA BITMAP DATA */
0f420358 310 if (rdev->sb_start
42a04b50 311 + offset
f0d76d70
N
312 + page->index*(PAGE_SIZE/512) + size/512
313 > rdev->data_offset)
314 /* bitmap runs in to data */
4b80991c 315 goto bad_alignment;
f0d76d70
N
316 } else {
317 /* DATA METADATA BITMAP - no problems */
318 }
a654b9d8 319 md_super_write(mddev, rdev,
42a04b50 320 rdev->sb_start + offset
a654b9d8 321 + page->index * (PAGE_SIZE/512),
ab6085c7 322 size,
a654b9d8 323 page);
b2d2c4ce 324 }
a654b9d8
N
325
326 if (wait)
a9701a30 327 md_super_wait(mddev);
a654b9d8 328 return 0;
4b80991c
N
329
330 bad_alignment:
4b80991c 331 return -EINVAL;
a654b9d8
N
332}
333
4ad13663 334static void bitmap_file_kick(struct bitmap *bitmap);
32a7627c 335/*
a654b9d8 336 * write out a page to a file
32a7627c 337 */
4ad13663 338static void write_page(struct bitmap *bitmap, struct page *page, int wait)
32a7627c 339{
d785a06a 340 struct buffer_head *bh;
32a7627c 341
f0d76d70
N
342 if (bitmap->file == NULL) {
343 switch (write_sb_page(bitmap, page, wait)) {
344 case -EINVAL:
345 bitmap->flags |= BITMAP_WRITE_ERROR;
f0d76d70 346 }
4ad13663 347 } else {
a654b9d8 348
4ad13663 349 bh = page_buffers(page);
c708443c 350
4ad13663
N
351 while (bh && bh->b_blocknr) {
352 atomic_inc(&bitmap->pending_writes);
353 set_buffer_locked(bh);
354 set_buffer_mapped(bh);
355 submit_bh(WRITE, bh);
356 bh = bh->b_this_page;
357 }
d785a06a 358
4ad13663
N
359 if (wait) {
360 wait_event(bitmap->write_wait,
361 atomic_read(&bitmap->pending_writes)==0);
362 }
8a5e9cf1 363 }
4ad13663
N
364 if (bitmap->flags & BITMAP_WRITE_ERROR)
365 bitmap_file_kick(bitmap);
d785a06a
N
366}
367
368static void end_bitmap_write(struct buffer_head *bh, int uptodate)
369{
370 struct bitmap *bitmap = bh->b_private;
371 unsigned long flags;
32a7627c 372
d785a06a
N
373 if (!uptodate) {
374 spin_lock_irqsave(&bitmap->lock, flags);
375 bitmap->flags |= BITMAP_WRITE_ERROR;
376 spin_unlock_irqrestore(&bitmap->lock, flags);
32a7627c 377 }
d785a06a
N
378 if (atomic_dec_and_test(&bitmap->pending_writes))
379 wake_up(&bitmap->write_wait);
380}
32a7627c 381
d785a06a
N
382/* copied from buffer.c */
383static void
384__clear_page_buffers(struct page *page)
385{
386 ClearPagePrivate(page);
387 set_page_private(page, 0);
388 page_cache_release(page);
389}
390static void free_buffers(struct page *page)
391{
392 struct buffer_head *bh = page_buffers(page);
77ad4bc7 393
d785a06a
N
394 while (bh) {
395 struct buffer_head *next = bh->b_this_page;
396 free_buffer_head(bh);
397 bh = next;
77ad4bc7 398 }
d785a06a
N
399 __clear_page_buffers(page);
400 put_page(page);
32a7627c
N
401}
402
d785a06a
N
403/* read a page from a file.
404 * We both read the page, and attach buffers to the page to record the
405 * address of each block (using bmap). These addresses will be used
406 * to write the block later, completely bypassing the filesystem.
407 * This usage is similar to how swap files are handled, and allows us
408 * to write to a file with no concerns of memory allocation failing.
409 */
32a7627c 410static struct page *read_page(struct file *file, unsigned long index,
d785a06a
N
411 struct bitmap *bitmap,
412 unsigned long count)
32a7627c 413{
32a7627c 414 struct page *page = NULL;
c649bb9c 415 struct inode *inode = file->f_path.dentry->d_inode;
d785a06a
N
416 struct buffer_head *bh;
417 sector_t block;
32a7627c 418
2d1f3b5d
N
419 PRINTK("read bitmap file (%dB @ %Lu)\n", (int)PAGE_SIZE,
420 (unsigned long long)index << PAGE_SHIFT);
32a7627c 421
d785a06a
N
422 page = alloc_page(GFP_KERNEL);
423 if (!page)
424 page = ERR_PTR(-ENOMEM);
32a7627c
N
425 if (IS_ERR(page))
426 goto out;
d785a06a 427
d785a06a
N
428 bh = alloc_page_buffers(page, 1<<inode->i_blkbits, 0);
429 if (!bh) {
2d1f3b5d 430 put_page(page);
d785a06a 431 page = ERR_PTR(-ENOMEM);
32a7627c
N
432 goto out;
433 }
d785a06a
N
434 attach_page_buffers(page, bh);
435 block = index << (PAGE_SHIFT - inode->i_blkbits);
436 while (bh) {
437 if (count == 0)
438 bh->b_blocknr = 0;
439 else {
440 bh->b_blocknr = bmap(inode, block);
441 if (bh->b_blocknr == 0) {
442 /* Cannot use this file! */
443 free_buffers(page);
444 page = ERR_PTR(-EINVAL);
445 goto out;
446 }
447 bh->b_bdev = inode->i_sb->s_bdev;
448 if (count < (1<<inode->i_blkbits))
449 count = 0;
450 else
451 count -= (1<<inode->i_blkbits);
452
453 bh->b_end_io = end_bitmap_write;
454 bh->b_private = bitmap;
ce25c31b
N
455 atomic_inc(&bitmap->pending_writes);
456 set_buffer_locked(bh);
457 set_buffer_mapped(bh);
458 submit_bh(READ, bh);
d785a06a
N
459 }
460 block++;
461 bh = bh->b_this_page;
462 }
d785a06a 463 page->index = index;
ce25c31b
N
464
465 wait_event(bitmap->write_wait,
466 atomic_read(&bitmap->pending_writes)==0);
467 if (bitmap->flags & BITMAP_WRITE_ERROR) {
468 free_buffers(page);
469 page = ERR_PTR(-EIO);
470 }
32a7627c
N
471out:
472 if (IS_ERR(page))
473 printk(KERN_ALERT "md: bitmap read error: (%dB @ %Lu): %ld\n",
2d1f3b5d
N
474 (int)PAGE_SIZE,
475 (unsigned long long)index << PAGE_SHIFT,
32a7627c
N
476 PTR_ERR(page));
477 return page;
478}
479
480/*
481 * bitmap file superblock operations
482 */
483
484/* update the event counter and sync the superblock to disk */
4ad13663 485void bitmap_update_sb(struct bitmap *bitmap)
32a7627c
N
486{
487 bitmap_super_t *sb;
488 unsigned long flags;
489
490 if (!bitmap || !bitmap->mddev) /* no bitmap for this array */
4ad13663 491 return;
32a7627c
N
492 spin_lock_irqsave(&bitmap->lock, flags);
493 if (!bitmap->sb_page) { /* no superblock */
494 spin_unlock_irqrestore(&bitmap->lock, flags);
4ad13663 495 return;
32a7627c 496 }
32a7627c 497 spin_unlock_irqrestore(&bitmap->lock, flags);
ea03aff9 498 sb = (bitmap_super_t *)kmap_atomic(bitmap->sb_page, KM_USER0);
32a7627c 499 sb->events = cpu_to_le64(bitmap->mddev->events);
a0da84f3
NB
500 if (bitmap->mddev->events < bitmap->events_cleared) {
501 /* rocking back to read-only */
502 bitmap->events_cleared = bitmap->mddev->events;
503 sb->events_cleared = cpu_to_le64(bitmap->events_cleared);
504 }
ea03aff9 505 kunmap_atomic(sb, KM_USER0);
4ad13663 506 write_page(bitmap, bitmap->sb_page, 1);
32a7627c
N
507}
508
509/* print out the bitmap file superblock */
510void bitmap_print_sb(struct bitmap *bitmap)
511{
512 bitmap_super_t *sb;
513
514 if (!bitmap || !bitmap->sb_page)
515 return;
ea03aff9 516 sb = (bitmap_super_t *)kmap_atomic(bitmap->sb_page, KM_USER0);
32a7627c 517 printk(KERN_DEBUG "%s: bitmap file superblock:\n", bmname(bitmap));
a2cff26a
N
518 printk(KERN_DEBUG " magic: %08x\n", le32_to_cpu(sb->magic));
519 printk(KERN_DEBUG " version: %d\n", le32_to_cpu(sb->version));
520 printk(KERN_DEBUG " uuid: %08x.%08x.%08x.%08x\n",
32a7627c
N
521 *(__u32 *)(sb->uuid+0),
522 *(__u32 *)(sb->uuid+4),
523 *(__u32 *)(sb->uuid+8),
524 *(__u32 *)(sb->uuid+12));
a2cff26a 525 printk(KERN_DEBUG " events: %llu\n",
32a7627c 526 (unsigned long long) le64_to_cpu(sb->events));
a2cff26a 527 printk(KERN_DEBUG "events cleared: %llu\n",
32a7627c 528 (unsigned long long) le64_to_cpu(sb->events_cleared));
a2cff26a
N
529 printk(KERN_DEBUG " state: %08x\n", le32_to_cpu(sb->state));
530 printk(KERN_DEBUG " chunksize: %d B\n", le32_to_cpu(sb->chunksize));
531 printk(KERN_DEBUG " daemon sleep: %ds\n", le32_to_cpu(sb->daemon_sleep));
532 printk(KERN_DEBUG " sync size: %llu KB\n",
533 (unsigned long long)le64_to_cpu(sb->sync_size)/2);
4b6d287f 534 printk(KERN_DEBUG "max write behind: %d\n", le32_to_cpu(sb->write_behind));
ea03aff9 535 kunmap_atomic(sb, KM_USER0);
32a7627c
N
536}
537
538/* read the superblock from the bitmap file and initialize some bitmap fields */
539static int bitmap_read_sb(struct bitmap *bitmap)
540{
541 char *reason = NULL;
542 bitmap_super_t *sb;
4b6d287f 543 unsigned long chunksize, daemon_sleep, write_behind;
32a7627c
N
544 unsigned long long events;
545 int err = -EINVAL;
546
547 /* page 0 is the superblock, read it... */
f49d5e62
N
548 if (bitmap->file) {
549 loff_t isize = i_size_read(bitmap->file->f_mapping->host);
550 int bytes = isize > PAGE_SIZE ? PAGE_SIZE : isize;
551
552 bitmap->sb_page = read_page(bitmap->file, 0, bitmap, bytes);
553 } else {
42a04b50
N
554 bitmap->sb_page = read_sb_page(bitmap->mddev,
555 bitmap->mddev->bitmap_info.offset,
a2ed9615
N
556 NULL,
557 0, sizeof(bitmap_super_t));
a654b9d8 558 }
32a7627c
N
559 if (IS_ERR(bitmap->sb_page)) {
560 err = PTR_ERR(bitmap->sb_page);
561 bitmap->sb_page = NULL;
562 return err;
563 }
564
ea03aff9 565 sb = (bitmap_super_t *)kmap_atomic(bitmap->sb_page, KM_USER0);
32a7627c 566
32a7627c
N
567 chunksize = le32_to_cpu(sb->chunksize);
568 daemon_sleep = le32_to_cpu(sb->daemon_sleep);
4b6d287f 569 write_behind = le32_to_cpu(sb->write_behind);
32a7627c
N
570
571 /* verify that the bitmap-specific fields are valid */
572 if (sb->magic != cpu_to_le32(BITMAP_MAGIC))
573 reason = "bad magic";
bd926c63
N
574 else if (le32_to_cpu(sb->version) < BITMAP_MAJOR_LO ||
575 le32_to_cpu(sb->version) > BITMAP_MAJOR_HI)
32a7627c 576 reason = "unrecognized superblock version";
1187cf0a 577 else if (chunksize < 512)
7dd5d34c 578 reason = "bitmap chunksize too small";
32a7627c
N
579 else if ((1 << ffz(~chunksize)) != chunksize)
580 reason = "bitmap chunksize not a power of 2";
7dd5d34c
N
581 else if (daemon_sleep < 1 || daemon_sleep > MAX_SCHEDULE_TIMEOUT / HZ)
582 reason = "daemon sleep period out of range";
4b6d287f
N
583 else if (write_behind > COUNTER_MAX)
584 reason = "write-behind limit out of range (0 - 16383)";
32a7627c
N
585 if (reason) {
586 printk(KERN_INFO "%s: invalid bitmap file superblock: %s\n",
587 bmname(bitmap), reason);
588 goto out;
589 }
590
591 /* keep the array size field of the bitmap superblock up to date */
592 sb->sync_size = cpu_to_le64(bitmap->mddev->resync_max_sectors);
593
594 if (!bitmap->mddev->persistent)
595 goto success;
596
597 /*
598 * if we have a persistent array superblock, compare the
599 * bitmap's UUID and event counter to the mddev's
600 */
601 if (memcmp(sb->uuid, bitmap->mddev->uuid, 16)) {
602 printk(KERN_INFO "%s: bitmap superblock UUID mismatch\n",
603 bmname(bitmap));
604 goto out;
605 }
606 events = le64_to_cpu(sb->events);
607 if (events < bitmap->mddev->events) {
608 printk(KERN_INFO "%s: bitmap file is out of date (%llu < %llu) "
609 "-- forcing full recovery\n", bmname(bitmap), events,
610 (unsigned long long) bitmap->mddev->events);
4f2e639a 611 sb->state |= cpu_to_le32(BITMAP_STALE);
32a7627c
N
612 }
613success:
614 /* assign fields using values from superblock */
42a04b50
N
615 bitmap->mddev->bitmap_info.chunksize = chunksize;
616 bitmap->mddev->bitmap_info.daemon_sleep = daemon_sleep;
585f0dd5 617 bitmap->daemon_lastrun = jiffies;
42a04b50 618 bitmap->mddev->bitmap_info.max_write_behind = write_behind;
4f2e639a 619 bitmap->flags |= le32_to_cpu(sb->state);
bd926c63
N
620 if (le32_to_cpu(sb->version) == BITMAP_MAJOR_HOSTENDIAN)
621 bitmap->flags |= BITMAP_HOSTENDIAN;
32a7627c 622 bitmap->events_cleared = le64_to_cpu(sb->events_cleared);
4f2e639a 623 if (sb->state & cpu_to_le32(BITMAP_STALE))
6a07997f 624 bitmap->events_cleared = bitmap->mddev->events;
32a7627c
N
625 err = 0;
626out:
ea03aff9 627 kunmap_atomic(sb, KM_USER0);
32a7627c
N
628 if (err)
629 bitmap_print_sb(bitmap);
630 return err;
631}
632
633enum bitmap_mask_op {
634 MASK_SET,
635 MASK_UNSET
636};
637
4ad13663
N
638/* record the state of the bitmap in the superblock. Return the old value */
639static int bitmap_mask_state(struct bitmap *bitmap, enum bitmap_state bits,
640 enum bitmap_mask_op op)
32a7627c
N
641{
642 bitmap_super_t *sb;
643 unsigned long flags;
4ad13663 644 int old;
32a7627c
N
645
646 spin_lock_irqsave(&bitmap->lock, flags);
7e317655 647 if (!bitmap->sb_page) { /* can't set the state */
32a7627c 648 spin_unlock_irqrestore(&bitmap->lock, flags);
4ad13663 649 return 0;
32a7627c 650 }
32a7627c 651 spin_unlock_irqrestore(&bitmap->lock, flags);
ea03aff9 652 sb = (bitmap_super_t *)kmap_atomic(bitmap->sb_page, KM_USER0);
4ad13663 653 old = le32_to_cpu(sb->state) & bits;
32a7627c 654 switch (op) {
4f2e639a 655 case MASK_SET: sb->state |= cpu_to_le32(bits);
32a7627c 656 break;
4f2e639a 657 case MASK_UNSET: sb->state &= cpu_to_le32(~bits);
32a7627c
N
658 break;
659 default: BUG();
660 }
ea03aff9 661 kunmap_atomic(sb, KM_USER0);
4ad13663 662 return old;
32a7627c
N
663}
664
665/*
666 * general bitmap file operations
667 */
668
669/* calculate the index of the page that contains this bit */
670static inline unsigned long file_page_index(unsigned long chunk)
671{
672 return CHUNK_BIT_OFFSET(chunk) >> PAGE_BIT_SHIFT;
673}
674
675/* calculate the (bit) offset of this bit within a page */
676static inline unsigned long file_page_offset(unsigned long chunk)
677{
678 return CHUNK_BIT_OFFSET(chunk) & (PAGE_BITS - 1);
679}
680
681/*
682 * return a pointer to the page in the filemap that contains the given bit
683 *
684 * this lookup is complicated by the fact that the bitmap sb might be exactly
685 * 1 page (e.g., x86) or less than 1 page -- so the bitmap might start on page
686 * 0 or page 1
687 */
688static inline struct page *filemap_get_page(struct bitmap *bitmap,
689 unsigned long chunk)
690{
9b1d1dac 691 if (file_page_index(chunk) >= bitmap->file_pages) return NULL;
32a7627c
N
692 return bitmap->filemap[file_page_index(chunk) - file_page_index(0)];
693}
694
695
696static void bitmap_file_unmap(struct bitmap *bitmap)
697{
698 struct page **map, *sb_page;
699 unsigned long *attr;
700 int pages;
701 unsigned long flags;
702
703 spin_lock_irqsave(&bitmap->lock, flags);
704 map = bitmap->filemap;
705 bitmap->filemap = NULL;
706 attr = bitmap->filemap_attr;
707 bitmap->filemap_attr = NULL;
708 pages = bitmap->file_pages;
709 bitmap->file_pages = 0;
710 sb_page = bitmap->sb_page;
711 bitmap->sb_page = NULL;
712 spin_unlock_irqrestore(&bitmap->lock, flags);
713
714 while (pages--)
715 if (map[pages]->index != 0) /* 0 is sb_page, release it below */
d785a06a 716 free_buffers(map[pages]);
32a7627c
N
717 kfree(map);
718 kfree(attr);
719
d785a06a
N
720 if (sb_page)
721 free_buffers(sb_page);
32a7627c
N
722}
723
724static void bitmap_file_put(struct bitmap *bitmap)
725{
726 struct file *file;
32a7627c
N
727 unsigned long flags;
728
729 spin_lock_irqsave(&bitmap->lock, flags);
730 file = bitmap->file;
731 bitmap->file = NULL;
732 spin_unlock_irqrestore(&bitmap->lock, flags);
733
d785a06a
N
734 if (file)
735 wait_event(bitmap->write_wait,
736 atomic_read(&bitmap->pending_writes)==0);
32a7627c
N
737 bitmap_file_unmap(bitmap);
738
d785a06a 739 if (file) {
c649bb9c 740 struct inode *inode = file->f_path.dentry->d_inode;
fc0ecff6 741 invalidate_mapping_pages(inode->i_mapping, 0, -1);
32a7627c 742 fput(file);
d785a06a 743 }
32a7627c
N
744}
745
746
747/*
748 * bitmap_file_kick - if an error occurs while manipulating the bitmap file
749 * then it is no longer reliable, so we stop using it and we mark the file
750 * as failed in the superblock
751 */
752static void bitmap_file_kick(struct bitmap *bitmap)
753{
754 char *path, *ptr = NULL;
755
4ad13663
N
756 if (bitmap_mask_state(bitmap, BITMAP_STALE, MASK_SET) == 0) {
757 bitmap_update_sb(bitmap);
32a7627c 758
4ad13663
N
759 if (bitmap->file) {
760 path = kmalloc(PAGE_SIZE, GFP_KERNEL);
761 if (path)
6bcfd601
CH
762 ptr = d_path(&bitmap->file->f_path, path,
763 PAGE_SIZE);
764
32a7627c 765
4ad13663
N
766 printk(KERN_ALERT
767 "%s: kicking failed bitmap file %s from array!\n",
6bcfd601 768 bmname(bitmap), IS_ERR(ptr) ? "" : ptr);
32a7627c 769
4ad13663
N
770 kfree(path);
771 } else
772 printk(KERN_ALERT
773 "%s: disabling internal bitmap due to errors\n",
774 bmname(bitmap));
a654b9d8 775 }
32a7627c
N
776
777 bitmap_file_put(bitmap);
778
779 return;
780}
781
782enum bitmap_page_attr {
e16b68b6
N
783 BITMAP_PAGE_DIRTY = 0, // there are set bits that need to be synced
784 BITMAP_PAGE_CLEAN = 1, // there are bits that might need to be cleared
785 BITMAP_PAGE_NEEDWRITE=2, // there are cleared bits that need to be synced
32a7627c
N
786};
787
788static inline void set_page_attr(struct bitmap *bitmap, struct page *page,
789 enum bitmap_page_attr attr)
790{
e16b68b6 791 __set_bit((page->index<<2) + attr, bitmap->filemap_attr);
32a7627c
N
792}
793
794static inline void clear_page_attr(struct bitmap *bitmap, struct page *page,
795 enum bitmap_page_attr attr)
796{
e16b68b6 797 __clear_bit((page->index<<2) + attr, bitmap->filemap_attr);
32a7627c
N
798}
799
ec7a3197
N
800static inline unsigned long test_page_attr(struct bitmap *bitmap, struct page *page,
801 enum bitmap_page_attr attr)
32a7627c 802{
e16b68b6 803 return test_bit((page->index<<2) + attr, bitmap->filemap_attr);
32a7627c
N
804}
805
806/*
807 * bitmap_file_set_bit -- called before performing a write to the md device
808 * to set (and eventually sync) a particular bit in the bitmap file
809 *
810 * we set the bit immediately, then we record the page number so that
811 * when an unplug occurs, we can flush the dirty pages out to disk
812 */
813static void bitmap_file_set_bit(struct bitmap *bitmap, sector_t block)
814{
815 unsigned long bit;
816 struct page *page;
817 void *kaddr;
818 unsigned long chunk = block >> CHUNK_BLOCK_SHIFT(bitmap);
819
a654b9d8 820 if (!bitmap->filemap) {
32a7627c
N
821 return;
822 }
823
824 page = filemap_get_page(bitmap, chunk);
9b1d1dac 825 if (!page) return;
32a7627c
N
826 bit = file_page_offset(chunk);
827
32a7627c
N
828 /* set the bit */
829 kaddr = kmap_atomic(page, KM_USER0);
bd926c63
N
830 if (bitmap->flags & BITMAP_HOSTENDIAN)
831 set_bit(bit, kaddr);
832 else
833 ext2_set_bit(bit, kaddr);
32a7627c
N
834 kunmap_atomic(kaddr, KM_USER0);
835 PRINTK("set file bit %lu page %lu\n", bit, page->index);
836
837 /* record page number so it gets flushed to disk when unplug occurs */
838 set_page_attr(bitmap, page, BITMAP_PAGE_DIRTY);
839
840}
841
842/* this gets called when the md device is ready to unplug its underlying
843 * (slave) device queues -- before we let any writes go down, we need to
844 * sync the dirty pages of the bitmap file to disk */
4ad13663 845void bitmap_unplug(struct bitmap *bitmap)
32a7627c 846{
ec7a3197
N
847 unsigned long i, flags;
848 int dirty, need_write;
32a7627c
N
849 struct page *page;
850 int wait = 0;
851
852 if (!bitmap)
4ad13663 853 return;
32a7627c
N
854
855 /* look at each page to see if there are any set bits that need to be
856 * flushed out to disk */
857 for (i = 0; i < bitmap->file_pages; i++) {
858 spin_lock_irqsave(&bitmap->lock, flags);
a654b9d8 859 if (!bitmap->filemap) {
32a7627c 860 spin_unlock_irqrestore(&bitmap->lock, flags);
4ad13663 861 return;
32a7627c
N
862 }
863 page = bitmap->filemap[i];
ec7a3197
N
864 dirty = test_page_attr(bitmap, page, BITMAP_PAGE_DIRTY);
865 need_write = test_page_attr(bitmap, page, BITMAP_PAGE_NEEDWRITE);
32a7627c
N
866 clear_page_attr(bitmap, page, BITMAP_PAGE_DIRTY);
867 clear_page_attr(bitmap, page, BITMAP_PAGE_NEEDWRITE);
ec7a3197 868 if (dirty)
32a7627c
N
869 wait = 1;
870 spin_unlock_irqrestore(&bitmap->lock, flags);
871
d785a06a 872 if (dirty | need_write)
4ad13663 873 write_page(bitmap, page, 0);
32a7627c
N
874 }
875 if (wait) { /* if any writes were performed, we need to wait on them */
0b79ccf0 876 if (bitmap->file)
d785a06a
N
877 wait_event(bitmap->write_wait,
878 atomic_read(&bitmap->pending_writes)==0);
0b79ccf0 879 else
a9701a30 880 md_super_wait(bitmap->mddev);
32a7627c 881 }
d785a06a
N
882 if (bitmap->flags & BITMAP_WRITE_ERROR)
883 bitmap_file_kick(bitmap);
32a7627c
N
884}
885
6a07997f 886static void bitmap_set_memory_bits(struct bitmap *bitmap, sector_t offset, int needed);
32a7627c
N
887/* * bitmap_init_from_disk -- called at bitmap_create time to initialize
888 * the in-memory bitmap from the on-disk bitmap -- also, sets up the
889 * memory mapping of the bitmap file
890 * Special cases:
891 * if there's no bitmap file, or if the bitmap file had been
892 * previously kicked from the array, we mark all the bits as
893 * 1's in order to cause a full resync.
6a07997f
N
894 *
895 * We ignore all bits for sectors that end earlier than 'start'.
896 * This is used when reading an out-of-date bitmap...
32a7627c 897 */
6a07997f 898static int bitmap_init_from_disk(struct bitmap *bitmap, sector_t start)
32a7627c
N
899{
900 unsigned long i, chunks, index, oldindex, bit;
901 struct page *page = NULL, *oldpage = NULL;
902 unsigned long num_pages, bit_cnt = 0;
903 struct file *file;
d785a06a 904 unsigned long bytes, offset;
32a7627c
N
905 int outofdate;
906 int ret = -ENOSPC;
ea03aff9 907 void *paddr;
32a7627c
N
908
909 chunks = bitmap->chunks;
910 file = bitmap->file;
911
42a04b50 912 BUG_ON(!file && !bitmap->mddev->bitmap_info.offset);
32a7627c 913
44456d37 914#ifdef INJECT_FAULTS_3
32a7627c
N
915 outofdate = 1;
916#else
917 outofdate = bitmap->flags & BITMAP_STALE;
918#endif
919 if (outofdate)
920 printk(KERN_INFO "%s: bitmap file is out of date, doing full "
921 "recovery\n", bmname(bitmap));
922
923 bytes = (chunks + 7) / 8;
bc7f77de 924
cdbb4cc2 925 num_pages = (bytes + sizeof(bitmap_super_t) + PAGE_SIZE - 1) / PAGE_SIZE;
bc7f77de 926
a654b9d8 927 if (file && i_size_read(file->f_mapping->host) < bytes + sizeof(bitmap_super_t)) {
32a7627c
N
928 printk(KERN_INFO "%s: bitmap file too short %lu < %lu\n",
929 bmname(bitmap),
930 (unsigned long) i_size_read(file->f_mapping->host),
931 bytes + sizeof(bitmap_super_t));
4ad13663 932 goto err;
32a7627c 933 }
bc7f77de
N
934
935 ret = -ENOMEM;
936
32a7627c 937 bitmap->filemap = kmalloc(sizeof(struct page *) * num_pages, GFP_KERNEL);
bc7f77de 938 if (!bitmap->filemap)
4ad13663 939 goto err;
32a7627c 940
e16b68b6
N
941 /* We need 4 bits per page, rounded up to a multiple of sizeof(unsigned long) */
942 bitmap->filemap_attr = kzalloc(
505fa2c4 943 roundup( DIV_ROUND_UP(num_pages*4, 8), sizeof(unsigned long)),
e16b68b6 944 GFP_KERNEL);
bc7f77de 945 if (!bitmap->filemap_attr)
4ad13663 946 goto err;
32a7627c 947
32a7627c
N
948 oldindex = ~0L;
949
950 for (i = 0; i < chunks; i++) {
bd926c63 951 int b;
32a7627c
N
952 index = file_page_index(i);
953 bit = file_page_offset(i);
954 if (index != oldindex) { /* this is a new page, read it in */
d785a06a 955 int count;
32a7627c 956 /* unmap the old page, we're done with it */
d785a06a 957 if (index == num_pages-1)
f49d5e62
N
958 count = bytes + sizeof(bitmap_super_t)
959 - index * PAGE_SIZE;
d785a06a
N
960 else
961 count = PAGE_SIZE;
32a7627c
N
962 if (index == 0) {
963 /*
964 * if we're here then the superblock page
965 * contains some bits (PAGE_SIZE != sizeof sb)
966 * we've already read it in, so just use it
967 */
968 page = bitmap->sb_page;
969 offset = sizeof(bitmap_super_t);
53845270
N
970 if (!file)
971 read_sb_page(bitmap->mddev,
42a04b50 972 bitmap->mddev->bitmap_info.offset,
53845270
N
973 page,
974 index, count);
a654b9d8 975 } else if (file) {
d785a06a 976 page = read_page(file, index, bitmap, count);
a654b9d8
N
977 offset = 0;
978 } else {
42a04b50
N
979 page = read_sb_page(bitmap->mddev,
980 bitmap->mddev->bitmap_info.offset,
a2ed9615
N
981 NULL,
982 index, count);
32a7627c
N
983 offset = 0;
984 }
a654b9d8
N
985 if (IS_ERR(page)) { /* read error */
986 ret = PTR_ERR(page);
4ad13663 987 goto err;
a654b9d8
N
988 }
989
32a7627c
N
990 oldindex = index;
991 oldpage = page;
32a7627c 992
b74fd282
N
993 bitmap->filemap[bitmap->file_pages++] = page;
994 bitmap->last_page_size = count;
995
32a7627c
N
996 if (outofdate) {
997 /*
998 * if bitmap is out of date, dirty the
999 * whole page and write it out
1000 */
ea03aff9
N
1001 paddr = kmap_atomic(page, KM_USER0);
1002 memset(paddr + offset, 0xff,
6a07997f 1003 PAGE_SIZE - offset);
ea03aff9 1004 kunmap_atomic(paddr, KM_USER0);
4ad13663
N
1005 write_page(bitmap, page, 1);
1006
1007 ret = -EIO;
b74fd282 1008 if (bitmap->flags & BITMAP_WRITE_ERROR)
4ad13663 1009 goto err;
32a7627c 1010 }
32a7627c 1011 }
ea03aff9 1012 paddr = kmap_atomic(page, KM_USER0);
bd926c63 1013 if (bitmap->flags & BITMAP_HOSTENDIAN)
ea03aff9 1014 b = test_bit(bit, paddr);
bd926c63 1015 else
ea03aff9
N
1016 b = ext2_test_bit(bit, paddr);
1017 kunmap_atomic(paddr, KM_USER0);
bd926c63 1018 if (b) {
32a7627c 1019 /* if the disk bit is set, set the memory bit */
db305e50
N
1020 int needed = ((sector_t)(i+1) << (CHUNK_BLOCK_SHIFT(bitmap))
1021 >= start);
1022 bitmap_set_memory_bits(bitmap,
1023 (sector_t)i << CHUNK_BLOCK_SHIFT(bitmap),
1024 needed);
32a7627c 1025 bit_cnt++;
6a07997f 1026 set_page_attr(bitmap, page, BITMAP_PAGE_CLEAN);
32a7627c 1027 }
32a7627c
N
1028 }
1029
1030 /* everything went OK */
1031 ret = 0;
1032 bitmap_mask_state(bitmap, BITMAP_STALE, MASK_UNSET);
1033
32a7627c
N
1034 if (bit_cnt) { /* Kick recovery if any bits were set */
1035 set_bit(MD_RECOVERY_NEEDED, &bitmap->mddev->recovery);
1036 md_wakeup_thread(bitmap->mddev->thread);
1037 }
1038
32a7627c 1039 printk(KERN_INFO "%s: bitmap initialized from disk: "
4ad13663
N
1040 "read %lu/%lu pages, set %lu bits\n",
1041 bmname(bitmap), bitmap->file_pages, num_pages, bit_cnt);
1042
1043 return 0;
32a7627c 1044
4ad13663
N
1045 err:
1046 printk(KERN_INFO "%s: bitmap initialisation failed: %d\n",
1047 bmname(bitmap), ret);
32a7627c
N
1048 return ret;
1049}
1050
a654b9d8
N
1051void bitmap_write_all(struct bitmap *bitmap)
1052{
1053 /* We don't actually write all bitmap blocks here,
1054 * just flag them as needing to be written
1055 */
ec7a3197 1056 int i;
a654b9d8 1057
ec7a3197
N
1058 for (i=0; i < bitmap->file_pages; i++)
1059 set_page_attr(bitmap, bitmap->filemap[i],
1060 BITMAP_PAGE_NEEDWRITE);
a654b9d8
N
1061}
1062
32a7627c
N
1063
1064static void bitmap_count_page(struct bitmap *bitmap, sector_t offset, int inc)
1065{
1066 sector_t chunk = offset >> CHUNK_BLOCK_SHIFT(bitmap);
1067 unsigned long page = chunk >> PAGE_COUNTER_SHIFT;
1068 bitmap->bp[page].count += inc;
1069/*
1070 if (page == 0) printk("count page 0, offset %llu: %d gives %d\n",
1071 (unsigned long long)offset, inc, bitmap->bp[page].count);
1072*/
1073 bitmap_checkfree(bitmap, page);
1074}
1075static bitmap_counter_t *bitmap_get_counter(struct bitmap *bitmap,
1076 sector_t offset, int *blocks,
1077 int create);
1078
1079/*
1080 * bitmap daemon -- periodically wakes up to clean bits and flush pages
1081 * out to disk
1082 */
1083
aa5cbd10 1084void bitmap_daemon_work(mddev_t *mddev)
32a7627c 1085{
aa5cbd10 1086 struct bitmap *bitmap;
aa3163f8 1087 unsigned long j;
32a7627c
N
1088 unsigned long flags;
1089 struct page *page = NULL, *lastpage = NULL;
32a7627c 1090 int blocks;
ea03aff9 1091 void *paddr;
32a7627c 1092
aa5cbd10
N
1093 /* Use a mutex to guard daemon_work against
1094 * bitmap_destroy.
1095 */
c3d9714e 1096 mutex_lock(&mddev->bitmap_info.mutex);
aa5cbd10
N
1097 bitmap = mddev->bitmap;
1098 if (bitmap == NULL) {
c3d9714e 1099 mutex_unlock(&mddev->bitmap_info.mutex);
4ad13663 1100 return;
aa5cbd10 1101 }
42a04b50
N
1102 if (time_before(jiffies, bitmap->daemon_lastrun
1103 + bitmap->mddev->bitmap_info.daemon_sleep*HZ))
7be3dfec
N
1104 goto done;
1105
32a7627c 1106 bitmap->daemon_lastrun = jiffies;
8311c29d
N
1107 if (bitmap->allclean) {
1108 bitmap->mddev->thread->timeout = MAX_SCHEDULE_TIMEOUT;
aa5cbd10 1109 goto done;
8311c29d
N
1110 }
1111 bitmap->allclean = 1;
32a7627c 1112
be512691 1113 spin_lock_irqsave(&bitmap->lock, flags);
32a7627c
N
1114 for (j = 0; j < bitmap->chunks; j++) {
1115 bitmap_counter_t *bmc;
be512691 1116 if (!bitmap->filemap)
32a7627c 1117 /* error or shutdown */
32a7627c 1118 break;
32a7627c
N
1119
1120 page = filemap_get_page(bitmap, j);
32a7627c
N
1121
1122 if (page != lastpage) {
aa3163f8 1123 /* skip this page unless it's marked as needing cleaning */
ec7a3197
N
1124 if (!test_page_attr(bitmap, page, BITMAP_PAGE_CLEAN)) {
1125 int need_write = test_page_attr(bitmap, page,
1126 BITMAP_PAGE_NEEDWRITE);
a647e4bc 1127 if (need_write)
aa3163f8 1128 clear_page_attr(bitmap, page, BITMAP_PAGE_NEEDWRITE);
a647e4bc 1129
aa3163f8 1130 spin_unlock_irqrestore(&bitmap->lock, flags);
8311c29d 1131 if (need_write) {
4ad13663 1132 write_page(bitmap, page, 0);
8311c29d
N
1133 bitmap->allclean = 0;
1134 }
be512691
N
1135 spin_lock_irqsave(&bitmap->lock, flags);
1136 j |= (PAGE_BITS - 1);
aa3163f8
N
1137 continue;
1138 }
1139
32a7627c 1140 /* grab the new page, sync and release the old */
32a7627c 1141 if (lastpage != NULL) {
ec7a3197 1142 if (test_page_attr(bitmap, lastpage, BITMAP_PAGE_NEEDWRITE)) {
32a7627c
N
1143 clear_page_attr(bitmap, lastpage, BITMAP_PAGE_NEEDWRITE);
1144 spin_unlock_irqrestore(&bitmap->lock, flags);
4ad13663 1145 write_page(bitmap, lastpage, 0);
32a7627c
N
1146 } else {
1147 set_page_attr(bitmap, lastpage, BITMAP_PAGE_NEEDWRITE);
1148 spin_unlock_irqrestore(&bitmap->lock, flags);
1149 }
32a7627c
N
1150 } else
1151 spin_unlock_irqrestore(&bitmap->lock, flags);
1152 lastpage = page;
a0da84f3
NB
1153
1154 /* We are possibly going to clear some bits, so make
1155 * sure that events_cleared is up-to-date.
1156 */
1157 if (bitmap->need_sync) {
1158 bitmap_super_t *sb;
1159 bitmap->need_sync = 0;
1160 sb = kmap_atomic(bitmap->sb_page, KM_USER0);
1161 sb->events_cleared =
1162 cpu_to_le64(bitmap->events_cleared);
1163 kunmap_atomic(sb, KM_USER0);
1164 write_page(bitmap, bitmap->sb_page, 1);
1165 }
32a7627c
N
1166 spin_lock_irqsave(&bitmap->lock, flags);
1167 clear_page_attr(bitmap, page, BITMAP_PAGE_CLEAN);
1168 }
db305e50
N
1169 bmc = bitmap_get_counter(bitmap,
1170 (sector_t)j << CHUNK_BLOCK_SHIFT(bitmap),
1171 &blocks, 0);
32a7627c
N
1172 if (bmc) {
1173/*
1174 if (j < 100) printk("bitmap: j=%lu, *bmc = 0x%x\n", j, *bmc);
1175*/
8311c29d
N
1176 if (*bmc)
1177 bitmap->allclean = 0;
1178
32a7627c
N
1179 if (*bmc == 2) {
1180 *bmc=1; /* maybe clear the bit next time */
1181 set_page_attr(bitmap, page, BITMAP_PAGE_CLEAN);
1182 } else if (*bmc == 1) {
1183 /* we can clear the bit */
1184 *bmc = 0;
db305e50
N
1185 bitmap_count_page(bitmap,
1186 (sector_t)j << CHUNK_BLOCK_SHIFT(bitmap),
32a7627c
N
1187 -1);
1188
1189 /* clear the bit */
ea03aff9 1190 paddr = kmap_atomic(page, KM_USER0);
bd926c63 1191 if (bitmap->flags & BITMAP_HOSTENDIAN)
ea03aff9 1192 clear_bit(file_page_offset(j), paddr);
bd926c63 1193 else
ea03aff9
N
1194 ext2_clear_bit(file_page_offset(j), paddr);
1195 kunmap_atomic(paddr, KM_USER0);
32a7627c 1196 }
be512691
N
1197 } else
1198 j |= PAGE_COUNTER_MASK;
32a7627c 1199 }
be512691 1200 spin_unlock_irqrestore(&bitmap->lock, flags);
32a7627c
N
1201
1202 /* now sync the final page */
1203 if (lastpage != NULL) {
32a7627c 1204 spin_lock_irqsave(&bitmap->lock, flags);
ec7a3197 1205 if (test_page_attr(bitmap, lastpage, BITMAP_PAGE_NEEDWRITE)) {
32a7627c
N
1206 clear_page_attr(bitmap, lastpage, BITMAP_PAGE_NEEDWRITE);
1207 spin_unlock_irqrestore(&bitmap->lock, flags);
4ad13663 1208 write_page(bitmap, lastpage, 0);
32a7627c
N
1209 } else {
1210 set_page_attr(bitmap, lastpage, BITMAP_PAGE_NEEDWRITE);
1211 spin_unlock_irqrestore(&bitmap->lock, flags);
1212 }
32a7627c
N
1213 }
1214
7be3dfec 1215 done:
8311c29d 1216 if (bitmap->allclean == 0)
42a04b50
N
1217 bitmap->mddev->thread->timeout =
1218 bitmap->mddev->bitmap_info.daemon_sleep * HZ;
c3d9714e 1219 mutex_unlock(&mddev->bitmap_info.mutex);
32a7627c
N
1220}
1221
32a7627c
N
1222static bitmap_counter_t *bitmap_get_counter(struct bitmap *bitmap,
1223 sector_t offset, int *blocks,
1224 int create)
ee305ace
N
1225__releases(bitmap->lock)
1226__acquires(bitmap->lock)
32a7627c
N
1227{
1228 /* If 'create', we might release the lock and reclaim it.
1229 * The lock must have been taken with interrupts enabled.
1230 * If !create, we don't release the lock.
1231 */
1232 sector_t chunk = offset >> CHUNK_BLOCK_SHIFT(bitmap);
1233 unsigned long page = chunk >> PAGE_COUNTER_SHIFT;
1234 unsigned long pageoff = (chunk & PAGE_COUNTER_MASK) << COUNTER_BYTE_SHIFT;
1235 sector_t csize;
1236
1237 if (bitmap_checkpage(bitmap, page, create) < 0) {
1238 csize = ((sector_t)1) << (CHUNK_BLOCK_SHIFT(bitmap));
1239 *blocks = csize - (offset & (csize- 1));
1240 return NULL;
1241 }
1242 /* now locked ... */
1243
1244 if (bitmap->bp[page].hijacked) { /* hijacked pointer */
1245 /* should we use the first or second counter field
1246 * of the hijacked pointer? */
1247 int hi = (pageoff > PAGE_COUNTER_MASK);
1248 csize = ((sector_t)1) << (CHUNK_BLOCK_SHIFT(bitmap) +
1249 PAGE_COUNTER_SHIFT - 1);
1250 *blocks = csize - (offset & (csize- 1));
1251 return &((bitmap_counter_t *)
1252 &bitmap->bp[page].map)[hi];
1253 } else { /* page is allocated */
1254 csize = ((sector_t)1) << (CHUNK_BLOCK_SHIFT(bitmap));
1255 *blocks = csize - (offset & (csize- 1));
1256 return (bitmap_counter_t *)
1257 &(bitmap->bp[page].map[pageoff]);
1258 }
1259}
1260
4b6d287f 1261int bitmap_startwrite(struct bitmap *bitmap, sector_t offset, unsigned long sectors, int behind)
32a7627c
N
1262{
1263 if (!bitmap) return 0;
4b6d287f
N
1264
1265 if (behind) {
1266 atomic_inc(&bitmap->behind_writes);
1267 PRINTK(KERN_DEBUG "inc write-behind count %d/%d\n",
1268 atomic_read(&bitmap->behind_writes), bitmap->max_write_behind);
1269 }
1270
32a7627c
N
1271 while (sectors) {
1272 int blocks;
1273 bitmap_counter_t *bmc;
1274
1275 spin_lock_irq(&bitmap->lock);
1276 bmc = bitmap_get_counter(bitmap, offset, &blocks, 1);
1277 if (!bmc) {
1278 spin_unlock_irq(&bitmap->lock);
1279 return 0;
1280 }
1281
da6e1a32
NB
1282 if (unlikely((*bmc & COUNTER_MAX) == COUNTER_MAX)) {
1283 DEFINE_WAIT(__wait);
1284 /* note that it is safe to do the prepare_to_wait
1285 * after the test as long as we do it before dropping
1286 * the spinlock.
1287 */
1288 prepare_to_wait(&bitmap->overflow_wait, &__wait,
1289 TASK_UNINTERRUPTIBLE);
1290 spin_unlock_irq(&bitmap->lock);
2ad8b1ef 1291 blk_unplug(bitmap->mddev->queue);
da6e1a32
NB
1292 schedule();
1293 finish_wait(&bitmap->overflow_wait, &__wait);
1294 continue;
1295 }
1296
32a7627c
N
1297 switch(*bmc) {
1298 case 0:
1299 bitmap_file_set_bit(bitmap, offset);
1300 bitmap_count_page(bitmap,offset, 1);
93769f58 1301 blk_plug_device_unlocked(bitmap->mddev->queue);
32a7627c
N
1302 /* fall through */
1303 case 1:
1304 *bmc = 2;
1305 }
da6e1a32 1306
32a7627c
N
1307 (*bmc)++;
1308
1309 spin_unlock_irq(&bitmap->lock);
1310
1311 offset += blocks;
1312 if (sectors > blocks)
1313 sectors -= blocks;
1314 else sectors = 0;
1315 }
8311c29d 1316 bitmap->allclean = 0;
32a7627c
N
1317 return 0;
1318}
1319
1320void bitmap_endwrite(struct bitmap *bitmap, sector_t offset, unsigned long sectors,
4b6d287f 1321 int success, int behind)
32a7627c
N
1322{
1323 if (!bitmap) return;
4b6d287f
N
1324 if (behind) {
1325 atomic_dec(&bitmap->behind_writes);
1326 PRINTK(KERN_DEBUG "dec write-behind count %d/%d\n",
1327 atomic_read(&bitmap->behind_writes), bitmap->max_write_behind);
1328 }
d0a4bb49
N
1329 if (bitmap->mddev->degraded)
1330 /* Never clear bits or update events_cleared when degraded */
1331 success = 0;
4b6d287f 1332
32a7627c
N
1333 while (sectors) {
1334 int blocks;
1335 unsigned long flags;
1336 bitmap_counter_t *bmc;
1337
1338 spin_lock_irqsave(&bitmap->lock, flags);
1339 bmc = bitmap_get_counter(bitmap, offset, &blocks, 0);
1340 if (!bmc) {
1341 spin_unlock_irqrestore(&bitmap->lock, flags);
1342 return;
1343 }
1344
a0da84f3
NB
1345 if (success &&
1346 bitmap->events_cleared < bitmap->mddev->events) {
1347 bitmap->events_cleared = bitmap->mddev->events;
1348 bitmap->need_sync = 1;
1349 }
1350
32a7627c
N
1351 if (!success && ! (*bmc & NEEDED_MASK))
1352 *bmc |= NEEDED_MASK;
1353
da6e1a32
NB
1354 if ((*bmc & COUNTER_MAX) == COUNTER_MAX)
1355 wake_up(&bitmap->overflow_wait);
1356
32a7627c
N
1357 (*bmc)--;
1358 if (*bmc <= 2) {
1359 set_page_attr(bitmap,
1360 filemap_get_page(bitmap, offset >> CHUNK_BLOCK_SHIFT(bitmap)),
1361 BITMAP_PAGE_CLEAN);
1362 }
1363 spin_unlock_irqrestore(&bitmap->lock, flags);
1364 offset += blocks;
1365 if (sectors > blocks)
1366 sectors -= blocks;
1367 else sectors = 0;
1368 }
1369}
1370
1187cf0a
N
1371static int __bitmap_start_sync(struct bitmap *bitmap, sector_t offset, int *blocks,
1372 int degraded)
32a7627c
N
1373{
1374 bitmap_counter_t *bmc;
1375 int rv;
1376 if (bitmap == NULL) {/* FIXME or bitmap set as 'failed' */
1377 *blocks = 1024;
1378 return 1; /* always resync if no bitmap */
1379 }
1380 spin_lock_irq(&bitmap->lock);
1381 bmc = bitmap_get_counter(bitmap, offset, blocks, 0);
1382 rv = 0;
1383 if (bmc) {
1384 /* locked */
1385 if (RESYNC(*bmc))
1386 rv = 1;
1387 else if (NEEDED(*bmc)) {
1388 rv = 1;
6a806c51
N
1389 if (!degraded) { /* don't set/clear bits if degraded */
1390 *bmc |= RESYNC_MASK;
1391 *bmc &= ~NEEDED_MASK;
1392 }
32a7627c
N
1393 }
1394 }
1395 spin_unlock_irq(&bitmap->lock);
8311c29d 1396 bitmap->allclean = 0;
32a7627c
N
1397 return rv;
1398}
1399
1187cf0a
N
1400int bitmap_start_sync(struct bitmap *bitmap, sector_t offset, int *blocks,
1401 int degraded)
1402{
1403 /* bitmap_start_sync must always report on multiples of whole
1404 * pages, otherwise resync (which is very PAGE_SIZE based) will
1405 * get confused.
1406 * So call __bitmap_start_sync repeatedly (if needed) until
1407 * At least PAGE_SIZE>>9 blocks are covered.
1408 * Return the 'or' of the result.
1409 */
1410 int rv = 0;
1411 int blocks1;
1412
1413 *blocks = 0;
1414 while (*blocks < (PAGE_SIZE>>9)) {
1415 rv |= __bitmap_start_sync(bitmap, offset,
1416 &blocks1, degraded);
1417 offset += blocks1;
1418 *blocks += blocks1;
1419 }
1420 return rv;
1421}
1422
32a7627c
N
1423void bitmap_end_sync(struct bitmap *bitmap, sector_t offset, int *blocks, int aborted)
1424{
1425 bitmap_counter_t *bmc;
1426 unsigned long flags;
1427/*
1428 if (offset == 0) printk("bitmap_end_sync 0 (%d)\n", aborted);
1429*/ if (bitmap == NULL) {
1430 *blocks = 1024;
1431 return;
1432 }
1433 spin_lock_irqsave(&bitmap->lock, flags);
1434 bmc = bitmap_get_counter(bitmap, offset, blocks, 0);
1435 if (bmc == NULL)
1436 goto unlock;
1437 /* locked */
1438/*
1439 if (offset == 0) printk("bitmap_end sync found 0x%x, blocks %d\n", *bmc, *blocks);
1440*/
1441 if (RESYNC(*bmc)) {
1442 *bmc &= ~RESYNC_MASK;
1443
1444 if (!NEEDED(*bmc) && aborted)
1445 *bmc |= NEEDED_MASK;
1446 else {
1447 if (*bmc <= 2) {
1448 set_page_attr(bitmap,
1449 filemap_get_page(bitmap, offset >> CHUNK_BLOCK_SHIFT(bitmap)),
1450 BITMAP_PAGE_CLEAN);
1451 }
1452 }
1453 }
1454 unlock:
1455 spin_unlock_irqrestore(&bitmap->lock, flags);
8311c29d 1456 bitmap->allclean = 0;
32a7627c
N
1457}
1458
1459void bitmap_close_sync(struct bitmap *bitmap)
1460{
1461 /* Sync has finished, and any bitmap chunks that weren't synced
1462 * properly have been aborted. It remains to us to clear the
1463 * RESYNC bit wherever it is still on
1464 */
1465 sector_t sector = 0;
1466 int blocks;
b47490c9
N
1467 if (!bitmap)
1468 return;
32a7627c
N
1469 while (sector < bitmap->mddev->resync_max_sectors) {
1470 bitmap_end_sync(bitmap, sector, &blocks, 0);
b47490c9
N
1471 sector += blocks;
1472 }
1473}
1474
1475void bitmap_cond_end_sync(struct bitmap *bitmap, sector_t sector)
1476{
1477 sector_t s = 0;
1478 int blocks;
1479
1480 if (!bitmap)
1481 return;
1482 if (sector == 0) {
1483 bitmap->last_end_sync = jiffies;
1484 return;
1485 }
1486 if (time_before(jiffies, (bitmap->last_end_sync
42a04b50 1487 + bitmap->mddev->bitmap_info.daemon_sleep * HZ)))
b47490c9
N
1488 return;
1489 wait_event(bitmap->mddev->recovery_wait,
1490 atomic_read(&bitmap->mddev->recovery_active) == 0);
1491
97e4f42d
N
1492 bitmap->mddev->curr_resync_completed = bitmap->mddev->curr_resync;
1493 set_bit(MD_CHANGE_CLEAN, &bitmap->mddev->flags);
b47490c9
N
1494 sector &= ~((1ULL << CHUNK_BLOCK_SHIFT(bitmap)) - 1);
1495 s = 0;
1496 while (s < sector && s < bitmap->mddev->resync_max_sectors) {
1497 bitmap_end_sync(bitmap, s, &blocks, 0);
1498 s += blocks;
32a7627c 1499 }
b47490c9 1500 bitmap->last_end_sync = jiffies;
acb180b0 1501 sysfs_notify(&bitmap->mddev->kobj, NULL, "sync_completed");
32a7627c
N
1502}
1503
6a07997f 1504static void bitmap_set_memory_bits(struct bitmap *bitmap, sector_t offset, int needed)
32a7627c
N
1505{
1506 /* For each chunk covered by any of these sectors, set the
193f1c93 1507 * counter to 1 and set resync_needed. They should all
32a7627c
N
1508 * be 0 at this point
1509 */
193f1c93
N
1510
1511 int secs;
1512 bitmap_counter_t *bmc;
1513 spin_lock_irq(&bitmap->lock);
1514 bmc = bitmap_get_counter(bitmap, offset, &secs, 1);
1515 if (!bmc) {
32a7627c 1516 spin_unlock_irq(&bitmap->lock);
193f1c93 1517 return;
32a7627c 1518 }
193f1c93
N
1519 if (! *bmc) {
1520 struct page *page;
6a07997f 1521 *bmc = 1 | (needed?NEEDED_MASK:0);
193f1c93
N
1522 bitmap_count_page(bitmap, offset, 1);
1523 page = filemap_get_page(bitmap, offset >> CHUNK_BLOCK_SHIFT(bitmap));
1524 set_page_attr(bitmap, page, BITMAP_PAGE_CLEAN);
1525 }
1526 spin_unlock_irq(&bitmap->lock);
8311c29d 1527 bitmap->allclean = 0;
32a7627c
N
1528}
1529
9b1d1dac
PC
1530/* dirty the memory and file bits for bitmap chunks "s" to "e" */
1531void bitmap_dirty_bits(struct bitmap *bitmap, unsigned long s, unsigned long e)
1532{
1533 unsigned long chunk;
1534
1535 for (chunk = s; chunk <= e; chunk++) {
db305e50 1536 sector_t sec = (sector_t)chunk << CHUNK_BLOCK_SHIFT(bitmap);
9b1d1dac
PC
1537 bitmap_set_memory_bits(bitmap, sec, 1);
1538 bitmap_file_set_bit(bitmap, sec);
1539 }
1540}
1541
6b8b3e8a
N
1542/*
1543 * flush out any pending updates
1544 */
1545void bitmap_flush(mddev_t *mddev)
1546{
1547 struct bitmap *bitmap = mddev->bitmap;
42a04b50 1548 long sleep;
6b8b3e8a
N
1549
1550 if (!bitmap) /* there was no bitmap */
1551 return;
1552
1553 /* run the daemon_work three time to ensure everything is flushed
1554 * that can be
1555 */
42a04b50
N
1556 sleep = mddev->bitmap_info.daemon_sleep * HZ * 2;
1557 bitmap->daemon_lastrun -= sleep;
aa5cbd10 1558 bitmap_daemon_work(mddev);
42a04b50 1559 bitmap->daemon_lastrun -= sleep;
aa5cbd10 1560 bitmap_daemon_work(mddev);
42a04b50 1561 bitmap->daemon_lastrun -= sleep;
aa5cbd10 1562 bitmap_daemon_work(mddev);
6b8b3e8a
N
1563 bitmap_update_sb(bitmap);
1564}
1565
32a7627c
N
1566/*
1567 * free memory that was allocated
1568 */
3178b0db 1569static void bitmap_free(struct bitmap *bitmap)
32a7627c
N
1570{
1571 unsigned long k, pages;
1572 struct bitmap_page *bp;
32a7627c
N
1573
1574 if (!bitmap) /* there was no bitmap */
1575 return;
1576
32a7627c
N
1577 /* release the bitmap file and kill the daemon */
1578 bitmap_file_put(bitmap);
1579
1580 bp = bitmap->bp;
1581 pages = bitmap->pages;
1582
1583 /* free all allocated memory */
1584
32a7627c
N
1585 if (bp) /* deallocate the page memory */
1586 for (k = 0; k < pages; k++)
1587 if (bp[k].map && !bp[k].hijacked)
1588 kfree(bp[k].map);
1589 kfree(bp);
1590 kfree(bitmap);
1591}
aa5cbd10 1592
3178b0db
N
1593void bitmap_destroy(mddev_t *mddev)
1594{
1595 struct bitmap *bitmap = mddev->bitmap;
1596
1597 if (!bitmap) /* there was no bitmap */
1598 return;
1599
c3d9714e 1600 mutex_lock(&mddev->bitmap_info.mutex);
3178b0db 1601 mddev->bitmap = NULL; /* disconnect from the md device */
c3d9714e 1602 mutex_unlock(&mddev->bitmap_info.mutex);
b15c2e57
N
1603 if (mddev->thread)
1604 mddev->thread->timeout = MAX_SCHEDULE_TIMEOUT;
3178b0db
N
1605
1606 bitmap_free(bitmap);
1607}
32a7627c
N
1608
1609/*
1610 * initialize the bitmap structure
1611 * if this returns an error, bitmap_destroy must be called to do clean up
1612 */
1613int bitmap_create(mddev_t *mddev)
1614{
1615 struct bitmap *bitmap;
1f593903 1616 sector_t blocks = mddev->resync_max_sectors;
32a7627c
N
1617 unsigned long chunks;
1618 unsigned long pages;
c3d9714e 1619 struct file *file = mddev->bitmap_info.file;
32a7627c 1620 int err;
6a07997f 1621 sector_t start;
32a7627c 1622
5f6e3c83 1623 BUILD_BUG_ON(sizeof(bitmap_super_t) != 256);
32a7627c 1624
c3d9714e 1625 if (!file && !mddev->bitmap_info.offset) /* bitmap disabled, nothing to do */
32a7627c
N
1626 return 0;
1627
c3d9714e 1628 BUG_ON(file && mddev->bitmap_info.offset);
a654b9d8 1629
9ffae0cf 1630 bitmap = kzalloc(sizeof(*bitmap), GFP_KERNEL);
32a7627c
N
1631 if (!bitmap)
1632 return -ENOMEM;
1633
32a7627c 1634 spin_lock_init(&bitmap->lock);
ce25c31b
N
1635 atomic_set(&bitmap->pending_writes, 0);
1636 init_waitqueue_head(&bitmap->write_wait);
da6e1a32 1637 init_waitqueue_head(&bitmap->overflow_wait);
ce25c31b 1638
32a7627c 1639 bitmap->mddev = mddev;
32a7627c 1640
32a7627c 1641 bitmap->file = file;
ce25c31b
N
1642 if (file) {
1643 get_file(file);
ae8fa283
N
1644 /* As future accesses to this file will use bmap,
1645 * and bypass the page cache, we must sync the file
1646 * first.
1647 */
1648 vfs_fsync(file, file->f_dentry, 1);
ce25c31b 1649 }
42a04b50 1650 /* read superblock from bitmap file (this sets mddev->bitmap_info.chunksize) */
32a7627c
N
1651 err = bitmap_read_sb(bitmap);
1652 if (err)
3178b0db 1653 goto error;
32a7627c 1654
42a04b50 1655 bitmap->chunkshift = ffz(~mddev->bitmap_info.chunksize);
32a7627c
N
1656
1657 /* now that chunksize and chunkshift are set, we can use these macros */
1f593903
N
1658 chunks = (blocks + CHUNK_BLOCK_RATIO(bitmap) - 1) >>
1659 CHUNK_BLOCK_SHIFT(bitmap);
32a7627c
N
1660 pages = (chunks + PAGE_COUNTER_RATIO - 1) / PAGE_COUNTER_RATIO;
1661
1662 BUG_ON(!pages);
1663
1664 bitmap->chunks = chunks;
1665 bitmap->pages = pages;
1666 bitmap->missing_pages = pages;
1667 bitmap->counter_bits = COUNTER_BITS;
1668
1669 bitmap->syncchunk = ~0UL;
1670
44456d37 1671#ifdef INJECT_FATAL_FAULT_1
32a7627c
N
1672 bitmap->bp = NULL;
1673#else
9ffae0cf 1674 bitmap->bp = kzalloc(pages * sizeof(*bitmap->bp), GFP_KERNEL);
32a7627c 1675#endif
3178b0db 1676 err = -ENOMEM;
32a7627c 1677 if (!bitmap->bp)
3178b0db 1678 goto error;
32a7627c 1679
32a7627c
N
1680 /* now that we have some pages available, initialize the in-memory
1681 * bitmap from the on-disk bitmap */
6a07997f
N
1682 start = 0;
1683 if (mddev->degraded == 0
1684 || bitmap->events_cleared == mddev->events)
1685 /* no need to keep dirty bits to optimise a re-add of a missing device */
1686 start = mddev->recovery_cp;
1687 err = bitmap_init_from_disk(bitmap, start);
193f1c93 1688
32a7627c 1689 if (err)
3178b0db 1690 goto error;
32a7627c
N
1691
1692 printk(KERN_INFO "created bitmap (%lu pages) for device %s\n",
1693 pages, bmname(bitmap));
1694
3178b0db
N
1695 mddev->bitmap = bitmap;
1696
42a04b50 1697 mddev->thread->timeout = mddev->bitmap_info.daemon_sleep * HZ;
b15c2e57 1698
4ad13663
N
1699 bitmap_update_sb(bitmap);
1700
1701 return (bitmap->flags & BITMAP_WRITE_ERROR) ? -EIO : 0;
3178b0db
N
1702
1703 error:
1704 bitmap_free(bitmap);
1705 return err;
32a7627c
N
1706}
1707
1708/* the bitmap API -- for raid personalities */
1709EXPORT_SYMBOL(bitmap_startwrite);
1710EXPORT_SYMBOL(bitmap_endwrite);
1711EXPORT_SYMBOL(bitmap_start_sync);
1712EXPORT_SYMBOL(bitmap_end_sync);
1713EXPORT_SYMBOL(bitmap_unplug);
1714EXPORT_SYMBOL(bitmap_close_sync);
b47490c9 1715EXPORT_SYMBOL(bitmap_cond_end_sync);