2 * Copyright (C) 2003 Sistina Software Limited.
4 * This file is released under the GPL.
8 #include "dm-bio-list.h"
13 #include <linux/ctype.h>
14 #include <linux/init.h>
15 #include <linux/mempool.h>
16 #include <linux/module.h>
17 #include <linux/pagemap.h>
18 #include <linux/slab.h>
19 #include <linux/time.h>
20 #include <linux/vmalloc.h>
21 #include <linux/workqueue.h>
23 #define DM_MSG_PREFIX "raid1"
24 #define DM_IO_PAGES 64
26 #define DM_RAID1_HANDLE_ERRORS 0x01
28 static DECLARE_WAIT_QUEUE_HEAD(_kmirrord_recovery_stopped
);
30 /*-----------------------------------------------------------------
33 * The mirror splits itself up into discrete regions. Each
34 * region can be in one of three states: clean, dirty,
35 * nosync. There is no need to put clean regions in the hash.
37 * In addition to being present in the hash table a region _may_
38 * be present on one of three lists.
40 * clean_regions: Regions on this list have no io pending to
41 * them, they are in sync, we are no longer interested in them,
42 * they are dull. rh_update_states() will remove them from the
45 * quiesced_regions: These regions have been spun down, ready
46 * for recovery. rh_recovery_start() will remove regions from
47 * this list and hand them to kmirrord, which will schedule the
48 * recovery io with kcopyd.
50 * recovered_regions: Regions that kcopyd has successfully
51 * recovered. rh_update_states() will now schedule any delayed
52 * io, up the recovery_count, and remove the region from the
56 * A rw spin lock 'hash_lock' protects just the hash table,
57 * this is never held in write mode from interrupt context,
58 * which I believe means that we only have to disable irqs when
61 * An ordinary spin lock 'region_lock' that protects the three
62 * lists in the region_hash, with the 'state', 'list' and
63 * 'bhs_delayed' fields of the regions. This is used from irq
64 * context, so all other uses will have to suspend local irqs.
65 *---------------------------------------------------------------*/
68 struct mirror_set
*ms
;
70 unsigned region_shift
;
72 /* holds persistent region state */
73 struct dirty_log
*log
;
77 mempool_t
*region_pool
;
79 unsigned int nr_buckets
;
80 struct list_head
*buckets
;
82 spinlock_t region_lock
;
83 atomic_t recovery_in_flight
;
84 struct semaphore recovery_count
;
85 struct list_head clean_regions
;
86 struct list_head quiesced_regions
;
87 struct list_head recovered_regions
;
98 struct region_hash
*rh
; /* FIXME: can we get rid of this ? */
102 struct list_head hash_list
;
103 struct list_head list
;
106 struct bio_list delayed_bios
;
110 /*-----------------------------------------------------------------
111 * Mirror set structures.
112 *---------------------------------------------------------------*/
114 atomic_t error_count
;
120 struct dm_target
*ti
;
121 struct list_head list
;
122 struct region_hash rh
;
123 struct kcopyd_client
*kcopyd_client
;
126 spinlock_t lock
; /* protects the next two lists */
127 struct bio_list reads
;
128 struct bio_list writes
;
130 struct dm_io_client
*io_client
;
136 struct mirror
*default_mirror
; /* Default mirror */
138 struct workqueue_struct
*kmirrord_wq
;
139 struct work_struct kmirrord_work
;
141 unsigned int nr_mirrors
;
142 struct mirror mirror
[0];
148 static inline region_t
bio_to_region(struct region_hash
*rh
, struct bio
*bio
)
150 return (bio
->bi_sector
- rh
->ms
->ti
->begin
) >> rh
->region_shift
;
153 static inline sector_t
region_to_sector(struct region_hash
*rh
, region_t region
)
155 return region
<< rh
->region_shift
;
158 static void wake(struct mirror_set
*ms
)
160 queue_work(ms
->kmirrord_wq
, &ms
->kmirrord_work
);
163 /* FIXME move this */
164 static void queue_bio(struct mirror_set
*ms
, struct bio
*bio
, int rw
);
166 #define MIN_REGIONS 64
167 #define MAX_RECOVERY 1
168 static int rh_init(struct region_hash
*rh
, struct mirror_set
*ms
,
169 struct dirty_log
*log
, uint32_t region_size
,
172 unsigned int nr_buckets
, max_buckets
;
176 * Calculate a suitable number of buckets for our hash
179 max_buckets
= nr_regions
>> 6;
180 for (nr_buckets
= 128u; nr_buckets
< max_buckets
; nr_buckets
<<= 1)
186 rh
->region_size
= region_size
;
187 rh
->region_shift
= ffs(region_size
) - 1;
188 rwlock_init(&rh
->hash_lock
);
189 rh
->mask
= nr_buckets
- 1;
190 rh
->nr_buckets
= nr_buckets
;
192 rh
->buckets
= vmalloc(nr_buckets
* sizeof(*rh
->buckets
));
194 DMERR("unable to allocate region hash memory");
198 for (i
= 0; i
< nr_buckets
; i
++)
199 INIT_LIST_HEAD(rh
->buckets
+ i
);
201 spin_lock_init(&rh
->region_lock
);
202 sema_init(&rh
->recovery_count
, 0);
203 atomic_set(&rh
->recovery_in_flight
, 0);
204 INIT_LIST_HEAD(&rh
->clean_regions
);
205 INIT_LIST_HEAD(&rh
->quiesced_regions
);
206 INIT_LIST_HEAD(&rh
->recovered_regions
);
208 rh
->region_pool
= mempool_create_kmalloc_pool(MIN_REGIONS
,
209 sizeof(struct region
));
210 if (!rh
->region_pool
) {
219 static void rh_exit(struct region_hash
*rh
)
222 struct region
*reg
, *nreg
;
224 BUG_ON(!list_empty(&rh
->quiesced_regions
));
225 for (h
= 0; h
< rh
->nr_buckets
; h
++) {
226 list_for_each_entry_safe(reg
, nreg
, rh
->buckets
+ h
, hash_list
) {
227 BUG_ON(atomic_read(®
->pending
));
228 mempool_free(reg
, rh
->region_pool
);
233 dm_destroy_dirty_log(rh
->log
);
235 mempool_destroy(rh
->region_pool
);
239 #define RH_HASH_MULT 2654435387U
241 static inline unsigned int rh_hash(struct region_hash
*rh
, region_t region
)
243 return (unsigned int) ((region
* RH_HASH_MULT
) >> 12) & rh
->mask
;
246 static struct region
*__rh_lookup(struct region_hash
*rh
, region_t region
)
250 list_for_each_entry (reg
, rh
->buckets
+ rh_hash(rh
, region
), hash_list
)
251 if (reg
->key
== region
)
257 static void __rh_insert(struct region_hash
*rh
, struct region
*reg
)
259 unsigned int h
= rh_hash(rh
, reg
->key
);
260 list_add(®
->hash_list
, rh
->buckets
+ h
);
263 static struct region
*__rh_alloc(struct region_hash
*rh
, region_t region
)
265 struct region
*reg
, *nreg
;
267 read_unlock(&rh
->hash_lock
);
268 nreg
= mempool_alloc(rh
->region_pool
, GFP_ATOMIC
);
270 nreg
= kmalloc(sizeof(struct region
), GFP_NOIO
);
271 nreg
->state
= rh
->log
->type
->in_sync(rh
->log
, region
, 1) ?
272 RH_CLEAN
: RH_NOSYNC
;
276 INIT_LIST_HEAD(&nreg
->list
);
278 atomic_set(&nreg
->pending
, 0);
279 bio_list_init(&nreg
->delayed_bios
);
280 write_lock_irq(&rh
->hash_lock
);
282 reg
= __rh_lookup(rh
, region
);
284 /* we lost the race */
285 mempool_free(nreg
, rh
->region_pool
);
288 __rh_insert(rh
, nreg
);
289 if (nreg
->state
== RH_CLEAN
) {
290 spin_lock(&rh
->region_lock
);
291 list_add(&nreg
->list
, &rh
->clean_regions
);
292 spin_unlock(&rh
->region_lock
);
296 write_unlock_irq(&rh
->hash_lock
);
297 read_lock(&rh
->hash_lock
);
302 static inline struct region
*__rh_find(struct region_hash
*rh
, region_t region
)
306 reg
= __rh_lookup(rh
, region
);
308 reg
= __rh_alloc(rh
, region
);
313 static int rh_state(struct region_hash
*rh
, region_t region
, int may_block
)
318 read_lock(&rh
->hash_lock
);
319 reg
= __rh_lookup(rh
, region
);
320 read_unlock(&rh
->hash_lock
);
326 * The region wasn't in the hash, so we fall back to the
329 r
= rh
->log
->type
->in_sync(rh
->log
, region
, may_block
);
332 * Any error from the dirty log (eg. -EWOULDBLOCK) gets
333 * taken as a RH_NOSYNC
335 return r
== 1 ? RH_CLEAN
: RH_NOSYNC
;
338 static inline int rh_in_sync(struct region_hash
*rh
,
339 region_t region
, int may_block
)
341 int state
= rh_state(rh
, region
, may_block
);
342 return state
== RH_CLEAN
|| state
== RH_DIRTY
;
345 static void dispatch_bios(struct mirror_set
*ms
, struct bio_list
*bio_list
)
349 while ((bio
= bio_list_pop(bio_list
))) {
350 queue_bio(ms
, bio
, WRITE
);
354 static void complete_resync_work(struct region
*reg
, int success
)
356 struct region_hash
*rh
= reg
->rh
;
358 rh
->log
->type
->set_region_sync(rh
->log
, reg
->key
, success
);
359 dispatch_bios(rh
->ms
, ®
->delayed_bios
);
360 if (atomic_dec_and_test(&rh
->recovery_in_flight
))
361 wake_up_all(&_kmirrord_recovery_stopped
);
362 up(&rh
->recovery_count
);
365 static void rh_update_states(struct region_hash
*rh
)
367 struct region
*reg
, *next
;
370 LIST_HEAD(recovered
);
373 * Quickly grab the lists.
375 write_lock_irq(&rh
->hash_lock
);
376 spin_lock(&rh
->region_lock
);
377 if (!list_empty(&rh
->clean_regions
)) {
378 list_splice(&rh
->clean_regions
, &clean
);
379 INIT_LIST_HEAD(&rh
->clean_regions
);
381 list_for_each_entry (reg
, &clean
, list
) {
382 rh
->log
->type
->clear_region(rh
->log
, reg
->key
);
383 list_del(®
->hash_list
);
387 if (!list_empty(&rh
->recovered_regions
)) {
388 list_splice(&rh
->recovered_regions
, &recovered
);
389 INIT_LIST_HEAD(&rh
->recovered_regions
);
391 list_for_each_entry (reg
, &recovered
, list
)
392 list_del(®
->hash_list
);
394 spin_unlock(&rh
->region_lock
);
395 write_unlock_irq(&rh
->hash_lock
);
398 * All the regions on the recovered and clean lists have
399 * now been pulled out of the system, so no need to do
402 list_for_each_entry_safe (reg
, next
, &recovered
, list
) {
403 rh
->log
->type
->clear_region(rh
->log
, reg
->key
);
404 complete_resync_work(reg
, 1);
405 mempool_free(reg
, rh
->region_pool
);
408 rh
->log
->type
->flush(rh
->log
);
410 list_for_each_entry_safe (reg
, next
, &clean
, list
)
411 mempool_free(reg
, rh
->region_pool
);
414 static void rh_inc(struct region_hash
*rh
, region_t region
)
418 read_lock(&rh
->hash_lock
);
419 reg
= __rh_find(rh
, region
);
421 spin_lock_irq(&rh
->region_lock
);
422 atomic_inc(®
->pending
);
424 if (reg
->state
== RH_CLEAN
) {
425 reg
->state
= RH_DIRTY
;
426 list_del_init(®
->list
); /* take off the clean list */
427 spin_unlock_irq(&rh
->region_lock
);
429 rh
->log
->type
->mark_region(rh
->log
, reg
->key
);
431 spin_unlock_irq(&rh
->region_lock
);
434 read_unlock(&rh
->hash_lock
);
437 static void rh_inc_pending(struct region_hash
*rh
, struct bio_list
*bios
)
441 for (bio
= bios
->head
; bio
; bio
= bio
->bi_next
)
442 rh_inc(rh
, bio_to_region(rh
, bio
));
445 static void rh_dec(struct region_hash
*rh
, region_t region
)
451 read_lock(&rh
->hash_lock
);
452 reg
= __rh_lookup(rh
, region
);
453 read_unlock(&rh
->hash_lock
);
455 spin_lock_irqsave(&rh
->region_lock
, flags
);
456 if (atomic_dec_and_test(®
->pending
)) {
458 * There is no pending I/O for this region.
459 * We can move the region to corresponding list for next action.
460 * At this point, the region is not yet connected to any list.
462 * If the state is RH_NOSYNC, the region should be kept off
464 * The hash entry for RH_NOSYNC will remain in memory
465 * until the region is recovered or the map is reloaded.
468 /* do nothing for RH_NOSYNC */
469 if (reg
->state
== RH_RECOVERING
) {
470 list_add_tail(®
->list
, &rh
->quiesced_regions
);
471 } else if (reg
->state
== RH_DIRTY
) {
472 reg
->state
= RH_CLEAN
;
473 list_add(®
->list
, &rh
->clean_regions
);
477 spin_unlock_irqrestore(&rh
->region_lock
, flags
);
484 * Starts quiescing a region in preparation for recovery.
486 static int __rh_recovery_prepare(struct region_hash
*rh
)
493 * Ask the dirty log what's next.
495 r
= rh
->log
->type
->get_resync_work(rh
->log
, ®ion
);
500 * Get this region, and start it quiescing by setting the
503 read_lock(&rh
->hash_lock
);
504 reg
= __rh_find(rh
, region
);
505 read_unlock(&rh
->hash_lock
);
507 spin_lock_irq(&rh
->region_lock
);
508 reg
->state
= RH_RECOVERING
;
510 /* Already quiesced ? */
511 if (atomic_read(®
->pending
))
512 list_del_init(®
->list
);
514 list_move(®
->list
, &rh
->quiesced_regions
);
516 spin_unlock_irq(&rh
->region_lock
);
521 static void rh_recovery_prepare(struct region_hash
*rh
)
523 /* Extra reference to avoid race with rh_stop_recovery */
524 atomic_inc(&rh
->recovery_in_flight
);
526 while (!down_trylock(&rh
->recovery_count
)) {
527 atomic_inc(&rh
->recovery_in_flight
);
528 if (__rh_recovery_prepare(rh
) <= 0) {
529 atomic_dec(&rh
->recovery_in_flight
);
530 up(&rh
->recovery_count
);
535 /* Drop the extra reference */
536 if (atomic_dec_and_test(&rh
->recovery_in_flight
))
537 wake_up_all(&_kmirrord_recovery_stopped
);
541 * Returns any quiesced regions.
543 static struct region
*rh_recovery_start(struct region_hash
*rh
)
545 struct region
*reg
= NULL
;
547 spin_lock_irq(&rh
->region_lock
);
548 if (!list_empty(&rh
->quiesced_regions
)) {
549 reg
= list_entry(rh
->quiesced_regions
.next
,
550 struct region
, list
);
551 list_del_init(®
->list
); /* remove from the quiesced list */
553 spin_unlock_irq(&rh
->region_lock
);
558 /* FIXME: success ignored for now */
559 static void rh_recovery_end(struct region
*reg
, int success
)
561 struct region_hash
*rh
= reg
->rh
;
563 spin_lock_irq(&rh
->region_lock
);
564 list_add(®
->list
, ®
->rh
->recovered_regions
);
565 spin_unlock_irq(&rh
->region_lock
);
570 static void rh_flush(struct region_hash
*rh
)
572 rh
->log
->type
->flush(rh
->log
);
575 static void rh_delay(struct region_hash
*rh
, struct bio
*bio
)
579 read_lock(&rh
->hash_lock
);
580 reg
= __rh_find(rh
, bio_to_region(rh
, bio
));
581 bio_list_add(®
->delayed_bios
, bio
);
582 read_unlock(&rh
->hash_lock
);
585 static void rh_stop_recovery(struct region_hash
*rh
)
589 /* wait for any recovering regions */
590 for (i
= 0; i
< MAX_RECOVERY
; i
++)
591 down(&rh
->recovery_count
);
594 static void rh_start_recovery(struct region_hash
*rh
)
598 for (i
= 0; i
< MAX_RECOVERY
; i
++)
599 up(&rh
->recovery_count
);
605 * Every mirror should look like this one.
607 #define DEFAULT_MIRROR 0
610 * This is yucky. We squirrel the mirror_set struct away inside
611 * bi_next for write buffers. This is safe since the bh
612 * doesn't get submitted to the lower levels of block layer.
614 static struct mirror_set
*bio_get_ms(struct bio
*bio
)
616 return (struct mirror_set
*) bio
->bi_next
;
619 static void bio_set_ms(struct bio
*bio
, struct mirror_set
*ms
)
621 bio
->bi_next
= (struct bio
*) ms
;
624 /*-----------------------------------------------------------------
627 * When a mirror is first activated we may find that some regions
628 * are in the no-sync state. We have to recover these by
629 * recopying from the default mirror to all the others.
630 *---------------------------------------------------------------*/
631 static void recovery_complete(int read_err
, unsigned int write_err
,
634 struct region
*reg
= (struct region
*) context
;
636 /* FIXME: better error handling */
637 rh_recovery_end(reg
, !(read_err
|| write_err
));
640 static int recover(struct mirror_set
*ms
, struct region
*reg
)
644 struct io_region from
, to
[KCOPYD_MAX_REGIONS
], *dest
;
646 unsigned long flags
= 0;
648 /* fill in the source */
649 m
= ms
->default_mirror
;
650 from
.bdev
= m
->dev
->bdev
;
651 from
.sector
= m
->offset
+ region_to_sector(reg
->rh
, reg
->key
);
652 if (reg
->key
== (ms
->nr_regions
- 1)) {
654 * The final region may be smaller than
657 from
.count
= ms
->ti
->len
& (reg
->rh
->region_size
- 1);
659 from
.count
= reg
->rh
->region_size
;
661 from
.count
= reg
->rh
->region_size
;
663 /* fill in the destinations */
664 for (i
= 0, dest
= to
; i
< ms
->nr_mirrors
; i
++) {
665 if (&ms
->mirror
[i
] == ms
->default_mirror
)
669 dest
->bdev
= m
->dev
->bdev
;
670 dest
->sector
= m
->offset
+ region_to_sector(reg
->rh
, reg
->key
);
671 dest
->count
= from
.count
;
676 set_bit(KCOPYD_IGNORE_ERROR
, &flags
);
677 r
= kcopyd_copy(ms
->kcopyd_client
, &from
, ms
->nr_mirrors
- 1, to
, flags
,
678 recovery_complete
, reg
);
683 static void do_recovery(struct mirror_set
*ms
)
687 struct dirty_log
*log
= ms
->rh
.log
;
690 * Start quiescing some regions.
692 rh_recovery_prepare(&ms
->rh
);
695 * Copy any already quiesced regions.
697 while ((reg
= rh_recovery_start(&ms
->rh
))) {
698 r
= recover(ms
, reg
);
700 rh_recovery_end(reg
, 0);
704 * Update the in sync flag.
707 (log
->type
->get_sync_count(log
) == ms
->nr_regions
)) {
708 /* the sync is complete */
709 dm_table_event(ms
->ti
->table
);
714 /*-----------------------------------------------------------------
716 *---------------------------------------------------------------*/
717 static struct mirror
*choose_mirror(struct mirror_set
*ms
, sector_t sector
)
719 /* FIXME: add read balancing */
720 return ms
->default_mirror
;
724 * remap a buffer to a particular mirror.
726 static void map_bio(struct mirror_set
*ms
, struct mirror
*m
, struct bio
*bio
)
728 bio
->bi_bdev
= m
->dev
->bdev
;
729 bio
->bi_sector
= m
->offset
+ (bio
->bi_sector
- ms
->ti
->begin
);
732 static void do_reads(struct mirror_set
*ms
, struct bio_list
*reads
)
738 while ((bio
= bio_list_pop(reads
))) {
739 region
= bio_to_region(&ms
->rh
, bio
);
742 * We can only read balance if the region is in sync.
744 if (rh_in_sync(&ms
->rh
, region
, 1))
745 m
= choose_mirror(ms
, bio
->bi_sector
);
747 m
= ms
->default_mirror
;
750 generic_make_request(bio
);
754 /*-----------------------------------------------------------------
757 * We do different things with the write io depending on the
758 * state of the region that it's in:
760 * SYNC: increment pending, use kcopyd to write to *all* mirrors
761 * RECOVERING: delay the io until recovery completes
762 * NOSYNC: increment pending, just write to the default mirror
763 *---------------------------------------------------------------*/
764 static void write_callback(unsigned long error
, void *context
)
768 struct bio
*bio
= (struct bio
*) context
;
769 struct mirror_set
*ms
;
771 ms
= bio_get_ms(bio
);
772 bio_set_ms(bio
, NULL
);
775 * NOTE: We don't decrement the pending count here,
776 * instead it is done by the targets endio function.
777 * This way we handle both writes to SYNC and NOSYNC
778 * regions with the same code.
783 * only error the io if all mirrors failed.
787 for (i
= 0; i
< ms
->nr_mirrors
; i
++)
788 if (!test_bit(i
, &error
)) {
793 bio_endio(bio
, bio
->bi_size
, 0);
796 static void do_write(struct mirror_set
*ms
, struct bio
*bio
)
799 struct io_region io
[KCOPYD_MAX_REGIONS
+1];
801 struct dm_io_request io_req
= {
803 .mem
.type
= DM_IO_BVEC
,
804 .mem
.ptr
.bvec
= bio
->bi_io_vec
+ bio
->bi_idx
,
805 .notify
.fn
= write_callback
,
806 .notify
.context
= bio
,
807 .client
= ms
->io_client
,
810 for (i
= 0; i
< ms
->nr_mirrors
; i
++) {
813 io
[i
].bdev
= m
->dev
->bdev
;
814 io
[i
].sector
= m
->offset
+ (bio
->bi_sector
- ms
->ti
->begin
);
815 io
[i
].count
= bio
->bi_size
>> 9;
820 (void) dm_io(&io_req
, ms
->nr_mirrors
, io
, NULL
);
823 static void do_writes(struct mirror_set
*ms
, struct bio_list
*writes
)
827 struct bio_list sync
, nosync
, recover
, *this_list
= NULL
;
833 * Classify each write.
835 bio_list_init(&sync
);
836 bio_list_init(&nosync
);
837 bio_list_init(&recover
);
839 while ((bio
= bio_list_pop(writes
))) {
840 state
= rh_state(&ms
->rh
, bio_to_region(&ms
->rh
, bio
), 1);
852 this_list
= &recover
;
856 bio_list_add(this_list
, bio
);
860 * Increment the pending counts for any regions that will
861 * be written to (writes to recover regions are going to
864 rh_inc_pending(&ms
->rh
, &sync
);
865 rh_inc_pending(&ms
->rh
, &nosync
);
871 while ((bio
= bio_list_pop(&sync
)))
874 while ((bio
= bio_list_pop(&recover
)))
875 rh_delay(&ms
->rh
, bio
);
877 while ((bio
= bio_list_pop(&nosync
))) {
878 map_bio(ms
, ms
->default_mirror
, bio
);
879 generic_make_request(bio
);
883 /*-----------------------------------------------------------------
885 *---------------------------------------------------------------*/
886 static void do_mirror(struct work_struct
*work
)
888 struct mirror_set
*ms
=container_of(work
, struct mirror_set
,
890 struct bio_list reads
, writes
;
892 spin_lock(&ms
->lock
);
895 bio_list_init(&ms
->reads
);
896 bio_list_init(&ms
->writes
);
897 spin_unlock(&ms
->lock
);
899 rh_update_states(&ms
->rh
);
901 do_reads(ms
, &reads
);
902 do_writes(ms
, &writes
);
905 /*-----------------------------------------------------------------
907 *---------------------------------------------------------------*/
908 static struct mirror_set
*alloc_context(unsigned int nr_mirrors
,
909 uint32_t region_size
,
910 struct dm_target
*ti
,
911 struct dirty_log
*dl
)
914 struct mirror_set
*ms
= NULL
;
916 if (array_too_big(sizeof(*ms
), sizeof(ms
->mirror
[0]), nr_mirrors
))
919 len
= sizeof(*ms
) + (sizeof(ms
->mirror
[0]) * nr_mirrors
);
921 ms
= kmalloc(len
, GFP_KERNEL
);
923 ti
->error
= "Cannot allocate mirror context";
928 spin_lock_init(&ms
->lock
);
931 ms
->nr_mirrors
= nr_mirrors
;
932 ms
->nr_regions
= dm_sector_div_up(ti
->len
, region_size
);
934 ms
->default_mirror
= &ms
->mirror
[DEFAULT_MIRROR
];
936 ms
->io_client
= dm_io_client_create(DM_IO_PAGES
);
937 if (IS_ERR(ms
->io_client
)) {
938 ti
->error
= "Error creating dm_io client";
943 if (rh_init(&ms
->rh
, ms
, dl
, region_size
, ms
->nr_regions
)) {
944 ti
->error
= "Error creating dirty region hash";
952 static void free_context(struct mirror_set
*ms
, struct dm_target
*ti
,
956 dm_put_device(ti
, ms
->mirror
[m
].dev
);
958 dm_io_client_destroy(ms
->io_client
);
963 static inline int _check_region_size(struct dm_target
*ti
, uint32_t size
)
965 return !(size
% (PAGE_SIZE
>> 9) || (size
& (size
- 1)) ||
969 static int get_mirror(struct mirror_set
*ms
, struct dm_target
*ti
,
970 unsigned int mirror
, char **argv
)
972 unsigned long long offset
;
974 if (sscanf(argv
[1], "%llu", &offset
) != 1) {
975 ti
->error
= "Invalid offset";
979 if (dm_get_device(ti
, argv
[0], offset
, ti
->len
,
980 dm_table_get_mode(ti
->table
),
981 &ms
->mirror
[mirror
].dev
)) {
982 ti
->error
= "Device lookup failure";
986 ms
->mirror
[mirror
].offset
= offset
;
992 * Create dirty log: log_type #log_params <log_params>
994 static struct dirty_log
*create_dirty_log(struct dm_target
*ti
,
995 unsigned int argc
, char **argv
,
996 unsigned int *args_used
)
998 unsigned int param_count
;
999 struct dirty_log
*dl
;
1002 ti
->error
= "Insufficient mirror log arguments";
1006 if (sscanf(argv
[1], "%u", ¶m_count
) != 1) {
1007 ti
->error
= "Invalid mirror log argument count";
1011 *args_used
= 2 + param_count
;
1013 if (argc
< *args_used
) {
1014 ti
->error
= "Insufficient mirror log arguments";
1018 dl
= dm_create_dirty_log(argv
[0], ti
, param_count
, argv
+ 2);
1020 ti
->error
= "Error creating mirror dirty log";
1024 if (!_check_region_size(ti
, dl
->type
->get_region_size(dl
))) {
1025 ti
->error
= "Invalid region size";
1026 dm_destroy_dirty_log(dl
);
1033 static int parse_features(struct mirror_set
*ms
, unsigned argc
, char **argv
,
1034 unsigned *args_used
)
1036 unsigned num_features
;
1037 struct dm_target
*ti
= ms
->ti
;
1044 if (sscanf(argv
[0], "%u", &num_features
) != 1) {
1045 ti
->error
= "Invalid number of features";
1053 if (num_features
> argc
) {
1054 ti
->error
= "Not enough arguments to support feature count";
1058 if (!strcmp("handle_errors", argv
[0]))
1059 ms
->features
|= DM_RAID1_HANDLE_ERRORS
;
1061 ti
->error
= "Unrecognised feature requested";
1071 * Construct a mirror mapping:
1073 * log_type #log_params <log_params>
1074 * #mirrors [mirror_path offset]{2,}
1075 * [#features <features>]
1077 * log_type is "core" or "disk"
1078 * #log_params is between 1 and 3
1080 * If present, features must be "handle_errors".
1082 static int mirror_ctr(struct dm_target
*ti
, unsigned int argc
, char **argv
)
1085 unsigned int nr_mirrors
, m
, args_used
;
1086 struct mirror_set
*ms
;
1087 struct dirty_log
*dl
;
1089 dl
= create_dirty_log(ti
, argc
, argv
, &args_used
);
1096 if (!argc
|| sscanf(argv
[0], "%u", &nr_mirrors
) != 1 ||
1097 nr_mirrors
< 2 || nr_mirrors
> KCOPYD_MAX_REGIONS
+ 1) {
1098 ti
->error
= "Invalid number of mirrors";
1099 dm_destroy_dirty_log(dl
);
1105 if (argc
< nr_mirrors
* 2) {
1106 ti
->error
= "Too few mirror arguments";
1107 dm_destroy_dirty_log(dl
);
1111 ms
= alloc_context(nr_mirrors
, dl
->type
->get_region_size(dl
), ti
, dl
);
1113 dm_destroy_dirty_log(dl
);
1117 /* Get the mirror parameter sets */
1118 for (m
= 0; m
< nr_mirrors
; m
++) {
1119 r
= get_mirror(ms
, ti
, m
, argv
);
1121 free_context(ms
, ti
, m
);
1129 ti
->split_io
= ms
->rh
.region_size
;
1131 ms
->kmirrord_wq
= create_singlethread_workqueue("kmirrord");
1132 if (!ms
->kmirrord_wq
) {
1133 DMERR("couldn't start kmirrord");
1134 free_context(ms
, ti
, m
);
1137 INIT_WORK(&ms
->kmirrord_work
, do_mirror
);
1139 r
= parse_features(ms
, argc
, argv
, &args_used
);
1141 free_context(ms
, ti
, ms
->nr_mirrors
);
1149 ti
->error
= "Too many mirror arguments";
1150 free_context(ms
, ti
, ms
->nr_mirrors
);
1154 r
= kcopyd_client_create(DM_IO_PAGES
, &ms
->kcopyd_client
);
1156 destroy_workqueue(ms
->kmirrord_wq
);
1157 free_context(ms
, ti
, ms
->nr_mirrors
);
1165 static void mirror_dtr(struct dm_target
*ti
)
1167 struct mirror_set
*ms
= (struct mirror_set
*) ti
->private;
1169 flush_workqueue(ms
->kmirrord_wq
);
1170 kcopyd_client_destroy(ms
->kcopyd_client
);
1171 destroy_workqueue(ms
->kmirrord_wq
);
1172 free_context(ms
, ti
, ms
->nr_mirrors
);
1175 static void queue_bio(struct mirror_set
*ms
, struct bio
*bio
, int rw
)
1177 int should_wake
= 0;
1178 struct bio_list
*bl
;
1180 bl
= (rw
== WRITE
) ? &ms
->writes
: &ms
->reads
;
1181 spin_lock(&ms
->lock
);
1182 should_wake
= !(bl
->head
);
1183 bio_list_add(bl
, bio
);
1184 spin_unlock(&ms
->lock
);
1191 * Mirror mapping function
1193 static int mirror_map(struct dm_target
*ti
, struct bio
*bio
,
1194 union map_info
*map_context
)
1196 int r
, rw
= bio_rw(bio
);
1198 struct mirror_set
*ms
= ti
->private;
1200 map_context
->ll
= bio_to_region(&ms
->rh
, bio
);
1203 queue_bio(ms
, bio
, rw
);
1204 return DM_MAPIO_SUBMITTED
;
1207 r
= ms
->rh
.log
->type
->in_sync(ms
->rh
.log
,
1208 bio_to_region(&ms
->rh
, bio
), 0);
1209 if (r
< 0 && r
!= -EWOULDBLOCK
)
1212 if (r
== -EWOULDBLOCK
) /* FIXME: ugly */
1213 r
= DM_MAPIO_SUBMITTED
;
1216 * We don't want to fast track a recovery just for a read
1217 * ahead. So we just let it silently fail.
1218 * FIXME: get rid of this.
1220 if (!r
&& rw
== READA
)
1224 /* Pass this io over to the daemon */
1225 queue_bio(ms
, bio
, rw
);
1226 return DM_MAPIO_SUBMITTED
;
1229 m
= choose_mirror(ms
, bio
->bi_sector
);
1233 map_bio(ms
, m
, bio
);
1234 return DM_MAPIO_REMAPPED
;
1237 static int mirror_end_io(struct dm_target
*ti
, struct bio
*bio
,
1238 int error
, union map_info
*map_context
)
1240 int rw
= bio_rw(bio
);
1241 struct mirror_set
*ms
= (struct mirror_set
*) ti
->private;
1242 region_t region
= map_context
->ll
;
1245 * We need to dec pending if this was a write.
1248 rh_dec(&ms
->rh
, region
);
1253 static void mirror_postsuspend(struct dm_target
*ti
)
1255 struct mirror_set
*ms
= (struct mirror_set
*) ti
->private;
1256 struct dirty_log
*log
= ms
->rh
.log
;
1258 rh_stop_recovery(&ms
->rh
);
1260 /* Wait for all I/O we generated to complete */
1261 wait_event(_kmirrord_recovery_stopped
,
1262 !atomic_read(&ms
->rh
.recovery_in_flight
));
1264 if (log
->type
->suspend
&& log
->type
->suspend(log
))
1265 /* FIXME: need better error handling */
1266 DMWARN("log suspend failed");
1269 static void mirror_resume(struct dm_target
*ti
)
1271 struct mirror_set
*ms
= (struct mirror_set
*) ti
->private;
1272 struct dirty_log
*log
= ms
->rh
.log
;
1273 if (log
->type
->resume
&& log
->type
->resume(log
))
1274 /* FIXME: need better error handling */
1275 DMWARN("log resume failed");
1276 rh_start_recovery(&ms
->rh
);
1279 static int mirror_status(struct dm_target
*ti
, status_type_t type
,
1280 char *result
, unsigned int maxlen
)
1282 unsigned int m
, sz
= 0;
1283 struct mirror_set
*ms
= (struct mirror_set
*) ti
->private;
1286 case STATUSTYPE_INFO
:
1287 DMEMIT("%d ", ms
->nr_mirrors
);
1288 for (m
= 0; m
< ms
->nr_mirrors
; m
++)
1289 DMEMIT("%s ", ms
->mirror
[m
].dev
->name
);
1292 (unsigned long long)ms
->rh
.log
->type
->
1293 get_sync_count(ms
->rh
.log
),
1294 (unsigned long long)ms
->nr_regions
);
1296 sz
= ms
->rh
.log
->type
->status(ms
->rh
.log
, type
, result
, maxlen
);
1300 case STATUSTYPE_TABLE
:
1301 sz
= ms
->rh
.log
->type
->status(ms
->rh
.log
, type
, result
, maxlen
);
1303 DMEMIT("%d", ms
->nr_mirrors
);
1304 for (m
= 0; m
< ms
->nr_mirrors
; m
++)
1305 DMEMIT(" %s %llu", ms
->mirror
[m
].dev
->name
,
1306 (unsigned long long)ms
->mirror
[m
].offset
);
1308 if (ms
->features
& DM_RAID1_HANDLE_ERRORS
)
1309 DMEMIT(" 1 handle_errors");
1315 static struct target_type mirror_target
= {
1317 .version
= {1, 0, 3},
1318 .module
= THIS_MODULE
,
1322 .end_io
= mirror_end_io
,
1323 .postsuspend
= mirror_postsuspend
,
1324 .resume
= mirror_resume
,
1325 .status
= mirror_status
,
1328 static int __init
dm_mirror_init(void)
1332 r
= dm_dirty_log_init();
1336 r
= dm_register_target(&mirror_target
);
1338 DMERR("%s: Failed to register mirror target",
1339 mirror_target
.name
);
1340 dm_dirty_log_exit();
1346 static void __exit
dm_mirror_exit(void)
1350 r
= dm_unregister_target(&mirror_target
);
1352 DMERR("%s: unregister failed %d", mirror_target
.name
, r
);
1354 dm_dirty_log_exit();
1358 module_init(dm_mirror_init
);
1359 module_exit(dm_mirror_exit
);
1361 MODULE_DESCRIPTION(DM_NAME
" mirror target");
1362 MODULE_AUTHOR("Joe Thornber");
1363 MODULE_LICENSE("GPL");