[CONNECTOR]: Update documentation to match reality.
[linux-2.6/verdex.git] / include / linux / raid / raid1.h
blob60e19b667548feccf6d8dd5cac96ab0c3420c3a5
1 #ifndef _RAID1_H
2 #define _RAID1_H
4 #include <linux/raid/md.h>
6 typedef struct mirror_info mirror_info_t;
8 struct mirror_info {
9 mdk_rdev_t *rdev;
10 sector_t head_position;
14 * memory pools need a pointer to the mddev, so they can force an unplug
15 * when memory is tight, and a count of the number of drives that the
16 * pool was allocated for, so they know how much to allocate and free.
17 * mddev->raid_disks cannot be used, as it can change while a pool is active
18 * These two datums are stored in a kmalloced struct.
21 struct pool_info {
22 mddev_t *mddev;
23 int raid_disks;
27 typedef struct r1bio_s r1bio_t;
29 struct r1_private_data_s {
30 mddev_t *mddev;
31 mirror_info_t *mirrors;
32 int raid_disks;
33 int working_disks;
34 int last_used;
35 sector_t next_seq_sect;
36 spinlock_t device_lock;
38 struct list_head retry_list;
39 /* queue pending writes and submit them on unplug */
40 struct bio_list pending_bio_list;
41 /* queue of writes that have been unplugged */
42 struct bio_list flushing_bio_list;
44 /* for use when syncing mirrors: */
46 spinlock_t resync_lock;
47 int nr_pending;
48 int barrier;
49 sector_t next_resync;
50 int fullsync; /* set to 1 if a full sync is needed,
51 * (fresh device added).
52 * Cleared when a sync completes.
55 wait_queue_head_t wait_idle;
56 wait_queue_head_t wait_resume;
58 struct pool_info *poolinfo;
60 mempool_t *r1bio_pool;
61 mempool_t *r1buf_pool;
64 typedef struct r1_private_data_s conf_t;
67 * this is the only point in the RAID code where we violate
68 * C type safety. mddev->private is an 'opaque' pointer.
70 #define mddev_to_conf(mddev) ((conf_t *) mddev->private)
73 * this is our 'private' RAID1 bio.
75 * it contains information about what kind of IO operations were started
76 * for this RAID1 operation, and about their status:
79 struct r1bio_s {
80 atomic_t remaining; /* 'have we finished' count,
81 * used from IRQ handlers
83 atomic_t behind_remaining; /* number of write-behind ios remaining
84 * in this BehindIO request
86 sector_t sector;
87 int sectors;
88 unsigned long state;
89 mddev_t *mddev;
91 * original bio going to /dev/mdx
93 struct bio *master_bio;
95 * if the IO is in READ direction, then this is where we read
97 int read_disk;
99 struct list_head retry_list;
100 struct bitmap_update *bitmap_update;
102 * if the IO is in WRITE direction, then multiple bios are used.
103 * We choose the number when they are allocated.
105 struct bio *bios[0];
106 /* DO NOT PUT ANY NEW FIELDS HERE - bios array is contiguously alloced*/
109 /* bits for r1bio.state */
110 #define R1BIO_Uptodate 0
111 #define R1BIO_IsSync 1
112 #define R1BIO_Degraded 2
113 #define R1BIO_BehindIO 3
114 /* For write-behind requests, we call bi_end_io when
115 * the last non-write-behind device completes, providing
116 * any write was successful. Otherwise we call when
117 * any write-behind write succeeds, otherwise we call
118 * with failure when last write completes (and all failed).
119 * Record that bi_end_io was called with this flag...
121 #define R1BIO_Returned 4
123 #endif