[src/trunk]: src/share/man/man4 add a NOTE section documenting the broken Sea...

[jdolecek <jdolecek%NetBSD.org@localhost>]

details:   https://anonhg.NetBSD.org/src/rev/c31509974214
branches:  trunk
changeset: 353219:c31509974214
user:      jdolecek <jdolecek%NetBSD.org@localhost>
date:      Mon Apr 24 09:57:59 2017 +0000

description:
add a NOTE section documenting the broken Seagate Barracuda drives

diffstat:

 share/man/man4/wd.4 |  25 +++++++++++++++++++++++--
 1 files changed, 23 insertions(+), 2 deletions(-)

diffs (46 lines):

diff -r 68bd09a747e1 -r c31509974214 share/man/man4/wd.4
--- a/share/man/man4/wd.4       Mon Apr 24 09:42:52 2017 +0000
+++ b/share/man/man4/wd.4       Mon Apr 24 09:57:59 2017 +0000
@@ -1,4 +1,4 @@
-.\"    $NetBSD: wd.4,v 1.16 2011/08/04 15:40:20 matt Exp $
+.\"    $NetBSD: wd.4,v 1.17 2017/04/24 09:57:59 jdolecek Exp $
 .\"
 .\"
 .\" Copyright (c) 1994 James A. Jegers
@@ -23,7 +23,7 @@
 .\" (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
 .\" THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
 .\"
-.Dd August 30, 2004
+.Dd April 24, 2017
 .Dt WD 4
 .Os
 .Sh NAME
@@ -64,6 +64,27 @@
 .Xr badsect 8
 the software list does neither support sector replacement nor is it saved
 across reboots.
+.Sh NOTES
+Certain
+Seagate
+.Tn Barracuda
+drives sold around year 2003 have known firmware bug leading to corrupted
+write transfers for sector counts n*15 + 1, in combination with certain
+ATA controllers, most commonly
+.Tn Silicon Image
+3xxx.
+Affected drives include, but are not limited to:
+.Pp
+.Bl -tag -width Ds -offset indent -compact
+.It Seagate ST3120023AS
+.It Seagate ST380023AS
+.It Seagate ST360015AS
+.El
+.Pp
+If you have one of these drives, it's recommended to replace the drive.
+There used to exist a driver workaround greatly reducing performance,
+but the code was completely removed in
+.Nx 8.0 .
 .Sh SEE ALSO
 .Xr ata 4 ,
 .Xr intro 4 ,