diff options
author | Aaron Campbell <aaron@cvs.openbsd.org> | 2000-03-18 22:56:07 +0000 |
---|---|---|
committer | Aaron Campbell <aaron@cvs.openbsd.org> | 2000-03-18 22:56:07 +0000 |
commit | 16b21db4d33ff08e914df52000c560f64ef0e39d (patch) | |
tree | a11f2d1036bb85a2c46891708f459ae9eedcd2af /sbin/scsi/scsi.8 | |
parent | 404d4678be49dbab2ac44d8d6ae087f87036f9d6 (diff) |
Remove hard sentence breaks, and some other cleanup along the way.
Diffstat (limited to 'sbin/scsi/scsi.8')
-rw-r--r-- | sbin/scsi/scsi.8 | 55 |
1 files changed, 33 insertions, 22 deletions
diff --git a/sbin/scsi/scsi.8 b/sbin/scsi/scsi.8 index ec69ec500a7..feaad0e3b99 100644 --- a/sbin/scsi/scsi.8 +++ b/sbin/scsi/scsi.8 @@ -1,4 +1,4 @@ -.\" $OpenBSD: scsi.8,v 1.15 2000/03/05 00:28:50 aaron Exp $ +.\" $OpenBSD: scsi.8,v 1.16 2000/03/18 22:56:04 aaron Exp $ .\" $FreeBSD: scsi.8,v 1.5 1995/05/05 20:41:58 dufault Exp $ .\" .\" Written By Julian ELischer @@ -82,8 +82,8 @@ .Sh DESCRIPTION The .Nm -program is used to send commands to a SCSI device. It is also -a sample usage of the user-level SCSI commands. +program is used to send commands to a SCSI device. +It is also a sample usage of the user-level SCSI commands. .Ar out_fmt can be .Ql - @@ -101,15 +101,18 @@ Specifies the that should be opened, i.e., .Pa /dev/rsd0c . .It Fl d Ar debug_level -Sets the SCSI kernel debug level. The kernel must have been compiled -with the SCSIDEBUG -option. See +Sets the SCSI kernel debug level. +The kernel must have been compiled with the +.Cm SCSIDEBUG +option. +See .Pa /sys/scsi/scsi_debug.h to figure out what to set the kernel debug level to. .Pp .It Fl z Ar seconds Freezes all activity on all SCSI busses for a given number of -seconds. If +seconds. +If .Fl v is also specified, a BEL character is sent to the standard output at the start and finish of the bus freeze. @@ -117,16 +120,17 @@ This requires that the kernel be built with the SCSI_FREEZE kernel option. This kernel code is not committed yet. .Pp .It Fl m Ar page -Read a device mode page. The file +Read a device mode page. +The file .Pa /usr/share/misc/scsi_modes -is read to discover how to interpret the mode data. The environment -variable +is read to discover how to interpret the mode data. +The environment variable .Ev SCSI_MODES can specify a different file to use. .Pp .It Fl P Ar pc -Specify a page control field. The page control -fields are +Specify a page control field. +The page control fields are .Bd -literal -offset 0 Current Values 1 Changeable Values @@ -135,11 +139,11 @@ fields are .Ed .Pp .It Fl e -Permits you to edit the fields. It will use the editor specified -by your +Permits you to edit the fields. +It will use the editor specified by your .Ev EDITOR -environment variable. To store changes permanently, -edit page control 3 using the +environment variable. +To store changes permanently, edit page control 3 using the .Fl P flag. .Pp @@ -173,8 +177,11 @@ for a description of fixed SCSI devices. .It Fl c Permits you to send user-level SCSI commands specified on the command line to a -device. The command is sent using the SCIOCCOMMAND ioctl, so the -device you are accessing must permit this ioctl. See +device. +The command is sent using the +.Dv SCIOCCOMMAND +ioctl, so the device you are accessing must permit this ioctl. +See .Xr scsi 4 for full details of which minor devices permit the ioctl, and .Xr scsi 3 @@ -199,7 +206,8 @@ specified in the command format. Indicates that this is a data out command (i.e., data will be sent from the system to the device) with .Ar count -bytes of data. The data out is built up using the facilities described in +bytes of data. +The data out is built up using the facilities described in .Xr scsi 3 using the provided arguments to fill in any integer variables. .Ar out_fmt @@ -213,7 +221,8 @@ bytes of data should be read from the standard input. Indicates that this is a data in command (i.e., data will be read from the device into the system) with .Ar count -bytes of data read in. The information is extracted according to +bytes of data read in. +The information is extracted according to .Ar in_fmt using the facilities described in .Xr scsi 3 @@ -252,7 +261,8 @@ output to that file. The .Ev SU_DEBUG_LEVEL variable can be set to a non-zero integer to increase -the level of debugging. Currently this is a on or off thing; it should +the level of debugging. +Currently this is a on or off thing; it should perhaps use the ioctl to set the debug level in the kernel and then set it back to zero at program exit. .Pp @@ -268,7 +278,8 @@ variable determines the editor to use for the mode editor. .Xr scsi 3 , .Xr scsi 4 .Sh BUGS -Some devices respond to an inquiry for all LUNS. This will cause them +Some devices respond to an inquiry for all LUNS. +This will cause them to come on line to 8 times during reprobe to different logical units. "scsi -f /dev/rsd0c -c "4 0 0 0 0 0" permits anyone who can write to .Pa /dev/rsd0c |