From 9a8398173d9f00eed78ab0ad1d00afd2ee5e5f5b Mon Sep 17 00:00:00 2001
From: "Bjoern A. Zeeb" <bz@FreeBSD.org>
Date: Wed, 25 Jun 2008 18:11:22 +0000
Subject: [PATCH] Document spindown constraints as given in the original commit
 message[1] and later clarification provided by phk.

[1] http://docs.freebsd.org/cgi/mid.cgi?200803171033.m2HAXOeN055116

Reviewed by:	brueffer, phk, ed
---
 sbin/atacontrol/atacontrol.8 | 23 ++++++++++++++++++++++-
 1 file changed, 22 insertions(+), 1 deletion(-)

diff --git a/sbin/atacontrol/atacontrol.8 b/sbin/atacontrol/atacontrol.8
index a75548327f45..8b4967e82549 100644
--- a/sbin/atacontrol/atacontrol.8
+++ b/sbin/atacontrol/atacontrol.8
@@ -25,7 +25,7 @@
 .\"
 .\" $FreeBSD$
 .\"
-.Dd November 28, 2007
+.Dd June 25, 2008
 .Dt ATACONTROL 8
 .Os
 .Sh NAME
@@ -198,6 +198,10 @@ Show detailed info about the device on
 Set or report timeout after which the
 .Ar device 
 will be spun down.
+To arm the timeout the device needs at least one more request after
+setting the timeout.
+To disable spindown, set the timeout to zero.
+No further actions are needed in this case.
 .It Ic info
 Show info about the attached devices on the
 .Ar channel .
@@ -333,6 +337,23 @@ Issue the command:
 .Pp
 Now a status command will show the array rebuilding.
 .Pp
+To spin down a disk after 30 minutes run
+.Pp
+.Dl "atacontrol spindown ad6 1800"
+.Dl "dd if=/dev/ad6 of=/dev/null count=1"
+.Pp
+While any IO on the disk will arm the timer, using
+.Xr dd 1
+on the raw device will work in all cases, as when the disk is not
+opened at all.
+You can check the current setting with
+.Pp
+.Dl "atacontrol spindown ad6"
+.Pp
+You should not set a spindown timeout on a disk with
+.Pa /
+or syslog logging on it as the disk will be worn out spinning down and
+up all the time.
 .Sh SEE ALSO
 .Xr ata 4
 .Sh HISTORY