summaryrefslogtreecommitdiffstats
path: root/share/man/man4/pass.4
diff options
context:
space:
mode:
authorru <ru@FreeBSD.org>2003-06-28 23:53:39 +0000
committerru <ru@FreeBSD.org>2003-06-28 23:53:39 +0000
commit348e423dd913fabaea56f15eecca3d155723ee08 (patch)
tree119cebb3a669617b213ec04fe871163ae082cfb1 /share/man/man4/pass.4
parente4f0eb6b17525e227a1bc1d660ab253005530425 (diff)
downloadFreeBSD-src-348e423dd913fabaea56f15eecca3d155723ee08.zip
FreeBSD-src-348e423dd913fabaea56f15eecca3d155723ee08.tar.gz
Hiten's patchset for section four manpages, slightly edited by me.
Diffstat (limited to 'share/man/man4/pass.4')
-rw-r--r--share/man/man4/pass.422
1 files changed, 14 insertions, 8 deletions
diff --git a/share/man/man4/pass.4 b/share/man/man4/pass.4
index 41d06db..e3f8c01 100644
--- a/share/man/man4/pass.4
+++ b/share/man/man4/pass.4
@@ -44,7 +44,8 @@ kernel.
Since the
.Nm
driver allows direct access to the CAM subsystem, system administrators
-should exercise caution when granting access to this driver. If used
+should exercise caution when granting access to this driver.
+If used
improperly, this driver can allow userland applications to crash a machine
or cause data loss.
.Pp
@@ -69,21 +70,24 @@ devices are found.
.Bl -tag -width 012345678901234
.It CAMIOCOMMAND
This ioctl takes most kinds of CAM CCBs and passes them through to the CAM
-transport layer for action. Note that some CCB types are not allowed
+transport layer for action.
+Note that some CCB types are not allowed
through the passthrough device, and must be sent through the
.Xr xpt 4
-device instead. Some examples of xpt-only CCBs are XPT_SCAN_BUS,
+device instead.
+Some examples of xpt-only CCBs are XPT_SCAN_BUS,
XPT_DEV_MATCH, XPT_RESET_BUS, XPT_SCAN_LUN, XPT_ENG_INQ, and XPT_ENG_EXEC.
These CCB types have various attributes that make it illogical or
impossible to service them through the passthrough interface.
.It CAMGETPASSTHRU
This ioctl takes an XPT_GDEVLIST CCB, and returns the passthrough device
-corresponding to the device in question. Although this ioctl is available
-through the
+corresponding to the device in question.
+Although this ioctl is available through the
.Nm
driver, it is of limited use, since the caller must already know that
the device in question is a passthrough device if they're issuing this
-ioctl. It is probably more useful to issue this ioctl through the
+ioctl.
+It is probably more useful to issue this ioctl through the
.Xr xpt 4
device.
.El
@@ -92,7 +96,8 @@ device.
.It Pa /dev/pass Ns Ar n
Character device nodes for the
.Nm
-driver. There should be one of these for each device accessed through the
+driver.
+There should be one of these for each device accessed through the
CAM subsystem.
.El
.Sh DIAGNOSTICS
@@ -109,5 +114,6 @@ The CAM passthrough driver first appeared in
.An Kenneth Merry Aq ken@FreeBSD.org
.Sh BUGS
It might be nice to have a way to asynchronously send CCBs through the
-passthrough driver. This would probably require some sort of read/write
+passthrough driver.
+This would probably require some sort of read/write
interface or an asynchronous ioctl interface.
OpenPOWER on IntegriCloud