[src/netbsd-3]: src/sbin/atactl Pull up revision 1.20 (requested by drochner ...

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

details:   https://anonhg.NetBSD.org/src/rev/88febd78f154
branches:  netbsd-3
changeset: 575378:88febd78f154
user:      tron <tron%NetBSD.org@localhost>
date:      Fri Apr 15 22:09:10 2005 +0000

description:
Pull up revision 1.20 (requested by drochner in ticket #156):
document the "security" command

diffstat:

 sbin/atactl/atactl.8 |  29 +++++++++++++++++++++++++++--
 1 files changed, 27 insertions(+), 2 deletions(-)

diffs (50 lines):

diff -r a27ca266c469 -r 88febd78f154 sbin/atactl/atactl.8
--- a/sbin/atactl/atactl.8      Fri Apr 15 22:07:53 2005 +0000
+++ b/sbin/atactl/atactl.8      Fri Apr 15 22:09:10 2005 +0000
@@ -1,4 +1,4 @@
-.\"    $NetBSD: atactl.8,v 1.19 2004/10/10 09:45:10 wiz Exp $
+.\"    $NetBSD: atactl.8,v 1.19.2.1 2005/04/15 22:09:10 tron Exp $
 .\"
 .\" Copyright (c) 1998 The NetBSD Foundation, Inc.
 .\" All rights reserved.
@@ -34,7 +34,7 @@
 .\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
 .\" POSSIBILITY OF SUCH DAMAGE.
 .\"
-.Dd October 10, 2004
+.Dd April 12, 2005
 .Dt ATACTL 8
 .Os
 .Sh NAME
@@ -174,6 +174,31 @@
 .Ar selftest-log
 .Pp
 Prints the self-test log.
+.Pp
+.Cm security
+.Ar [freeze | status]
+.Pp
+Controls
+.Dq security
+(password protection) features of modern ATA drives.
+The security commands are intended to be issued by low-level
+software (firmware / BIOS) only.
+Generally, the security status should be
+.Dq frozen
+before the operating system is started so that misbehaving or malicious
+software cannot set or change a password.
+Older and buggy BIOSes neglect to do so; in these cases it might make
+sense to issue the
+.Dq freeze
+command early in the boot process.
+.Pp
+.Ar freeze
+.Pp
+freezes the drive's security status
+.Pp
+.Ar status
+.Pp
+displays the drive's security status
 .Sh BUS COMMANDS
 The following commands may be used on IDE and ATA busses.
 Note that not all devices support all commands.