Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 1 | /* |
| 2 | md_k.h : kernel internal structure of the Linux MD driver |
| 3 | Copyright (C) 1996-98 Ingo Molnar, Gadi Oxman |
| 4 | |
| 5 | This program is free software; you can redistribute it and/or modify |
| 6 | it under the terms of the GNU General Public License as published by |
| 7 | the Free Software Foundation; either version 2, or (at your option) |
| 8 | any later version. |
| 9 | |
| 10 | You should have received a copy of the GNU General Public License |
| 11 | (for example /usr/src/linux/COPYING); if not, write to the Free |
| 12 | Software Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA. |
| 13 | */ |
| 14 | |
Christoph Hellwig | 63fe081 | 2009-04-14 12:01:53 +1000 | [diff] [blame] | 15 | #ifndef _MD_MD_H |
| 16 | #define _MD_MD_H |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 17 | |
Christoph Hellwig | 63fe081 | 2009-04-14 12:01:53 +1000 | [diff] [blame] | 18 | #include <linux/blkdev.h> |
| 19 | #include <linux/kobject.h> |
| 20 | #include <linux/list.h> |
| 21 | #include <linux/mm.h> |
| 22 | #include <linux/mutex.h> |
| 23 | #include <linux/timer.h> |
| 24 | #include <linux/wait.h> |
| 25 | #include <linux/workqueue.h> |
David Howells | 9361401 | 2006-09-30 20:45:40 +0200 | [diff] [blame] | 26 | |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 27 | #define MaxSector (~(sector_t)0) |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 28 | |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 29 | typedef struct mddev_s mddev_t; |
| 30 | typedef struct mdk_rdev_s mdk_rdev_t; |
| 31 | |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 32 | /* |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 33 | * MD's 'extended' device |
| 34 | */ |
| 35 | struct mdk_rdev_s |
| 36 | { |
| 37 | struct list_head same_set; /* RAID devices within the same set */ |
| 38 | |
Andre Noll | dd8ac33 | 2009-03-31 14:33:13 +1100 | [diff] [blame] | 39 | sector_t sectors; /* Device size (in 512bytes sectors) */ |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 40 | mddev_t *mddev; /* RAID array if running */ |
NeilBrown | eea1bf3 | 2009-03-31 14:27:02 +1100 | [diff] [blame] | 41 | int last_events; /* IO event timestamp */ |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 42 | |
| 43 | struct block_device *bdev; /* block device handle */ |
| 44 | |
| 45 | struct page *sb_page; |
| 46 | int sb_loaded; |
NeilBrown | 4254376 | 2006-06-26 00:27:57 -0700 | [diff] [blame] | 47 | __u64 sb_events; |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 48 | sector_t data_offset; /* start of data in array */ |
Andre Noll | 0f42035 | 2008-07-11 22:02:23 +1000 | [diff] [blame] | 49 | sector_t sb_start; /* offset of the super block (in 512byte sectors) */ |
NeilBrown | 0002b27 | 2005-09-09 16:23:53 -0700 | [diff] [blame] | 50 | int sb_size; /* bytes in the superblock */ |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 51 | int preferred_minor; /* autorun support */ |
| 52 | |
NeilBrown | 86e6ffd | 2005-11-08 21:39:24 -0800 | [diff] [blame] | 53 | struct kobject kobj; |
| 54 | |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 55 | /* A device can be in one of three states based on two flags: |
| 56 | * Not working: faulty==1 in_sync==0 |
| 57 | * Fully working: faulty==0 in_sync==1 |
| 58 | * Working, but not |
| 59 | * in sync with array |
| 60 | * faulty==0 in_sync==0 |
| 61 | * |
| 62 | * It can never have faulty==1, in_sync==1 |
| 63 | * This reduces the burden of testing multiple flags in many cases |
| 64 | */ |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 65 | |
NeilBrown | b2d444d | 2005-11-08 21:39:31 -0800 | [diff] [blame] | 66 | unsigned long flags; |
| 67 | #define Faulty 1 /* device is known to have a fault */ |
| 68 | #define In_sync 2 /* device is in_sync with rest of array */ |
NeilBrown | 8ddf9ef | 2005-09-09 16:23:45 -0700 | [diff] [blame] | 69 | #define WriteMostly 4 /* Avoid reading if at all possible */ |
Christoph Hellwig | 7b6d91d | 2010-08-07 18:20:39 +0200 | [diff] [blame^] | 70 | #define BarriersNotsupp 5 /* REQ_HARDBARRIER is not supported */ |
NeilBrown | c5d79ad | 2008-02-06 01:39:54 -0800 | [diff] [blame] | 71 | #define AllReserved 6 /* If whole device is reserved for |
| 72 | * one array */ |
NeilBrown | d0fae18 | 2008-03-04 14:29:31 -0800 | [diff] [blame] | 73 | #define AutoDetected 7 /* added by auto-detect */ |
Dan Williams | 6bfe0b4 | 2008-04-30 00:52:32 -0700 | [diff] [blame] | 74 | #define Blocked 8 /* An error occured on an externally |
| 75 | * managed array, don't allow writes |
| 76 | * until it is cleared */ |
| 77 | wait_queue_head_t blocked_wait; |
NeilBrown | 8ddf9ef | 2005-09-09 16:23:45 -0700 | [diff] [blame] | 78 | |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 79 | int desc_nr; /* descriptor index in the superblock */ |
| 80 | int raid_disk; /* role of device in array */ |
NeilBrown | e93f68a | 2010-06-15 09:36:03 +0100 | [diff] [blame] | 81 | int new_raid_disk; /* role that the device will have in |
| 82 | * the array after a level-change completes. |
| 83 | */ |
NeilBrown | 41158c7 | 2005-06-21 17:17:25 -0700 | [diff] [blame] | 84 | int saved_raid_disk; /* role that device used to have in the |
| 85 | * array and could again if we did a partial |
| 86 | * resync from the bitmap |
| 87 | */ |
NeilBrown | 5fd6c1d | 2006-06-26 00:27:40 -0700 | [diff] [blame] | 88 | sector_t recovery_offset;/* If this device has been partially |
| 89 | * recovered, this is where we were |
| 90 | * up to. |
| 91 | */ |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 92 | |
| 93 | atomic_t nr_pending; /* number of pending requests. |
| 94 | * only maintained for arrays that |
| 95 | * support hot removal |
| 96 | */ |
NeilBrown | ba22dcb | 2005-11-08 21:39:31 -0800 | [diff] [blame] | 97 | atomic_t read_errors; /* number of consecutive read errors that |
| 98 | * we have tried to ignore. |
| 99 | */ |
Robert Becker | 1e50915 | 2009-12-14 12:49:58 +1100 | [diff] [blame] | 100 | struct timespec last_read_error; /* monotonic time since our |
| 101 | * last read error |
| 102 | */ |
NeilBrown | 4dbcdc7 | 2006-01-06 00:20:52 -0800 | [diff] [blame] | 103 | atomic_t corrected_errors; /* number of corrected read errors, |
| 104 | * for reporting to userspace and storing |
| 105 | * in superblock. |
| 106 | */ |
NeilBrown | 5792a28 | 2007-04-04 19:08:18 -0700 | [diff] [blame] | 107 | struct work_struct del_work; /* used for delayed sysfs removal */ |
NeilBrown | 3c0ee63 | 2008-10-21 13:25:28 +1100 | [diff] [blame] | 108 | |
| 109 | struct sysfs_dirent *sysfs_state; /* handle for 'state' |
| 110 | * sysfs entry */ |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 111 | }; |
| 112 | |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 113 | struct mddev_s |
| 114 | { |
| 115 | void *private; |
NeilBrown | 2604b70 | 2006-01-06 00:20:36 -0800 | [diff] [blame] | 116 | struct mdk_personality *pers; |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 117 | dev_t unit; |
| 118 | int md_minor; |
| 119 | struct list_head disks; |
NeilBrown | 850b2b4 | 2006-10-03 01:15:46 -0700 | [diff] [blame] | 120 | unsigned long flags; |
| 121 | #define MD_CHANGE_DEVS 0 /* Some device status has changed */ |
| 122 | #define MD_CHANGE_CLEAN 1 /* transition to or from 'clean' */ |
| 123 | #define MD_CHANGE_PENDING 2 /* superblock update in progress */ |
| 124 | |
NeilBrown | 409c57f | 2009-03-31 14:39:39 +1100 | [diff] [blame] | 125 | int suspended; |
| 126 | atomic_t active_io; |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 127 | int ro; |
| 128 | |
| 129 | struct gendisk *gendisk; |
| 130 | |
NeilBrown | eae1701 | 2005-11-08 21:39:23 -0800 | [diff] [blame] | 131 | struct kobject kobj; |
NeilBrown | d337482 | 2009-01-09 08:31:10 +1100 | [diff] [blame] | 132 | int hold_active; |
| 133 | #define UNTIL_IOCTL 1 |
NeilBrown | efeb53c | 2009-01-09 08:31:10 +1100 | [diff] [blame] | 134 | #define UNTIL_STOP 2 |
NeilBrown | eae1701 | 2005-11-08 21:39:23 -0800 | [diff] [blame] | 135 | |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 136 | /* Superblock information */ |
| 137 | int major_version, |
| 138 | minor_version, |
| 139 | patch_version; |
| 140 | int persistent; |
NeilBrown | e691063 | 2008-02-06 01:39:51 -0800 | [diff] [blame] | 141 | int external; /* metadata is |
| 142 | * managed externally */ |
| 143 | char metadata_type[17]; /* externally set*/ |
Andre Noll | 9d8f036 | 2009-06-18 08:45:01 +1000 | [diff] [blame] | 144 | int chunk_sectors; |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 145 | time_t ctime, utime; |
| 146 | int level, layout; |
NeilBrown | d9d166c | 2006-01-06 00:20:51 -0800 | [diff] [blame] | 147 | char clevel[16]; |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 148 | int raid_disks; |
| 149 | int max_disks; |
Andre Noll | 58c0fed | 2009-03-31 14:33:13 +1100 | [diff] [blame] | 150 | sector_t dev_sectors; /* used size of |
| 151 | * component devices */ |
Andre Noll | f233ea5 | 2008-07-21 17:05:22 +1000 | [diff] [blame] | 152 | sector_t array_sectors; /* exported array size */ |
Dan Williams | b522adc | 2009-03-31 15:00:31 +1100 | [diff] [blame] | 153 | int external_size; /* size managed |
| 154 | * externally */ |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 155 | __u64 events; |
NeilBrown | a8707c0 | 2010-05-18 09:28:43 +1000 | [diff] [blame] | 156 | /* If the last 'event' was simply a clean->dirty transition, and |
| 157 | * we didn't write it to the spares, then it is safe and simple |
| 158 | * to just decrement the event count on a dirty->clean transition. |
| 159 | * So we record that possibility here. |
| 160 | */ |
| 161 | int can_decrease_events; |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 162 | |
| 163 | char uuid[16]; |
| 164 | |
NeilBrown | f670557 | 2006-03-27 01:18:11 -0800 | [diff] [blame] | 165 | /* If the array is being reshaped, we need to record the |
| 166 | * new shape and an indication of where we are up to. |
| 167 | * This is written to the superblock. |
| 168 | * If reshape_position is MaxSector, then no reshape is happening (yet). |
| 169 | */ |
| 170 | sector_t reshape_position; |
Andre Noll | 664e7c4 | 2009-06-18 08:45:27 +1000 | [diff] [blame] | 171 | int delta_disks, new_level, new_layout; |
| 172 | int new_chunk_sectors; |
NeilBrown | f670557 | 2006-03-27 01:18:11 -0800 | [diff] [blame] | 173 | |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 174 | struct mdk_thread_s *thread; /* management thread */ |
| 175 | struct mdk_thread_s *sync_thread; /* doing resync or reconstruct */ |
NeilBrown | ff4e8d9 | 2006-07-10 04:44:16 -0700 | [diff] [blame] | 176 | sector_t curr_resync; /* last block scheduled */ |
NeilBrown | 97e4f42 | 2009-03-31 14:33:13 +1100 | [diff] [blame] | 177 | /* As resync requests can complete out of order, we cannot easily track |
| 178 | * how much resync has been completed. So we occasionally pause until |
| 179 | * everything completes, then set curr_resync_completed to curr_resync. |
| 180 | * As such it may be well behind the real resync mark, but it is a value |
| 181 | * we are certain of. |
| 182 | */ |
| 183 | sector_t curr_resync_completed; |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 184 | unsigned long resync_mark; /* a recent timestamp */ |
| 185 | sector_t resync_mark_cnt;/* blocks written at resync_mark */ |
NeilBrown | ff4e8d9 | 2006-07-10 04:44:16 -0700 | [diff] [blame] | 186 | sector_t curr_mark_cnt; /* blocks scheduled now */ |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 187 | |
| 188 | sector_t resync_max_sectors; /* may be set by personality */ |
NeilBrown | 9d88883 | 2005-11-08 21:39:26 -0800 | [diff] [blame] | 189 | |
| 190 | sector_t resync_mismatches; /* count of sectors where |
| 191 | * parity/replica mismatch found |
| 192 | */ |
NeilBrown | e464eaf | 2006-03-27 01:18:14 -0800 | [diff] [blame] | 193 | |
| 194 | /* allow user-space to request suspension of IO to regions of the array */ |
| 195 | sector_t suspend_lo; |
| 196 | sector_t suspend_hi; |
NeilBrown | 88202a0 | 2006-01-06 00:21:36 -0800 | [diff] [blame] | 197 | /* if zero, use the system-wide default */ |
| 198 | int sync_speed_min; |
| 199 | int sync_speed_max; |
| 200 | |
Bernd Schubert | 90b0871 | 2008-05-23 13:04:38 -0700 | [diff] [blame] | 201 | /* resync even though the same disks are shared among md-devices */ |
| 202 | int parallel_resync; |
| 203 | |
NeilBrown | 6ff8d8ec | 2006-01-06 00:20:15 -0800 | [diff] [blame] | 204 | int ok_start_degraded; |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 205 | /* recovery/resync flags |
| 206 | * NEEDED: we might need to start a resync/recover |
| 207 | * RUNNING: a thread is running, or about to be started |
| 208 | * SYNC: actually doing a resync, not a recovery |
Neil Brown | 72a23c2 | 2008-06-28 08:31:41 +1000 | [diff] [blame] | 209 | * RECOVER: doing recovery, or need to try it. |
NeilBrown | dfc7064 | 2008-05-23 13:04:39 -0700 | [diff] [blame] | 210 | * INTR: resync needs to be aborted for some reason |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 211 | * DONE: thread is done and is waiting to be reaped |
NeilBrown | 24dd469 | 2005-11-08 21:39:26 -0800 | [diff] [blame] | 212 | * REQUEST: user-space has requested a sync (used with SYNC) |
Anand Gadiyar | 411c940 | 2009-07-07 15:24:23 +0530 | [diff] [blame] | 213 | * CHECK: user-space request for check-only, no repair |
NeilBrown | ccfcc3c | 2006-03-27 01:18:09 -0800 | [diff] [blame] | 214 | * RESHAPE: A reshape is happening |
| 215 | * |
| 216 | * If neither SYNC or RESHAPE are set, then it is a recovery. |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 217 | */ |
| 218 | #define MD_RECOVERY_RUNNING 0 |
| 219 | #define MD_RECOVERY_SYNC 1 |
Neil Brown | 72a23c2 | 2008-06-28 08:31:41 +1000 | [diff] [blame] | 220 | #define MD_RECOVERY_RECOVER 2 |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 221 | #define MD_RECOVERY_INTR 3 |
| 222 | #define MD_RECOVERY_DONE 4 |
| 223 | #define MD_RECOVERY_NEEDED 5 |
NeilBrown | 24dd469 | 2005-11-08 21:39:26 -0800 | [diff] [blame] | 224 | #define MD_RECOVERY_REQUESTED 6 |
| 225 | #define MD_RECOVERY_CHECK 7 |
NeilBrown | ccfcc3c | 2006-03-27 01:18:09 -0800 | [diff] [blame] | 226 | #define MD_RECOVERY_RESHAPE 8 |
NeilBrown | 5fd6c1d | 2006-06-26 00:27:40 -0700 | [diff] [blame] | 227 | #define MD_RECOVERY_FROZEN 9 |
| 228 | |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 229 | unsigned long recovery; |
NeilBrown | 4044ba5 | 2009-01-09 08:31:11 +1100 | [diff] [blame] | 230 | int recovery_disabled; /* if we detect that recovery |
| 231 | * will always fail, set this |
| 232 | * so we don't loop trying */ |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 233 | |
| 234 | int in_sync; /* know to not need resync */ |
NeilBrown | c8c00a6 | 2009-08-10 12:50:52 +1000 | [diff] [blame] | 235 | /* 'open_mutex' avoids races between 'md_open' and 'do_md_stop', so |
| 236 | * that we are never stopping an array while it is open. |
| 237 | * 'reconfig_mutex' protects all other reconfiguration. |
| 238 | * These locks are separate due to conflicting interactions |
| 239 | * with bdev->bd_mutex. |
| 240 | * Lock ordering is: |
| 241 | * reconfig_mutex -> bd_mutex : e.g. do_md_run -> revalidate_disk |
| 242 | * bd_mutex -> open_mutex: e.g. __blkdev_get -> md_open |
| 243 | */ |
| 244 | struct mutex open_mutex; |
NeilBrown | df5b89b | 2006-03-27 01:18:20 -0800 | [diff] [blame] | 245 | struct mutex reconfig_mutex; |
NeilBrown | f2ea68c | 2008-07-21 17:05:25 +1000 | [diff] [blame] | 246 | atomic_t active; /* general refcount */ |
| 247 | atomic_t openers; /* number of active opens */ |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 248 | |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 249 | int degraded; /* whether md should consider |
| 250 | * adding a spare |
| 251 | */ |
NeilBrown | a9701a3 | 2005-11-08 21:39:34 -0800 | [diff] [blame] | 252 | int barriers_work; /* initialised to true, cleared as soon |
| 253 | * as a barrier request to slave |
| 254 | * fails. Only supported |
| 255 | */ |
| 256 | struct bio *biolist; /* bios that need to be retried |
Christoph Hellwig | 7b6d91d | 2010-08-07 18:20:39 +0200 | [diff] [blame^] | 257 | * because REQ_HARDBARRIER is not supported |
NeilBrown | a9701a3 | 2005-11-08 21:39:34 -0800 | [diff] [blame] | 258 | */ |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 259 | |
| 260 | atomic_t recovery_active; /* blocks scheduled, but not written */ |
| 261 | wait_queue_head_t recovery_wait; |
| 262 | sector_t recovery_cp; |
Neil Brown | 5e96ee6 | 2008-06-28 08:31:24 +1000 | [diff] [blame] | 263 | sector_t resync_min; /* user requested sync |
| 264 | * starts here */ |
NeilBrown | c620727 | 2008-02-06 01:39:52 -0800 | [diff] [blame] | 265 | sector_t resync_max; /* resync should pause |
| 266 | * when it gets here */ |
NeilBrown | 06d91a5 | 2005-06-21 17:17:12 -0700 | [diff] [blame] | 267 | |
NeilBrown | b62b759 | 2008-10-21 13:25:21 +1100 | [diff] [blame] | 268 | struct sysfs_dirent *sysfs_state; /* handle for 'array_state' |
| 269 | * file in sysfs. |
| 270 | */ |
NeilBrown | 0c3573f | 2009-01-09 08:31:05 +1100 | [diff] [blame] | 271 | struct sysfs_dirent *sysfs_action; /* handle for 'sync_action' */ |
NeilBrown | b62b759 | 2008-10-21 13:25:21 +1100 | [diff] [blame] | 272 | |
NeilBrown | d337482 | 2009-01-09 08:31:10 +1100 | [diff] [blame] | 273 | struct work_struct del_work; /* used for delayed sysfs removal */ |
| 274 | |
NeilBrown | 06d91a5 | 2005-06-21 17:17:12 -0700 | [diff] [blame] | 275 | spinlock_t write_lock; |
NeilBrown | 3d310eb | 2005-06-21 17:17:26 -0700 | [diff] [blame] | 276 | wait_queue_head_t sb_wait; /* for waiting on superblock updates */ |
NeilBrown | 7bfa19f | 2005-06-21 17:17:28 -0700 | [diff] [blame] | 277 | atomic_t pending_writes; /* number of active superblock writes */ |
NeilBrown | 06d91a5 | 2005-06-21 17:17:12 -0700 | [diff] [blame] | 278 | |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 279 | unsigned int safemode; /* if set, update "clean" superblock |
| 280 | * when no writes pending. |
| 281 | */ |
| 282 | unsigned int safemode_delay; |
| 283 | struct timer_list safemode_timer; |
| 284 | atomic_t writes_pending; |
Jens Axboe | 165125e | 2007-07-24 09:28:11 +0200 | [diff] [blame] | 285 | struct request_queue *queue; /* for plugging ... */ |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 286 | |
NeilBrown | 32a7627 | 2005-06-21 17:17:14 -0700 | [diff] [blame] | 287 | struct bitmap *bitmap; /* the bitmap for the device */ |
NeilBrown | c3d9714 | 2009-12-14 12:49:52 +1100 | [diff] [blame] | 288 | struct { |
| 289 | struct file *file; /* the bitmap file */ |
NeilBrown | f6af949 | 2009-12-14 12:49:54 +1100 | [diff] [blame] | 290 | loff_t offset; /* offset from superblock of |
NeilBrown | c3d9714 | 2009-12-14 12:49:52 +1100 | [diff] [blame] | 291 | * start of bitmap. May be |
| 292 | * negative, but not '0' |
NeilBrown | f6af949 | 2009-12-14 12:49:54 +1100 | [diff] [blame] | 293 | * For external metadata, offset |
| 294 | * from start of device. |
NeilBrown | c3d9714 | 2009-12-14 12:49:52 +1100 | [diff] [blame] | 295 | */ |
NeilBrown | f6af949 | 2009-12-14 12:49:54 +1100 | [diff] [blame] | 296 | loff_t default_offset; /* this is the offset to use when |
NeilBrown | c3d9714 | 2009-12-14 12:49:52 +1100 | [diff] [blame] | 297 | * hot-adding a bitmap. It should |
| 298 | * eventually be settable by sysfs. |
| 299 | */ |
| 300 | struct mutex mutex; |
NeilBrown | 42a04b5 | 2009-12-14 12:49:53 +1100 | [diff] [blame] | 301 | unsigned long chunksize; |
| 302 | unsigned long daemon_sleep; /* how many seconds between updates? */ |
| 303 | unsigned long max_write_behind; /* write-behind mode */ |
NeilBrown | ece5cff | 2009-12-14 12:49:56 +1100 | [diff] [blame] | 304 | int external; |
NeilBrown | c3d9714 | 2009-12-14 12:49:52 +1100 | [diff] [blame] | 305 | } bitmap_info; |
NeilBrown | 32a7627 | 2005-06-21 17:17:14 -0700 | [diff] [blame] | 306 | |
Robert Becker | 1e50915 | 2009-12-14 12:49:58 +1100 | [diff] [blame] | 307 | atomic_t max_corr_read_errors; /* max read retries */ |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 308 | struct list_head all_mddevs; |
NeilBrown | a2826aa | 2009-12-14 12:49:49 +1100 | [diff] [blame] | 309 | |
NeilBrown | a64c876 | 2010-04-14 17:15:37 +1000 | [diff] [blame] | 310 | struct attribute_group *to_remove; |
NeilBrown | a2826aa | 2009-12-14 12:49:49 +1100 | [diff] [blame] | 311 | /* Generic barrier handling. |
| 312 | * If there is a pending barrier request, all other |
| 313 | * writes are blocked while the devices are flushed. |
| 314 | * The last to finish a flush schedules a worker to |
| 315 | * submit the barrier request (without the barrier flag), |
| 316 | * then submit more flush requests. |
| 317 | */ |
| 318 | struct bio *barrier; |
| 319 | atomic_t flush_pending; |
| 320 | struct work_struct barrier_work; |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 321 | }; |
| 322 | |
| 323 | |
| 324 | static inline void rdev_dec_pending(mdk_rdev_t *rdev, mddev_t *mddev) |
| 325 | { |
NeilBrown | b2d444d | 2005-11-08 21:39:31 -0800 | [diff] [blame] | 326 | int faulty = test_bit(Faulty, &rdev->flags); |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 327 | if (atomic_dec_and_test(&rdev->nr_pending) && faulty) |
| 328 | set_bit(MD_RECOVERY_NEEDED, &mddev->recovery); |
| 329 | } |
| 330 | |
| 331 | static inline void md_sync_acct(struct block_device *bdev, unsigned long nr_sectors) |
| 332 | { |
| 333 | atomic_add(nr_sectors, &bdev->bd_contains->bd_disk->sync_io); |
| 334 | } |
| 335 | |
NeilBrown | 2604b70 | 2006-01-06 00:20:36 -0800 | [diff] [blame] | 336 | struct mdk_personality |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 337 | { |
| 338 | char *name; |
NeilBrown | 2604b70 | 2006-01-06 00:20:36 -0800 | [diff] [blame] | 339 | int level; |
| 340 | struct list_head list; |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 341 | struct module *owner; |
NeilBrown | 21a52c6 | 2010-04-01 15:02:13 +1100 | [diff] [blame] | 342 | int (*make_request)(mddev_t *mddev, struct bio *bio); |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 343 | int (*run)(mddev_t *mddev); |
| 344 | int (*stop)(mddev_t *mddev); |
| 345 | void (*status)(struct seq_file *seq, mddev_t *mddev); |
| 346 | /* error_handler must set ->faulty and clear ->in_sync |
| 347 | * if appropriate, and should abort recovery if needed |
| 348 | */ |
| 349 | void (*error_handler)(mddev_t *mddev, mdk_rdev_t *rdev); |
| 350 | int (*hot_add_disk) (mddev_t *mddev, mdk_rdev_t *rdev); |
| 351 | int (*hot_remove_disk) (mddev_t *mddev, int number); |
| 352 | int (*spare_active) (mddev_t *mddev); |
NeilBrown | 57afd89 | 2005-06-21 17:17:13 -0700 | [diff] [blame] | 353 | sector_t (*sync_request)(mddev_t *mddev, sector_t sector_nr, int *skipped, int go_faster); |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 354 | int (*resize) (mddev_t *mddev, sector_t sectors); |
Dan Williams | 80c3a6c | 2009-03-17 18:10:40 -0700 | [diff] [blame] | 355 | sector_t (*size) (mddev_t *mddev, sector_t sectors, int raid_disks); |
NeilBrown | 63c70c4 | 2006-03-27 01:18:13 -0800 | [diff] [blame] | 356 | int (*check_reshape) (mddev_t *mddev); |
| 357 | int (*start_reshape) (mddev_t *mddev); |
NeilBrown | cea9c22 | 2009-03-31 15:15:05 +1100 | [diff] [blame] | 358 | void (*finish_reshape) (mddev_t *mddev); |
NeilBrown | 36fa306 | 2005-09-09 16:23:45 -0700 | [diff] [blame] | 359 | /* quiesce moves between quiescence states |
| 360 | * 0 - fully active |
| 361 | * 1 - no new requests allowed |
| 362 | * others - reserved |
| 363 | */ |
| 364 | void (*quiesce) (mddev_t *mddev, int state); |
NeilBrown | 245f46c | 2009-03-31 14:39:39 +1100 | [diff] [blame] | 365 | /* takeover is used to transition an array from one |
| 366 | * personality to another. The new personality must be able |
| 367 | * to handle the data in the current layout. |
| 368 | * e.g. 2drive raid1 -> 2drive raid5 |
| 369 | * ndrive raid5 -> degraded n+1drive raid6 with special layout |
| 370 | * If the takeover succeeds, a new 'private' structure is returned. |
| 371 | * This needs to be installed and then ->run used to activate the |
| 372 | * array. |
| 373 | */ |
| 374 | void *(*takeover) (mddev_t *mddev); |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 375 | }; |
| 376 | |
| 377 | |
NeilBrown | 007583c | 2005-11-08 21:39:30 -0800 | [diff] [blame] | 378 | struct md_sysfs_entry { |
| 379 | struct attribute attr; |
| 380 | ssize_t (*show)(mddev_t *, char *); |
| 381 | ssize_t (*store)(mddev_t *, const char *, size_t); |
| 382 | }; |
NeilBrown | 43a7050 | 2009-12-14 12:49:55 +1100 | [diff] [blame] | 383 | extern struct attribute_group md_bitmap_group; |
NeilBrown | 007583c | 2005-11-08 21:39:30 -0800 | [diff] [blame] | 384 | |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 385 | static inline char * mdname (mddev_t * mddev) |
| 386 | { |
| 387 | return mddev->gendisk ? mddev->gendisk->disk_name : "mdX"; |
| 388 | } |
| 389 | |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 390 | /* |
| 391 | * iterates through some rdev ringlist. It's safe to remove the |
| 392 | * current 'rdev'. Dont touch 'tmp' though. |
| 393 | */ |
Cheng Renquan | 159ec1f | 2009-01-09 08:31:08 +1100 | [diff] [blame] | 394 | #define rdev_for_each_list(rdev, tmp, head) \ |
| 395 | list_for_each_entry_safe(rdev, tmp, head, same_set) |
| 396 | |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 397 | /* |
| 398 | * iterates through the 'same array disks' ringlist |
| 399 | */ |
NeilBrown | d089c6a | 2008-02-06 01:39:59 -0800 | [diff] [blame] | 400 | #define rdev_for_each(rdev, tmp, mddev) \ |
Cheng Renquan | 159ec1f | 2009-01-09 08:31:08 +1100 | [diff] [blame] | 401 | list_for_each_entry_safe(rdev, tmp, &((mddev)->disks), same_set) |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 402 | |
NeilBrown | 4b80991 | 2008-07-21 17:05:25 +1000 | [diff] [blame] | 403 | #define rdev_for_each_rcu(rdev, mddev) \ |
| 404 | list_for_each_entry_rcu(rdev, &((mddev)->disks), same_set) |
| 405 | |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 406 | typedef struct mdk_thread_s { |
| 407 | void (*run) (mddev_t *mddev); |
| 408 | mddev_t *mddev; |
| 409 | wait_queue_head_t wqueue; |
| 410 | unsigned long flags; |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 411 | struct task_struct *tsk; |
NeilBrown | 32a7627 | 2005-06-21 17:17:14 -0700 | [diff] [blame] | 412 | unsigned long timeout; |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 413 | } mdk_thread_t; |
| 414 | |
| 415 | #define THREAD_WAKEUP 0 |
| 416 | |
| 417 | #define __wait_event_lock_irq(wq, condition, lock, cmd) \ |
| 418 | do { \ |
| 419 | wait_queue_t __wait; \ |
| 420 | init_waitqueue_entry(&__wait, current); \ |
| 421 | \ |
| 422 | add_wait_queue(&wq, &__wait); \ |
| 423 | for (;;) { \ |
| 424 | set_current_state(TASK_UNINTERRUPTIBLE); \ |
| 425 | if (condition) \ |
| 426 | break; \ |
| 427 | spin_unlock_irq(&lock); \ |
| 428 | cmd; \ |
| 429 | schedule(); \ |
| 430 | spin_lock_irq(&lock); \ |
| 431 | } \ |
| 432 | current->state = TASK_RUNNING; \ |
| 433 | remove_wait_queue(&wq, &__wait); \ |
| 434 | } while (0) |
| 435 | |
| 436 | #define wait_event_lock_irq(wq, condition, lock, cmd) \ |
| 437 | do { \ |
| 438 | if (condition) \ |
| 439 | break; \ |
| 440 | __wait_event_lock_irq(wq, condition, lock, cmd); \ |
| 441 | } while (0) |
| 442 | |
NeilBrown | 1345b1d | 2006-01-06 00:20:40 -0800 | [diff] [blame] | 443 | static inline void safe_put_page(struct page *p) |
| 444 | { |
| 445 | if (p) put_page(p); |
| 446 | } |
| 447 | |
NeilBrown | 9202295 | 2009-03-31 14:33:13 +1100 | [diff] [blame] | 448 | extern int register_md_personality(struct mdk_personality *p); |
| 449 | extern int unregister_md_personality(struct mdk_personality *p); |
| 450 | extern mdk_thread_t * md_register_thread(void (*run) (mddev_t *mddev), |
| 451 | mddev_t *mddev, const char *name); |
| 452 | extern void md_unregister_thread(mdk_thread_t *thread); |
| 453 | extern void md_wakeup_thread(mdk_thread_t *thread); |
| 454 | extern void md_check_recovery(mddev_t *mddev); |
| 455 | extern void md_write_start(mddev_t *mddev, struct bio *bi); |
| 456 | extern void md_write_end(mddev_t *mddev); |
| 457 | extern void md_done_sync(mddev_t *mddev, int blocks, int ok); |
| 458 | extern void md_error(mddev_t *mddev, mdk_rdev_t *rdev); |
| 459 | |
NeilBrown | 3fa841d | 2009-09-23 18:10:29 +1000 | [diff] [blame] | 460 | extern int mddev_congested(mddev_t *mddev, int bits); |
NeilBrown | a2826aa | 2009-12-14 12:49:49 +1100 | [diff] [blame] | 461 | extern void md_barrier_request(mddev_t *mddev, struct bio *bio); |
NeilBrown | 9202295 | 2009-03-31 14:33:13 +1100 | [diff] [blame] | 462 | extern void md_super_write(mddev_t *mddev, mdk_rdev_t *rdev, |
| 463 | sector_t sector, int size, struct page *page); |
| 464 | extern void md_super_wait(mddev_t *mddev); |
| 465 | extern int sync_page_io(struct block_device *bdev, sector_t sector, int size, |
| 466 | struct page *page, int rw); |
| 467 | extern void md_do_sync(mddev_t *mddev); |
| 468 | extern void md_new_event(mddev_t *mddev); |
| 469 | extern int md_allow_write(mddev_t *mddev); |
| 470 | extern void md_wait_for_blocked_rdev(mdk_rdev_t *rdev, mddev_t *mddev); |
Dan Williams | 1f40362 | 2009-03-31 14:59:03 +1100 | [diff] [blame] | 471 | extern void md_set_array_sectors(mddev_t *mddev, sector_t array_sectors); |
Andre Noll | 0894cc3 | 2009-06-18 08:49:23 +1000 | [diff] [blame] | 472 | extern int md_check_no_bitmap(mddev_t *mddev); |
Andre Noll | ac5e711 | 2009-08-03 10:59:47 +1000 | [diff] [blame] | 473 | extern int md_integrity_register(mddev_t *mddev); |
NeilBrown | 72e0207 | 2009-12-14 12:49:55 +1100 | [diff] [blame] | 474 | extern void md_integrity_add_rdev(mdk_rdev_t *rdev, mddev_t *mddev); |
| 475 | extern int strict_strtoul_scaled(const char *cp, unsigned long *res, int scale); |
NeilBrown | 43a7050 | 2009-12-14 12:49:55 +1100 | [diff] [blame] | 476 | extern void restore_bitmap_write_access(struct file *file); |
Christoph Hellwig | 63fe081 | 2009-04-14 12:01:53 +1000 | [diff] [blame] | 477 | |
| 478 | #endif /* _MD_MD_H */ |