[src/trunk]: src/share/man/man9 Add a note about scsipi_channel_thaw() and co...

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

details:   https://anonhg.NetBSD.org/src/rev/691433cd0363
branches:  trunk
changeset: 510239:691433cd0363
user:      bouyer <bouyer%NetBSD.org@localhost>
date:      Wed May 23 15:56:48 2001 +0000

description:
Add a note about scsipi_channel_thaw() and command ordering.

diffstat:

 share/man/man9/scsipi.9 |  9 +++++++--
 1 files changed, 7 insertions(+), 2 deletions(-)

diffs (23 lines):

diff -r 3af4cf2833d5 -r 691433cd0363 share/man/man9/scsipi.9
--- a/share/man/man9/scsipi.9   Wed May 23 15:51:32 2001 +0000
+++ b/share/man/man9/scsipi.9   Wed May 23 15:56:48 2001 +0000
@@ -1,4 +1,4 @@
-.\"    $NetBSD: scsipi.9,v 1.1 2001/05/11 08:51:15 bouyer Exp $
+.\"    $NetBSD: scsipi.9,v 1.2 2001/05/23 15:56:48 bouyer Exp $
 .\"
 .\"
 .\" Copyright (c) 2001 Manuel Bouyer.
@@ -511,7 +511,12 @@
 .It Fn scsipi_channel_thaw "struct scsipi_channel *chan" "int count"
 Decrement the channel's freeze counter by
 .Fa count
-and process the queue if the counter goes to 0.
+and process the queue if the counter goes to 0. In order to preserve command
+ordering, HBA drivers should not call
+.Fn scsipi_channel_thaw
+before calling
+.Fn scsipi_done
+for all commands in the HBA's queue which need to be requeued.
 .It Fn scsipi_periph_timed_thaw "void *arg"
 Call
 .Fn scsipi_channel_thaw "arg" "1" .