Skip to content
This repository
Browse code

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>
  • Loading branch information...
commit 0b7d83865cb7a60b1768212c1e60b8fd7c280506 1 parent de393cd
Namhyung Kim authored July 28, 2011 neilbrown committed July 28, 2011

Showing 1 changed file with 9 additions and 5 deletions. Show diff stats Hide diff stats

  1. 14  Documentation/md.txt
14  Documentation/md.txt
@@ -360,18 +360,20 @@ Each directory contains:
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.
@@ -379,9 +381,11 @@ Each directory contains:
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.

0 notes on commit 0b7d838

Please sign in to comment.
Something went wrong with that request. Please try again.