[src/trunk]: src/share/man/man9 Document scsipi_thread_call_callback() and sc...

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

details:   https://anonhg.NetBSD.org/src/rev/82a2a15b4f78
branches:  trunk
changeset: 512890:82a2a15b4f78
user:      bouyer <bouyer%NetBSD.org@localhost>
date:      Wed Jul 18 20:35:36 2001 +0000

description:
Document scsipi_thread_call_callback() and scsipi_target_detach()

diffstat:

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

diffs (50 lines):

diff -r e27f54e6ba36 -r 82a2a15b4f78 share/man/man9/scsipi.9
--- a/share/man/man9/scsipi.9   Wed Jul 18 20:20:16 2001 +0000
+++ b/share/man/man9/scsipi.9   Wed Jul 18 20:35:36 2001 +0000
@@ -1,4 +1,4 @@
-.\"    $NetBSD: scsipi.9,v 1.3 2001/06/21 11:59:01 wiz Exp $
+.\"    $NetBSD: scsipi.9,v 1.4 2001/07/18 20:35:36 bouyer Exp $
 .\"
 .\"
 .\" Copyright (c) 2001 Manuel Bouyer.
@@ -58,6 +58,10 @@
 .Fn scsipi_done "struct scsipi_xfer *xs"
 .Ft void
 .Fn scsipi_printaddr "struct scsipi_periph *periph"
+.Ft int
+.Fn scsipi_target_detach "struct scsipi_channel *chan" "int target" "int lun" "int flags"
+.Ft int
+.Fn scsipi_thread_call_callback "struct scsipi_channel *chan" "void (*callback) __P((struct scsipi_channel *, void *))" "void *arg"
 .Sh DESCRIPTION
 The
 .Nm
@@ -527,6 +531,29 @@
 .It Fn scsipi_periph_thaw "struct scsipi_periph *periph"
 .It Fn scsipi_periph_timed_thaw "void *arg"
 Same as the channel counterparts, but only for one specific peripheral.
+.It Fn scsipi_target_detach "struct scsipi_channel *chan" "int target" "int lun" "int flags"
+detach the periph associated with this I_T_L nexus. Both 
+.Fa target
+and
+.Fa lun
+may be wildcarded using the magic value -1.
+.Fa flags
+is passed to
+.Fn config_detach ""
+\&.
+Returns 0 if successfull, or error code if a device couldn't be removed.
+.It Fn scsipi_thread_call_callback "struct scsipi_channel *chan" "void (*callback) __P((struct scsipi_channel *, void *))" "void *arg"
+.Fn callback
+will be called with
+.Fa chan
+and
+.Fa arg
+as arguments, from the channel completion thread. The callback is run at
+splbio.
+.Fn scsipi_thread_call_callback
+will freeze the channel by one, it's up to the caller to thaw it when
+appropriate. returns 0 if the callback was properly recorded, or EBUSY if the
+channel has already a callback pending.
 .El
 .Sh EXAMPLES
 The best examples are existing HBA drivers.  Most of them sit in the