Commit 0b7d83865cb7a60b1768212c1e60b8fd7c280506

Authored by Namhyung Kim
Committed by NeilBrown
1 parent de393cdea6

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.