Commit 0b7d83865cb7a60b1768212c1e60b8fd7c280506
Committed by
NeilBrown
1 parent
de393cdea6
Exists in
master
and in
4 other branches
md: update documentation for md/rdev/state sysfs interface
Previous patches in the bad block series extended behavior of rdev's 'state' interface but lacked documentation update. Fix it. Signed-off-by: Namhyung Kim <namhyung@gmail.com> Signed-off-by: NeilBrown <neilb@suse.de>
Showing 1 changed file with 9 additions and 5 deletions Side-by-side Diff
Documentation/md.txt
... | ... | @@ -360,18 +360,20 @@ |
360 | 360 | A file recording the current state of the device in the array |
361 | 361 | which can be a comma separated list of |
362 | 362 | faulty - device has been kicked from active use due to |
363 | - a detected fault | |
363 | + a detected fault or it has unacknowledged bad | |
364 | + blocks | |
364 | 365 | in_sync - device is a fully in-sync member of the array |
365 | 366 | writemostly - device will only be subject to read |
366 | 367 | requests if there are no other options. |
367 | 368 | This applies only to raid1 arrays. |
368 | - blocked - device has failed, metadata is "external", | |
369 | - and the failure hasn't been acknowledged yet. | |
369 | + blocked - device has failed, and the failure hasn't been | |
370 | + acknowledged yet by the metadata handler. | |
370 | 371 | Writes that would write to this device if |
371 | 372 | it were not faulty are blocked. |
372 | 373 | spare - device is working, but not a full member. |
373 | 374 | This includes spares that are in the process |
374 | 375 | of being recovered to |
376 | + write_error - device has ever seen a write error. | |
375 | 377 | This list may grow in future. |
376 | 378 | This can be written to. |
377 | 379 | Writing "faulty" simulates a failure on the device. |
378 | 380 | |
... | ... | @@ -379,9 +381,11 @@ |
379 | 381 | Writing "writemostly" sets the writemostly flag. |
380 | 382 | Writing "-writemostly" clears the writemostly flag. |
381 | 383 | Writing "blocked" sets the "blocked" flag. |
382 | - Writing "-blocked" clears the "blocked" flag and allows writes | |
383 | - to complete. | |
384 | + Writing "-blocked" clears the "blocked" flags and allows writes | |
385 | + to complete and possibly simulates an error. | |
384 | 386 | Writing "in_sync" sets the in_sync flag. |
387 | + Writing "write_error" sets writeerrorseen flag. | |
388 | + Writing "-write_error" clears writeerrorseen flag. | |
385 | 389 | |
386 | 390 | This file responds to select/poll. Any change to 'faulty' |
387 | 391 | or 'blocked' causes an event. |