2 * bitmap.c two-level bitmap (C) Peter T. Breuer (ptb@ot.uc3m.es) 2003
4 * bitmap_create - sets up the bitmap structure
5 * bitmap_destroy - destroys the bitmap structure
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
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.
19 #include <linux/module.h>
20 #include <linux/errno.h>
21 #include <linux/slab.h>
22 #include <linux/init.h>
23 #include <linux/timer.h>
24 #include <linux/sched.h>
25 #include <linux/list.h>
26 #include <linux/file.h>
27 #include <linux/mount.h>
28 #include <linux/buffer_head.h>
29 #include <linux/raid/md.h>
30 #include <linux/raid/bitmap.h>
37 /* these are for debugging purposes only! */
39 /* define one and only one of these */
40 #define INJECT_FAULTS_1 0 /* cause bitmap_alloc_page to fail always */
41 #define INJECT_FAULTS_2 0 /* cause bitmap file to be kicked when first bit set*/
42 #define INJECT_FAULTS_3 0 /* treat bitmap file as kicked at init time */
43 #define INJECT_FAULTS_4 0 /* undef */
44 #define INJECT_FAULTS_5 0 /* undef */
45 #define INJECT_FAULTS_6 0
47 /* if these are defined, the driver will fail! debug only */
48 #define INJECT_FATAL_FAULT_1 0 /* fail kmalloc, causing bitmap_create to fail */
49 #define INJECT_FATAL_FAULT_2 0 /* undef */
50 #define INJECT_FATAL_FAULT_3 0 /* undef */
53 //#define DPRINTK PRINTK /* set this NULL to avoid verbose debug output */
54 #define DPRINTK(x...) do { } while(0)
58 # define PRINTK(x...) printk(KERN_DEBUG x)
64 static inline char * bmname(struct bitmap
*bitmap
)
66 return bitmap
->mddev
? mdname(bitmap
->mddev
) : "mdX";
71 * just a placeholder - calls kmalloc for bitmap pages
73 static unsigned char *bitmap_alloc_page(struct bitmap
*bitmap
)
77 #ifdef INJECT_FAULTS_1
80 page
= kmalloc(PAGE_SIZE
, GFP_NOIO
);
83 printk("%s: bitmap_alloc_page FAILED\n", bmname(bitmap
));
85 PRINTK("%s: bitmap_alloc_page: allocated page at %p\n",
86 bmname(bitmap
), page
);
91 * for now just a placeholder -- just calls kfree for bitmap pages
93 static void bitmap_free_page(struct bitmap
*bitmap
, unsigned char *page
)
95 PRINTK("%s: bitmap_free_page: free page %p\n", bmname(bitmap
), page
);
100 * check a page and, if necessary, allocate it (or hijack it if the alloc fails)
102 * 1) check to see if this page is allocated, if it's not then try to alloc
103 * 2) if the alloc fails, set the page's hijacked flag so we'll use the
104 * page pointer directly as a counter
106 * if we find our page, we increment the page's refcount so that it stays
107 * allocated while we're using it
109 static int bitmap_checkpage(struct bitmap
*bitmap
, unsigned long page
, int create
)
111 unsigned char *mappage
;
113 if (page
>= bitmap
->pages
) {
115 "%s: invalid bitmap page request: %lu (> %lu)\n",
116 bmname(bitmap
), page
, bitmap
->pages
-1);
121 if (bitmap
->bp
[page
].hijacked
) /* it's hijacked, don't try to alloc */
124 if (bitmap
->bp
[page
].map
) /* page is already allocated, just return */
130 spin_unlock_irq(&bitmap
->lock
);
132 /* this page has not been allocated yet */
134 if ((mappage
= bitmap_alloc_page(bitmap
)) == NULL
) {
135 PRINTK("%s: bitmap map page allocation failed, hijacking\n",
137 /* failed - set the hijacked flag so that we can use the
138 * pointer as a counter */
139 spin_lock_irq(&bitmap
->lock
);
140 if (!bitmap
->bp
[page
].map
)
141 bitmap
->bp
[page
].hijacked
= 1;
147 spin_lock_irq(&bitmap
->lock
);
149 /* recheck the page */
151 if (bitmap
->bp
[page
].map
|| bitmap
->bp
[page
].hijacked
) {
152 /* somebody beat us to getting the page */
153 bitmap_free_page(bitmap
, mappage
);
157 /* no page was in place and we have one, so install it */
159 memset(mappage
, 0, PAGE_SIZE
);
160 bitmap
->bp
[page
].map
= mappage
;
161 bitmap
->missing_pages
--;
167 /* if page is completely empty, put it back on the free list, or dealloc it */
168 /* if page was hijacked, unmark the flag so it might get alloced next time */
169 /* Note: lock should be held when calling this */
170 static void bitmap_checkfree(struct bitmap
*bitmap
, unsigned long page
)
174 if (bitmap
->bp
[page
].count
) /* page is still busy */
177 /* page is no longer in use, it can be released */
179 if (bitmap
->bp
[page
].hijacked
) { /* page was hijacked, undo this now */
180 bitmap
->bp
[page
].hijacked
= 0;
181 bitmap
->bp
[page
].map
= NULL
;
185 /* normal case, free the page */
188 /* actually ... let's not. We will probably need the page again exactly when
189 * memory is tight and we are flusing to disk
193 ptr
= bitmap
->bp
[page
].map
;
194 bitmap
->bp
[page
].map
= NULL
;
195 bitmap
->missing_pages
++;
196 bitmap_free_page(bitmap
, ptr
);
203 * bitmap file handling - read and write the bitmap file and its superblock
206 /* copy the pathname of a file to a buffer */
207 char *file_path(struct file
*file
, char *buf
, int count
)
215 d
= file
->f_path
.dentry
;
216 v
= file
->f_path
.mnt
;
218 buf
= d_path(d
, v
, buf
, count
);
220 return IS_ERR(buf
) ? NULL
: buf
;
224 * basic page I/O operations
227 /* IO operations when bitmap is stored near all superblocks */
228 static struct page
*read_sb_page(mddev_t
*mddev
, long offset
, unsigned long index
)
230 /* choose a good rdev and read the page from there */
233 struct list_head
*tmp
;
234 struct page
*page
= alloc_page(GFP_KERNEL
);
238 return ERR_PTR(-ENOMEM
);
240 ITERATE_RDEV(mddev
, rdev
, tmp
) {
241 if (! test_bit(In_sync
, &rdev
->flags
)
242 || test_bit(Faulty
, &rdev
->flags
))
245 target
= (rdev
->sb_offset
<< 1) + offset
+ index
* (PAGE_SIZE
/512);
247 if (sync_page_io(rdev
->bdev
, target
, PAGE_SIZE
, page
, READ
)) {
249 attach_page_buffers(page
, NULL
); /* so that free_buffer will
254 return ERR_PTR(-EIO
);
258 static int write_sb_page(mddev_t
*mddev
, long offset
, struct page
*page
, int wait
)
261 struct list_head
*tmp
;
263 ITERATE_RDEV(mddev
, rdev
, tmp
)
264 if (test_bit(In_sync
, &rdev
->flags
)
265 && !test_bit(Faulty
, &rdev
->flags
))
266 md_super_write(mddev
, rdev
,
267 (rdev
->sb_offset
<<1) + offset
268 + page
->index
* (PAGE_SIZE
/512),
273 md_super_wait(mddev
);
278 * write out a page to a file
280 static int write_page(struct bitmap
*bitmap
, struct page
*page
, int wait
)
282 struct buffer_head
*bh
;
284 if (bitmap
->file
== NULL
)
285 return write_sb_page(bitmap
->mddev
, bitmap
->offset
, page
, wait
);
287 bh
= page_buffers(page
);
289 while (bh
&& bh
->b_blocknr
) {
290 atomic_inc(&bitmap
->pending_writes
);
291 set_buffer_locked(bh
);
292 set_buffer_mapped(bh
);
293 submit_bh(WRITE
, bh
);
294 bh
= bh
->b_this_page
;
298 wait_event(bitmap
->write_wait
,
299 atomic_read(&bitmap
->pending_writes
)==0);
300 return (bitmap
->flags
& BITMAP_WRITE_ERROR
) ? -EIO
: 0;
305 static void end_bitmap_write(struct buffer_head
*bh
, int uptodate
)
307 struct bitmap
*bitmap
= bh
->b_private
;
311 spin_lock_irqsave(&bitmap
->lock
, flags
);
312 bitmap
->flags
|= BITMAP_WRITE_ERROR
;
313 spin_unlock_irqrestore(&bitmap
->lock
, flags
);
315 if (atomic_dec_and_test(&bitmap
->pending_writes
))
316 wake_up(&bitmap
->write_wait
);
319 /* copied from buffer.c */
321 __clear_page_buffers(struct page
*page
)
323 ClearPagePrivate(page
);
324 set_page_private(page
, 0);
325 page_cache_release(page
);
327 static void free_buffers(struct page
*page
)
329 struct buffer_head
*bh
= page_buffers(page
);
332 struct buffer_head
*next
= bh
->b_this_page
;
333 free_buffer_head(bh
);
336 __clear_page_buffers(page
);
340 /* read a page from a file.
341 * We both read the page, and attach buffers to the page to record the
342 * address of each block (using bmap). These addresses will be used
343 * to write the block later, completely bypassing the filesystem.
344 * This usage is similar to how swap files are handled, and allows us
345 * to write to a file with no concerns of memory allocation failing.
347 static struct page
*read_page(struct file
*file
, unsigned long index
,
348 struct bitmap
*bitmap
,
351 struct page
*page
= NULL
;
352 struct inode
*inode
= file
->f_path
.dentry
->d_inode
;
353 struct buffer_head
*bh
;
356 PRINTK("read bitmap file (%dB @ %Lu)\n", (int)PAGE_SIZE
,
357 (unsigned long long)index
<< PAGE_SHIFT
);
359 page
= alloc_page(GFP_KERNEL
);
361 page
= ERR_PTR(-ENOMEM
);
365 bh
= alloc_page_buffers(page
, 1<<inode
->i_blkbits
, 0);
368 page
= ERR_PTR(-ENOMEM
);
371 attach_page_buffers(page
, bh
);
372 block
= index
<< (PAGE_SHIFT
- inode
->i_blkbits
);
377 bh
->b_blocknr
= bmap(inode
, block
);
378 if (bh
->b_blocknr
== 0) {
379 /* Cannot use this file! */
381 page
= ERR_PTR(-EINVAL
);
384 bh
->b_bdev
= inode
->i_sb
->s_bdev
;
385 if (count
< (1<<inode
->i_blkbits
))
388 count
-= (1<<inode
->i_blkbits
);
390 bh
->b_end_io
= end_bitmap_write
;
391 bh
->b_private
= bitmap
;
392 atomic_inc(&bitmap
->pending_writes
);
393 set_buffer_locked(bh
);
394 set_buffer_mapped(bh
);
398 bh
= bh
->b_this_page
;
402 wait_event(bitmap
->write_wait
,
403 atomic_read(&bitmap
->pending_writes
)==0);
404 if (bitmap
->flags
& BITMAP_WRITE_ERROR
) {
406 page
= ERR_PTR(-EIO
);
410 printk(KERN_ALERT
"md: bitmap read error: (%dB @ %Lu): %ld\n",
412 (unsigned long long)index
<< PAGE_SHIFT
,
418 * bitmap file superblock operations
421 /* update the event counter and sync the superblock to disk */
422 int bitmap_update_sb(struct bitmap
*bitmap
)
427 if (!bitmap
|| !bitmap
->mddev
) /* no bitmap for this array */
429 spin_lock_irqsave(&bitmap
->lock
, flags
);
430 if (!bitmap
->sb_page
) { /* no superblock */
431 spin_unlock_irqrestore(&bitmap
->lock
, flags
);
434 spin_unlock_irqrestore(&bitmap
->lock
, flags
);
435 sb
= (bitmap_super_t
*)kmap_atomic(bitmap
->sb_page
, KM_USER0
);
436 sb
->events
= cpu_to_le64(bitmap
->mddev
->events
);
437 if (!bitmap
->mddev
->degraded
)
438 sb
->events_cleared
= cpu_to_le64(bitmap
->mddev
->events
);
439 kunmap_atomic(sb
, KM_USER0
);
440 return write_page(bitmap
, bitmap
->sb_page
, 1);
443 /* print out the bitmap file superblock */
444 void bitmap_print_sb(struct bitmap
*bitmap
)
448 if (!bitmap
|| !bitmap
->sb_page
)
450 sb
= (bitmap_super_t
*)kmap_atomic(bitmap
->sb_page
, KM_USER0
);
451 printk(KERN_DEBUG
"%s: bitmap file superblock:\n", bmname(bitmap
));
452 printk(KERN_DEBUG
" magic: %08x\n", le32_to_cpu(sb
->magic
));
453 printk(KERN_DEBUG
" version: %d\n", le32_to_cpu(sb
->version
));
454 printk(KERN_DEBUG
" uuid: %08x.%08x.%08x.%08x\n",
455 *(__u32
*)(sb
->uuid
+0),
456 *(__u32
*)(sb
->uuid
+4),
457 *(__u32
*)(sb
->uuid
+8),
458 *(__u32
*)(sb
->uuid
+12));
459 printk(KERN_DEBUG
" events: %llu\n",
460 (unsigned long long) le64_to_cpu(sb
->events
));
461 printk(KERN_DEBUG
"events cleared: %llu\n",
462 (unsigned long long) le64_to_cpu(sb
->events_cleared
));
463 printk(KERN_DEBUG
" state: %08x\n", le32_to_cpu(sb
->state
));
464 printk(KERN_DEBUG
" chunksize: %d B\n", le32_to_cpu(sb
->chunksize
));
465 printk(KERN_DEBUG
" daemon sleep: %ds\n", le32_to_cpu(sb
->daemon_sleep
));
466 printk(KERN_DEBUG
" sync size: %llu KB\n",
467 (unsigned long long)le64_to_cpu(sb
->sync_size
)/2);
468 printk(KERN_DEBUG
"max write behind: %d\n", le32_to_cpu(sb
->write_behind
));
469 kunmap_atomic(sb
, KM_USER0
);
472 /* read the superblock from the bitmap file and initialize some bitmap fields */
473 static int bitmap_read_sb(struct bitmap
*bitmap
)
477 unsigned long chunksize
, daemon_sleep
, write_behind
;
478 unsigned long long events
;
481 /* page 0 is the superblock, read it... */
483 loff_t isize
= i_size_read(bitmap
->file
->f_mapping
->host
);
484 int bytes
= isize
> PAGE_SIZE
? PAGE_SIZE
: isize
;
486 bitmap
->sb_page
= read_page(bitmap
->file
, 0, bitmap
, bytes
);
488 bitmap
->sb_page
= read_sb_page(bitmap
->mddev
, bitmap
->offset
, 0);
490 if (IS_ERR(bitmap
->sb_page
)) {
491 err
= PTR_ERR(bitmap
->sb_page
);
492 bitmap
->sb_page
= NULL
;
496 sb
= (bitmap_super_t
*)kmap_atomic(bitmap
->sb_page
, KM_USER0
);
498 chunksize
= le32_to_cpu(sb
->chunksize
);
499 daemon_sleep
= le32_to_cpu(sb
->daemon_sleep
);
500 write_behind
= le32_to_cpu(sb
->write_behind
);
502 /* verify that the bitmap-specific fields are valid */
503 if (sb
->magic
!= cpu_to_le32(BITMAP_MAGIC
))
504 reason
= "bad magic";
505 else if (le32_to_cpu(sb
->version
) < BITMAP_MAJOR_LO
||
506 le32_to_cpu(sb
->version
) > BITMAP_MAJOR_HI
)
507 reason
= "unrecognized superblock version";
508 else if (chunksize
< PAGE_SIZE
)
509 reason
= "bitmap chunksize too small";
510 else if ((1 << ffz(~chunksize
)) != chunksize
)
511 reason
= "bitmap chunksize not a power of 2";
512 else if (daemon_sleep
< 1 || daemon_sleep
> MAX_SCHEDULE_TIMEOUT
/ HZ
)
513 reason
= "daemon sleep period out of range";
514 else if (write_behind
> COUNTER_MAX
)
515 reason
= "write-behind limit out of range (0 - 16383)";
517 printk(KERN_INFO
"%s: invalid bitmap file superblock: %s\n",
518 bmname(bitmap
), reason
);
522 /* keep the array size field of the bitmap superblock up to date */
523 sb
->sync_size
= cpu_to_le64(bitmap
->mddev
->resync_max_sectors
);
525 if (!bitmap
->mddev
->persistent
)
529 * if we have a persistent array superblock, compare the
530 * bitmap's UUID and event counter to the mddev's
532 if (memcmp(sb
->uuid
, bitmap
->mddev
->uuid
, 16)) {
533 printk(KERN_INFO
"%s: bitmap superblock UUID mismatch\n",
537 events
= le64_to_cpu(sb
->events
);
538 if (events
< bitmap
->mddev
->events
) {
539 printk(KERN_INFO
"%s: bitmap file is out of date (%llu < %llu) "
540 "-- forcing full recovery\n", bmname(bitmap
), events
,
541 (unsigned long long) bitmap
->mddev
->events
);
542 sb
->state
|= cpu_to_le32(BITMAP_STALE
);
545 /* assign fields using values from superblock */
546 bitmap
->chunksize
= chunksize
;
547 bitmap
->daemon_sleep
= daemon_sleep
;
548 bitmap
->daemon_lastrun
= jiffies
;
549 bitmap
->max_write_behind
= write_behind
;
550 bitmap
->flags
|= le32_to_cpu(sb
->state
);
551 if (le32_to_cpu(sb
->version
) == BITMAP_MAJOR_HOSTENDIAN
)
552 bitmap
->flags
|= BITMAP_HOSTENDIAN
;
553 bitmap
->events_cleared
= le64_to_cpu(sb
->events_cleared
);
554 if (sb
->state
& cpu_to_le32(BITMAP_STALE
))
555 bitmap
->events_cleared
= bitmap
->mddev
->events
;
558 kunmap_atomic(sb
, KM_USER0
);
560 bitmap_print_sb(bitmap
);
564 enum bitmap_mask_op
{
569 /* record the state of the bitmap in the superblock */
570 static void bitmap_mask_state(struct bitmap
*bitmap
, enum bitmap_state bits
,
571 enum bitmap_mask_op op
)
576 spin_lock_irqsave(&bitmap
->lock
, flags
);
577 if (!bitmap
->sb_page
) { /* can't set the state */
578 spin_unlock_irqrestore(&bitmap
->lock
, flags
);
581 spin_unlock_irqrestore(&bitmap
->lock
, flags
);
582 sb
= (bitmap_super_t
*)kmap_atomic(bitmap
->sb_page
, KM_USER0
);
584 case MASK_SET
: sb
->state
|= cpu_to_le32(bits
);
586 case MASK_UNSET
: sb
->state
&= cpu_to_le32(~bits
);
590 kunmap_atomic(sb
, KM_USER0
);
594 * general bitmap file operations
597 /* calculate the index of the page that contains this bit */
598 static inline unsigned long file_page_index(unsigned long chunk
)
600 return CHUNK_BIT_OFFSET(chunk
) >> PAGE_BIT_SHIFT
;
603 /* calculate the (bit) offset of this bit within a page */
604 static inline unsigned long file_page_offset(unsigned long chunk
)
606 return CHUNK_BIT_OFFSET(chunk
) & (PAGE_BITS
- 1);
610 * return a pointer to the page in the filemap that contains the given bit
612 * this lookup is complicated by the fact that the bitmap sb might be exactly
613 * 1 page (e.g., x86) or less than 1 page -- so the bitmap might start on page
616 static inline struct page
*filemap_get_page(struct bitmap
*bitmap
,
619 if (file_page_index(chunk
) >= bitmap
->file_pages
) return NULL
;
620 return bitmap
->filemap
[file_page_index(chunk
) - file_page_index(0)];
624 static void bitmap_file_unmap(struct bitmap
*bitmap
)
626 struct page
**map
, *sb_page
;
631 spin_lock_irqsave(&bitmap
->lock
, flags
);
632 map
= bitmap
->filemap
;
633 bitmap
->filemap
= NULL
;
634 attr
= bitmap
->filemap_attr
;
635 bitmap
->filemap_attr
= NULL
;
636 pages
= bitmap
->file_pages
;
637 bitmap
->file_pages
= 0;
638 sb_page
= bitmap
->sb_page
;
639 bitmap
->sb_page
= NULL
;
640 spin_unlock_irqrestore(&bitmap
->lock
, flags
);
643 if (map
[pages
]->index
!= 0) /* 0 is sb_page, release it below */
644 free_buffers(map
[pages
]);
649 free_buffers(sb_page
);
652 static void bitmap_file_put(struct bitmap
*bitmap
)
657 spin_lock_irqsave(&bitmap
->lock
, flags
);
660 spin_unlock_irqrestore(&bitmap
->lock
, flags
);
663 wait_event(bitmap
->write_wait
,
664 atomic_read(&bitmap
->pending_writes
)==0);
665 bitmap_file_unmap(bitmap
);
668 struct inode
*inode
= file
->f_path
.dentry
->d_inode
;
669 invalidate_mapping_pages(inode
->i_mapping
, 0, -1);
676 * bitmap_file_kick - if an error occurs while manipulating the bitmap file
677 * then it is no longer reliable, so we stop using it and we mark the file
678 * as failed in the superblock
680 static void bitmap_file_kick(struct bitmap
*bitmap
)
682 char *path
, *ptr
= NULL
;
684 bitmap_mask_state(bitmap
, BITMAP_STALE
, MASK_SET
);
685 bitmap_update_sb(bitmap
);
688 path
= kmalloc(PAGE_SIZE
, GFP_KERNEL
);
690 ptr
= file_path(bitmap
->file
, path
, PAGE_SIZE
);
692 printk(KERN_ALERT
"%s: kicking failed bitmap file %s from array!\n",
693 bmname(bitmap
), ptr
? ptr
: "");
698 bitmap_file_put(bitmap
);
703 enum bitmap_page_attr
{
704 BITMAP_PAGE_DIRTY
= 0, // there are set bits that need to be synced
705 BITMAP_PAGE_CLEAN
= 1, // there are bits that might need to be cleared
706 BITMAP_PAGE_NEEDWRITE
=2, // there are cleared bits that need to be synced
709 static inline void set_page_attr(struct bitmap
*bitmap
, struct page
*page
,
710 enum bitmap_page_attr attr
)
712 __set_bit((page
->index
<<2) + attr
, bitmap
->filemap_attr
);
715 static inline void clear_page_attr(struct bitmap
*bitmap
, struct page
*page
,
716 enum bitmap_page_attr attr
)
718 __clear_bit((page
->index
<<2) + attr
, bitmap
->filemap_attr
);
721 static inline unsigned long test_page_attr(struct bitmap
*bitmap
, struct page
*page
,
722 enum bitmap_page_attr attr
)
724 return test_bit((page
->index
<<2) + attr
, bitmap
->filemap_attr
);
728 * bitmap_file_set_bit -- called before performing a write to the md device
729 * to set (and eventually sync) a particular bit in the bitmap file
731 * we set the bit immediately, then we record the page number so that
732 * when an unplug occurs, we can flush the dirty pages out to disk
734 static void bitmap_file_set_bit(struct bitmap
*bitmap
, sector_t block
)
739 unsigned long chunk
= block
>> CHUNK_BLOCK_SHIFT(bitmap
);
741 if (!bitmap
->filemap
) {
745 page
= filemap_get_page(bitmap
, chunk
);
747 bit
= file_page_offset(chunk
);
750 kaddr
= kmap_atomic(page
, KM_USER0
);
751 if (bitmap
->flags
& BITMAP_HOSTENDIAN
)
754 ext2_set_bit(bit
, kaddr
);
755 kunmap_atomic(kaddr
, KM_USER0
);
756 PRINTK("set file bit %lu page %lu\n", bit
, page
->index
);
758 /* record page number so it gets flushed to disk when unplug occurs */
759 set_page_attr(bitmap
, page
, BITMAP_PAGE_DIRTY
);
763 /* this gets called when the md device is ready to unplug its underlying
764 * (slave) device queues -- before we let any writes go down, we need to
765 * sync the dirty pages of the bitmap file to disk */
766 int bitmap_unplug(struct bitmap
*bitmap
)
768 unsigned long i
, flags
;
769 int dirty
, need_write
;
777 /* look at each page to see if there are any set bits that need to be
778 * flushed out to disk */
779 for (i
= 0; i
< bitmap
->file_pages
; i
++) {
780 spin_lock_irqsave(&bitmap
->lock
, flags
);
781 if (!bitmap
->filemap
) {
782 spin_unlock_irqrestore(&bitmap
->lock
, flags
);
785 page
= bitmap
->filemap
[i
];
786 dirty
= test_page_attr(bitmap
, page
, BITMAP_PAGE_DIRTY
);
787 need_write
= test_page_attr(bitmap
, page
, BITMAP_PAGE_NEEDWRITE
);
788 clear_page_attr(bitmap
, page
, BITMAP_PAGE_DIRTY
);
789 clear_page_attr(bitmap
, page
, BITMAP_PAGE_NEEDWRITE
);
792 spin_unlock_irqrestore(&bitmap
->lock
, flags
);
794 if (dirty
| need_write
)
795 err
= write_page(bitmap
, page
, 0);
797 if (wait
) { /* if any writes were performed, we need to wait on them */
799 wait_event(bitmap
->write_wait
,
800 atomic_read(&bitmap
->pending_writes
)==0);
802 md_super_wait(bitmap
->mddev
);
804 if (bitmap
->flags
& BITMAP_WRITE_ERROR
)
805 bitmap_file_kick(bitmap
);
809 static void bitmap_set_memory_bits(struct bitmap
*bitmap
, sector_t offset
, int needed
);
810 /* * bitmap_init_from_disk -- called at bitmap_create time to initialize
811 * the in-memory bitmap from the on-disk bitmap -- also, sets up the
812 * memory mapping of the bitmap file
814 * if there's no bitmap file, or if the bitmap file had been
815 * previously kicked from the array, we mark all the bits as
816 * 1's in order to cause a full resync.
818 * We ignore all bits for sectors that end earlier than 'start'.
819 * This is used when reading an out-of-date bitmap...
821 static int bitmap_init_from_disk(struct bitmap
*bitmap
, sector_t start
)
823 unsigned long i
, chunks
, index
, oldindex
, bit
;
824 struct page
*page
= NULL
, *oldpage
= NULL
;
825 unsigned long num_pages
, bit_cnt
= 0;
827 unsigned long bytes
, offset
;
832 chunks
= bitmap
->chunks
;
835 BUG_ON(!file
&& !bitmap
->offset
);
837 #ifdef INJECT_FAULTS_3
840 outofdate
= bitmap
->flags
& BITMAP_STALE
;
843 printk(KERN_INFO
"%s: bitmap file is out of date, doing full "
844 "recovery\n", bmname(bitmap
));
846 bytes
= (chunks
+ 7) / 8;
848 num_pages
= (bytes
+ sizeof(bitmap_super_t
) + PAGE_SIZE
- 1) / PAGE_SIZE
;
850 if (file
&& i_size_read(file
->f_mapping
->host
) < bytes
+ sizeof(bitmap_super_t
)) {
851 printk(KERN_INFO
"%s: bitmap file too short %lu < %lu\n",
853 (unsigned long) i_size_read(file
->f_mapping
->host
),
854 bytes
+ sizeof(bitmap_super_t
));
860 bitmap
->filemap
= kmalloc(sizeof(struct page
*) * num_pages
, GFP_KERNEL
);
861 if (!bitmap
->filemap
)
864 /* We need 4 bits per page, rounded up to a multiple of sizeof(unsigned long) */
865 bitmap
->filemap_attr
= kzalloc(
866 roundup( DIV_ROUND_UP(num_pages
*4, 8), sizeof(unsigned long)),
868 if (!bitmap
->filemap_attr
)
873 for (i
= 0; i
< chunks
; i
++) {
875 index
= file_page_index(i
);
876 bit
= file_page_offset(i
);
877 if (index
!= oldindex
) { /* this is a new page, read it in */
879 /* unmap the old page, we're done with it */
880 if (index
== num_pages
-1)
881 count
= bytes
+ sizeof(bitmap_super_t
)
887 * if we're here then the superblock page
888 * contains some bits (PAGE_SIZE != sizeof sb)
889 * we've already read it in, so just use it
891 page
= bitmap
->sb_page
;
892 offset
= sizeof(bitmap_super_t
);
894 page
= read_page(file
, index
, bitmap
, count
);
897 page
= read_sb_page(bitmap
->mddev
, bitmap
->offset
, index
);
900 if (IS_ERR(page
)) { /* read error */
910 * if bitmap is out of date, dirty the
911 * whole page and write it out
913 paddr
= kmap_atomic(page
, KM_USER0
);
914 memset(paddr
+ offset
, 0xff,
916 kunmap_atomic(paddr
, KM_USER0
);
917 ret
= write_page(bitmap
, page
, 1);
919 /* release, page not in filemap yet */
925 bitmap
->filemap
[bitmap
->file_pages
++] = page
;
927 paddr
= kmap_atomic(page
, KM_USER0
);
928 if (bitmap
->flags
& BITMAP_HOSTENDIAN
)
929 b
= test_bit(bit
, paddr
);
931 b
= ext2_test_bit(bit
, paddr
);
932 kunmap_atomic(paddr
, KM_USER0
);
934 /* if the disk bit is set, set the memory bit */
935 bitmap_set_memory_bits(bitmap
, i
<< CHUNK_BLOCK_SHIFT(bitmap
),
936 ((i
+1) << (CHUNK_BLOCK_SHIFT(bitmap
)) >= start
)
939 set_page_attr(bitmap
, page
, BITMAP_PAGE_CLEAN
);
943 /* everything went OK */
945 bitmap_mask_state(bitmap
, BITMAP_STALE
, MASK_UNSET
);
947 if (bit_cnt
) { /* Kick recovery if any bits were set */
948 set_bit(MD_RECOVERY_NEEDED
, &bitmap
->mddev
->recovery
);
949 md_wakeup_thread(bitmap
->mddev
->thread
);
953 printk(KERN_INFO
"%s: bitmap initialized from disk: "
954 "read %lu/%lu pages, set %lu bits, status: %d\n",
955 bmname(bitmap
), bitmap
->file_pages
, num_pages
, bit_cnt
, ret
);
960 void bitmap_write_all(struct bitmap
*bitmap
)
962 /* We don't actually write all bitmap blocks here,
963 * just flag them as needing to be written
967 for (i
=0; i
< bitmap
->file_pages
; i
++)
968 set_page_attr(bitmap
, bitmap
->filemap
[i
],
969 BITMAP_PAGE_NEEDWRITE
);
973 static void bitmap_count_page(struct bitmap
*bitmap
, sector_t offset
, int inc
)
975 sector_t chunk
= offset
>> CHUNK_BLOCK_SHIFT(bitmap
);
976 unsigned long page
= chunk
>> PAGE_COUNTER_SHIFT
;
977 bitmap
->bp
[page
].count
+= inc
;
979 if (page == 0) printk("count page 0, offset %llu: %d gives %d\n",
980 (unsigned long long)offset, inc, bitmap->bp[page].count);
982 bitmap_checkfree(bitmap
, page
);
984 static bitmap_counter_t
*bitmap_get_counter(struct bitmap
*bitmap
,
985 sector_t offset
, int *blocks
,
989 * bitmap daemon -- periodically wakes up to clean bits and flush pages
993 int bitmap_daemon_work(struct bitmap
*bitmap
)
997 struct page
*page
= NULL
, *lastpage
= NULL
;
1004 if (time_before(jiffies
, bitmap
->daemon_lastrun
+ bitmap
->daemon_sleep
*HZ
))
1006 bitmap
->daemon_lastrun
= jiffies
;
1008 for (j
= 0; j
< bitmap
->chunks
; j
++) {
1009 bitmap_counter_t
*bmc
;
1010 spin_lock_irqsave(&bitmap
->lock
, flags
);
1011 if (!bitmap
->filemap
) {
1012 /* error or shutdown */
1013 spin_unlock_irqrestore(&bitmap
->lock
, flags
);
1017 page
= filemap_get_page(bitmap
, j
);
1019 if (page
!= lastpage
) {
1020 /* skip this page unless it's marked as needing cleaning */
1021 if (!test_page_attr(bitmap
, page
, BITMAP_PAGE_CLEAN
)) {
1022 int need_write
= test_page_attr(bitmap
, page
,
1023 BITMAP_PAGE_NEEDWRITE
);
1025 clear_page_attr(bitmap
, page
, BITMAP_PAGE_NEEDWRITE
);
1027 spin_unlock_irqrestore(&bitmap
->lock
, flags
);
1029 switch (write_page(bitmap
, page
, 0)) {
1033 bitmap_file_kick(bitmap
);
1039 /* grab the new page, sync and release the old */
1040 if (lastpage
!= NULL
) {
1041 if (test_page_attr(bitmap
, lastpage
, BITMAP_PAGE_NEEDWRITE
)) {
1042 clear_page_attr(bitmap
, lastpage
, BITMAP_PAGE_NEEDWRITE
);
1043 spin_unlock_irqrestore(&bitmap
->lock
, flags
);
1044 err
= write_page(bitmap
, lastpage
, 0);
1046 set_page_attr(bitmap
, lastpage
, BITMAP_PAGE_NEEDWRITE
);
1047 spin_unlock_irqrestore(&bitmap
->lock
, flags
);
1050 bitmap_file_kick(bitmap
);
1052 spin_unlock_irqrestore(&bitmap
->lock
, flags
);
1055 printk("bitmap clean at page %lu\n", j);
1057 spin_lock_irqsave(&bitmap
->lock
, flags
);
1058 clear_page_attr(bitmap
, page
, BITMAP_PAGE_CLEAN
);
1060 bmc
= bitmap_get_counter(bitmap
, j
<< CHUNK_BLOCK_SHIFT(bitmap
),
1064 if (j < 100) printk("bitmap: j=%lu, *bmc = 0x%x\n", j, *bmc);
1067 *bmc
=1; /* maybe clear the bit next time */
1068 set_page_attr(bitmap
, page
, BITMAP_PAGE_CLEAN
);
1069 } else if (*bmc
== 1) {
1070 /* we can clear the bit */
1072 bitmap_count_page(bitmap
, j
<< CHUNK_BLOCK_SHIFT(bitmap
),
1076 paddr
= kmap_atomic(page
, KM_USER0
);
1077 if (bitmap
->flags
& BITMAP_HOSTENDIAN
)
1078 clear_bit(file_page_offset(j
), paddr
);
1080 ext2_clear_bit(file_page_offset(j
), paddr
);
1081 kunmap_atomic(paddr
, KM_USER0
);
1084 spin_unlock_irqrestore(&bitmap
->lock
, flags
);
1087 /* now sync the final page */
1088 if (lastpage
!= NULL
) {
1089 spin_lock_irqsave(&bitmap
->lock
, flags
);
1090 if (test_page_attr(bitmap
, lastpage
, BITMAP_PAGE_NEEDWRITE
)) {
1091 clear_page_attr(bitmap
, lastpage
, BITMAP_PAGE_NEEDWRITE
);
1092 spin_unlock_irqrestore(&bitmap
->lock
, flags
);
1093 err
= write_page(bitmap
, lastpage
, 0);
1095 set_page_attr(bitmap
, lastpage
, BITMAP_PAGE_NEEDWRITE
);
1096 spin_unlock_irqrestore(&bitmap
->lock
, flags
);
1103 static bitmap_counter_t
*bitmap_get_counter(struct bitmap
*bitmap
,
1104 sector_t offset
, int *blocks
,
1107 /* If 'create', we might release the lock and reclaim it.
1108 * The lock must have been taken with interrupts enabled.
1109 * If !create, we don't release the lock.
1111 sector_t chunk
= offset
>> CHUNK_BLOCK_SHIFT(bitmap
);
1112 unsigned long page
= chunk
>> PAGE_COUNTER_SHIFT
;
1113 unsigned long pageoff
= (chunk
& PAGE_COUNTER_MASK
) << COUNTER_BYTE_SHIFT
;
1116 if (bitmap_checkpage(bitmap
, page
, create
) < 0) {
1117 csize
= ((sector_t
)1) << (CHUNK_BLOCK_SHIFT(bitmap
));
1118 *blocks
= csize
- (offset
& (csize
- 1));
1121 /* now locked ... */
1123 if (bitmap
->bp
[page
].hijacked
) { /* hijacked pointer */
1124 /* should we use the first or second counter field
1125 * of the hijacked pointer? */
1126 int hi
= (pageoff
> PAGE_COUNTER_MASK
);
1127 csize
= ((sector_t
)1) << (CHUNK_BLOCK_SHIFT(bitmap
) +
1128 PAGE_COUNTER_SHIFT
- 1);
1129 *blocks
= csize
- (offset
& (csize
- 1));
1130 return &((bitmap_counter_t
*)
1131 &bitmap
->bp
[page
].map
)[hi
];
1132 } else { /* page is allocated */
1133 csize
= ((sector_t
)1) << (CHUNK_BLOCK_SHIFT(bitmap
));
1134 *blocks
= csize
- (offset
& (csize
- 1));
1135 return (bitmap_counter_t
*)
1136 &(bitmap
->bp
[page
].map
[pageoff
]);
1140 int bitmap_startwrite(struct bitmap
*bitmap
, sector_t offset
, unsigned long sectors
, int behind
)
1142 if (!bitmap
) return 0;
1145 atomic_inc(&bitmap
->behind_writes
);
1146 PRINTK(KERN_DEBUG
"inc write-behind count %d/%d\n",
1147 atomic_read(&bitmap
->behind_writes
), bitmap
->max_write_behind
);
1152 bitmap_counter_t
*bmc
;
1154 spin_lock_irq(&bitmap
->lock
);
1155 bmc
= bitmap_get_counter(bitmap
, offset
, &blocks
, 1);
1157 spin_unlock_irq(&bitmap
->lock
);
1161 if (unlikely((*bmc
& COUNTER_MAX
) == COUNTER_MAX
)) {
1162 DEFINE_WAIT(__wait
);
1163 /* note that it is safe to do the prepare_to_wait
1164 * after the test as long as we do it before dropping
1167 prepare_to_wait(&bitmap
->overflow_wait
, &__wait
,
1168 TASK_UNINTERRUPTIBLE
);
1169 spin_unlock_irq(&bitmap
->lock
);
1170 bitmap
->mddev
->queue
1171 ->unplug_fn(bitmap
->mddev
->queue
);
1173 finish_wait(&bitmap
->overflow_wait
, &__wait
);
1179 bitmap_file_set_bit(bitmap
, offset
);
1180 bitmap_count_page(bitmap
,offset
, 1);
1181 blk_plug_device(bitmap
->mddev
->queue
);
1189 spin_unlock_irq(&bitmap
->lock
);
1192 if (sectors
> blocks
)
1199 void bitmap_endwrite(struct bitmap
*bitmap
, sector_t offset
, unsigned long sectors
,
1200 int success
, int behind
)
1202 if (!bitmap
) return;
1204 atomic_dec(&bitmap
->behind_writes
);
1205 PRINTK(KERN_DEBUG
"dec write-behind count %d/%d\n",
1206 atomic_read(&bitmap
->behind_writes
), bitmap
->max_write_behind
);
1211 unsigned long flags
;
1212 bitmap_counter_t
*bmc
;
1214 spin_lock_irqsave(&bitmap
->lock
, flags
);
1215 bmc
= bitmap_get_counter(bitmap
, offset
, &blocks
, 0);
1217 spin_unlock_irqrestore(&bitmap
->lock
, flags
);
1221 if (!success
&& ! (*bmc
& NEEDED_MASK
))
1222 *bmc
|= NEEDED_MASK
;
1224 if ((*bmc
& COUNTER_MAX
) == COUNTER_MAX
)
1225 wake_up(&bitmap
->overflow_wait
);
1229 set_page_attr(bitmap
,
1230 filemap_get_page(bitmap
, offset
>> CHUNK_BLOCK_SHIFT(bitmap
)),
1233 spin_unlock_irqrestore(&bitmap
->lock
, flags
);
1235 if (sectors
> blocks
)
1241 int bitmap_start_sync(struct bitmap
*bitmap
, sector_t offset
, int *blocks
,
1244 bitmap_counter_t
*bmc
;
1246 if (bitmap
== NULL
) {/* FIXME or bitmap set as 'failed' */
1248 return 1; /* always resync if no bitmap */
1250 spin_lock_irq(&bitmap
->lock
);
1251 bmc
= bitmap_get_counter(bitmap
, offset
, blocks
, 0);
1257 else if (NEEDED(*bmc
)) {
1259 if (!degraded
) { /* don't set/clear bits if degraded */
1260 *bmc
|= RESYNC_MASK
;
1261 *bmc
&= ~NEEDED_MASK
;
1265 spin_unlock_irq(&bitmap
->lock
);
1269 void bitmap_end_sync(struct bitmap
*bitmap
, sector_t offset
, int *blocks
, int aborted
)
1271 bitmap_counter_t
*bmc
;
1272 unsigned long flags
;
1274 if (offset == 0) printk("bitmap_end_sync 0 (%d)\n", aborted);
1275 */ if (bitmap
== NULL
) {
1279 spin_lock_irqsave(&bitmap
->lock
, flags
);
1280 bmc
= bitmap_get_counter(bitmap
, offset
, blocks
, 0);
1285 if (offset == 0) printk("bitmap_end sync found 0x%x, blocks %d\n", *bmc, *blocks);
1288 *bmc
&= ~RESYNC_MASK
;
1290 if (!NEEDED(*bmc
) && aborted
)
1291 *bmc
|= NEEDED_MASK
;
1294 set_page_attr(bitmap
,
1295 filemap_get_page(bitmap
, offset
>> CHUNK_BLOCK_SHIFT(bitmap
)),
1301 spin_unlock_irqrestore(&bitmap
->lock
, flags
);
1304 void bitmap_close_sync(struct bitmap
*bitmap
)
1306 /* Sync has finished, and any bitmap chunks that weren't synced
1307 * properly have been aborted. It remains to us to clear the
1308 * RESYNC bit wherever it is still on
1310 sector_t sector
= 0;
1312 if (!bitmap
) return;
1313 while (sector
< bitmap
->mddev
->resync_max_sectors
) {
1314 bitmap_end_sync(bitmap
, sector
, &blocks
, 0);
1316 if (sector < 500) printk("bitmap_close_sync: sec %llu blks %d\n",
1317 (unsigned long long)sector, blocks);
1318 */ sector
+= blocks
;
1322 static void bitmap_set_memory_bits(struct bitmap
*bitmap
, sector_t offset
, int needed
)
1324 /* For each chunk covered by any of these sectors, set the
1325 * counter to 1 and set resync_needed. They should all
1326 * be 0 at this point
1330 bitmap_counter_t
*bmc
;
1331 spin_lock_irq(&bitmap
->lock
);
1332 bmc
= bitmap_get_counter(bitmap
, offset
, &secs
, 1);
1334 spin_unlock_irq(&bitmap
->lock
);
1339 *bmc
= 1 | (needed
?NEEDED_MASK
:0);
1340 bitmap_count_page(bitmap
, offset
, 1);
1341 page
= filemap_get_page(bitmap
, offset
>> CHUNK_BLOCK_SHIFT(bitmap
));
1342 set_page_attr(bitmap
, page
, BITMAP_PAGE_CLEAN
);
1344 spin_unlock_irq(&bitmap
->lock
);
1348 /* dirty the memory and file bits for bitmap chunks "s" to "e" */
1349 void bitmap_dirty_bits(struct bitmap
*bitmap
, unsigned long s
, unsigned long e
)
1351 unsigned long chunk
;
1353 for (chunk
= s
; chunk
<= e
; chunk
++) {
1354 sector_t sec
= chunk
<< CHUNK_BLOCK_SHIFT(bitmap
);
1355 bitmap_set_memory_bits(bitmap
, sec
, 1);
1356 bitmap_file_set_bit(bitmap
, sec
);
1361 * flush out any pending updates
1363 void bitmap_flush(mddev_t
*mddev
)
1365 struct bitmap
*bitmap
= mddev
->bitmap
;
1368 if (!bitmap
) /* there was no bitmap */
1371 /* run the daemon_work three time to ensure everything is flushed
1374 sleep
= bitmap
->daemon_sleep
;
1375 bitmap
->daemon_sleep
= 0;
1376 bitmap_daemon_work(bitmap
);
1377 bitmap_daemon_work(bitmap
);
1378 bitmap_daemon_work(bitmap
);
1379 bitmap
->daemon_sleep
= sleep
;
1380 bitmap_update_sb(bitmap
);
1384 * free memory that was allocated
1386 static void bitmap_free(struct bitmap
*bitmap
)
1388 unsigned long k
, pages
;
1389 struct bitmap_page
*bp
;
1391 if (!bitmap
) /* there was no bitmap */
1394 /* release the bitmap file and kill the daemon */
1395 bitmap_file_put(bitmap
);
1398 pages
= bitmap
->pages
;
1400 /* free all allocated memory */
1402 if (bp
) /* deallocate the page memory */
1403 for (k
= 0; k
< pages
; k
++)
1404 if (bp
[k
].map
&& !bp
[k
].hijacked
)
1409 void bitmap_destroy(mddev_t
*mddev
)
1411 struct bitmap
*bitmap
= mddev
->bitmap
;
1413 if (!bitmap
) /* there was no bitmap */
1416 mddev
->bitmap
= NULL
; /* disconnect from the md device */
1418 mddev
->thread
->timeout
= MAX_SCHEDULE_TIMEOUT
;
1420 bitmap_free(bitmap
);
1424 * initialize the bitmap structure
1425 * if this returns an error, bitmap_destroy must be called to do clean up
1427 int bitmap_create(mddev_t
*mddev
)
1429 struct bitmap
*bitmap
;
1430 unsigned long blocks
= mddev
->resync_max_sectors
;
1431 unsigned long chunks
;
1432 unsigned long pages
;
1433 struct file
*file
= mddev
->bitmap_file
;
1437 BUILD_BUG_ON(sizeof(bitmap_super_t
) != 256);
1439 if (!file
&& !mddev
->bitmap_offset
) /* bitmap disabled, nothing to do */
1442 BUG_ON(file
&& mddev
->bitmap_offset
);
1444 bitmap
= kzalloc(sizeof(*bitmap
), GFP_KERNEL
);
1448 spin_lock_init(&bitmap
->lock
);
1449 atomic_set(&bitmap
->pending_writes
, 0);
1450 init_waitqueue_head(&bitmap
->write_wait
);
1451 init_waitqueue_head(&bitmap
->overflow_wait
);
1453 bitmap
->mddev
= mddev
;
1455 bitmap
->file
= file
;
1456 bitmap
->offset
= mddev
->bitmap_offset
;
1459 do_sync_file_range(file
, 0, LLONG_MAX
,
1460 SYNC_FILE_RANGE_WAIT_BEFORE
|
1461 SYNC_FILE_RANGE_WRITE
|
1462 SYNC_FILE_RANGE_WAIT_AFTER
);
1464 /* read superblock from bitmap file (this sets bitmap->chunksize) */
1465 err
= bitmap_read_sb(bitmap
);
1469 bitmap
->chunkshift
= ffz(~bitmap
->chunksize
);
1471 /* now that chunksize and chunkshift are set, we can use these macros */
1472 chunks
= (blocks
+ CHUNK_BLOCK_RATIO(bitmap
) - 1) /
1473 CHUNK_BLOCK_RATIO(bitmap
);
1474 pages
= (chunks
+ PAGE_COUNTER_RATIO
- 1) / PAGE_COUNTER_RATIO
;
1478 bitmap
->chunks
= chunks
;
1479 bitmap
->pages
= pages
;
1480 bitmap
->missing_pages
= pages
;
1481 bitmap
->counter_bits
= COUNTER_BITS
;
1483 bitmap
->syncchunk
= ~0UL;
1485 #ifdef INJECT_FATAL_FAULT_1
1488 bitmap
->bp
= kzalloc(pages
* sizeof(*bitmap
->bp
), GFP_KERNEL
);
1494 /* now that we have some pages available, initialize the in-memory
1495 * bitmap from the on-disk bitmap */
1497 if (mddev
->degraded
== 0
1498 || bitmap
->events_cleared
== mddev
->events
)
1499 /* no need to keep dirty bits to optimise a re-add of a missing device */
1500 start
= mddev
->recovery_cp
;
1501 err
= bitmap_init_from_disk(bitmap
, start
);
1506 printk(KERN_INFO
"created bitmap (%lu pages) for device %s\n",
1507 pages
, bmname(bitmap
));
1509 mddev
->bitmap
= bitmap
;
1511 mddev
->thread
->timeout
= bitmap
->daemon_sleep
* HZ
;
1513 return bitmap_update_sb(bitmap
);
1516 bitmap_free(bitmap
);
1520 /* the bitmap API -- for raid personalities */
1521 EXPORT_SYMBOL(bitmap_startwrite
);
1522 EXPORT_SYMBOL(bitmap_endwrite
);
1523 EXPORT_SYMBOL(bitmap_start_sync
);
1524 EXPORT_SYMBOL(bitmap_end_sync
);
1525 EXPORT_SYMBOL(bitmap_unplug
);
1526 EXPORT_SYMBOL(bitmap_close_sync
);