diff options
author | ru <ru@FreeBSD.org> | 2003-06-28 23:53:39 +0000 |
---|---|---|
committer | ru <ru@FreeBSD.org> | 2003-06-28 23:53:39 +0000 |
commit | 348e423dd913fabaea56f15eecca3d155723ee08 (patch) | |
tree | 119cebb3a669617b213ec04fe871163ae082cfb1 /share/man/man4/pass.4 | |
parent | e4f0eb6b17525e227a1bc1d660ab253005530425 (diff) | |
download | FreeBSD-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.4 | 22 |
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. |