diff options
author | dg <dg@FreeBSD.org> | 1995-01-25 09:18:56 +0000 |
---|---|---|
committer | dg <dg@FreeBSD.org> | 1995-01-25 09:18:56 +0000 |
commit | 2871de848d7f8b3dcc6fbba6a080a04e86479e02 (patch) | |
tree | 3e44c2eda318f56905393229154d72bc013e0ed5 /share/man/man4/scsi.4 | |
parent | 2c76088f4621ddf401de9d8cecde525a86de9fbc (diff) | |
download | FreeBSD-src-2871de848d7f8b3dcc6fbba6a080a04e86479e02.zip FreeBSD-src-2871de848d7f8b3dcc6fbba6a080a04e86479e02.tar.gz |
Added more missing manual pages from 1.1.5.
Diffstat (limited to 'share/man/man4/scsi.4')
-rw-r--r-- | share/man/man4/scsi.4 | 117 |
1 files changed, 117 insertions, 0 deletions
diff --git a/share/man/man4/scsi.4 b/share/man/man4/scsi.4 new file mode 100644 index 0000000..b6d3995 --- /dev/null +++ b/share/man/man4/scsi.4 @@ -0,0 +1,117 @@ +.Dd August 27, 1993 +.Dt SD 4 +.Os FreeBSD +.Sh NAME +.Nm scsi +.Nd scsi system +.Sh SYNOPSIS +.Nm device-driver scbus +.Sh DESCRIPTION +The +.Em scsi +system provides a uniform and modular system for the implimentation +of drivers to control various scsi devices, and to utilise different +scsi adapters through adapter drivers. When the system probes the +.Em SCSI +busses, it attaches any devices it finds to the appropriate +drivers. If no driver seems appropriate, then at attaches the device to the +uk (unknown) driver (if configured), so that user level scsi ioctls may +still be performed against the device. +.Sh KERNEL CONFIGURATION +Continuously changing. check your nearest bsd mailing list. +The option SCSIDEBUG enables the debug ioctl. +.Sh IOCTLS +There are a number of ioctls that will (when the next stage is complete) +work on any +.Em SCSI +device. They are defined in +.Em sys/scsiio.h +and can be applied against any scsi device that allows both read and write, +though for devices such as tape, it must be applied against the control +device. See the manual page for each device type for more information about +how generic scsi ioctls may be applied to a specific device. +.Bl -tag -width DIOCSDINFO____ +.It Dv SCIOCRESET* +reset a device. +.It Dv SCIOCDEBUG +Turn on debugging.. All scsi operations originating from this device's driver +will be traced to the console, along with other information. Debugging is +controlled by four bits, described in the header file. If no debugging is +configured into the kernel, debugging will have no effect. +.Em SCSI +debugging is controlled by the configuration option +.Em SCSIDEBUG. +.It Dv SCIOCCOMMAND +Take a scsi command and data from a user process and apply them to the scsi +device. Return all status information and return data to the process. The +ioctl will return a successful status even if the device rejected the +command. As all status is returned to the user, it is up to the user +process to examine this information to decide the success of the command. +.It Dv SCIOCREPROBE +Ask the system to probe the scsi busses for any new devices. If it finds +any, they will be attached to the appropriate drivers. The search can be +narrowed to a specific bus, target or lun. The new device may or may not +be related to the device on which the ioctl was performed. +.It Dv SCIOCIDENTIFY +Ask the driver what it's bus, target and lun are. +.It Dv SCIOCDECONFIG +Ask the device to dissappear. This may not happen if the device is in use. +.El +.Sh NOTES +the generic scsi part of the system is still being mapped out. +Watch this space for changes. +.Pp + A device by the name of su (scsi_user) +(e.g su0-0-0) will map bus, target and lun to minor numbers. I have not +yet decided yet whether this device will be able to open a device that is +already controlled by an explicit driver. +.Sh ADAPTERS +The system allows common device drivers to work through many different +types of adapters. The adapters take requests from the upper layers and do +all IO between the +.Em SCSI +bus and the system. The maximum size of a transfer is governed by the +adapter. Most adapters can transfer 64KB in a single operation, however +many can transfer larger amounts. +.Sh TARGET MODE +Some adapters support +.Em Target mode +in which the system is capable of operating as a device, responding to +operations initioated by another system. Target mode will be supported for +some adapters, but is not yet complete for this version of the scsi system. +.Sh FILES +see other scsi device entries. +.Sh DIAGNOSTICS +When the kernel is compiled with option SCSIDEBUG, the SCIOCDEBUG ioctl +can be used to enable various amounts of tracing information on any +specific device. Devices not being traced will not produce trace information. +The four bits that make up the debug level, each control certain types +of debugging information. +.Bl -tag -width THIS_WIDE_PLEASE +.It Dv Bit 0 +Bit 0 shows all scsi bus operations including scsi commands, +error information and the first 48 bytes of any data transferred. +.It Dv Bit 1 +Bit 1 shows routines called. +.It Dv Bit 2 +Bit 2 shows information about what branches are taken and often some +of the return values of functions. +.It Dv Bit 3 +Bit 3 shows more detailed information including DMA scatter-gather logs. +.El +.Sh SEE ALSO +.Xr ch 4 +.Xr cd 4 +.Xr sd 4 +.Xr st 4 +.Xr uk 4 +.Xr su 4 +.Xr aha 4 +.Xr ahb 4 +.Xr bt 4 +.Xr uha 4 +.Sh HISTORY +This +.Nm +system appeared in MACH 2.5 at TRW. + |