SCSICTL(8) | System Manager's Manual | SCSICTL(8) |
scsictl
—
manipulate SCSI devices and busses
scsictl |
device command [arg ...] |
scsictl
allows a user or system
administrator to issue commands to and otherwise control SCSI devices and
busses. It is used by specifying a device or bus to manipulate, the command
to perform, and any arguments the command may require.
scsictl
determines if the specified device is an
actual device or a SCSI bus automatically, and selects the appropriate
command set.
For commands which scsictl
issues a SCSI
command to the device directly, any returned sense information will be
decoded by scsictl
and displayed to the standard
output.
The following commands are supported for SCSI devices:
debug
levelThis option is only supported with kernels compiled with
SCSIPI_DEBUG
.
defects
[primary] [grown]
[block
|byte
|physical
]format
[blocksize [immediate
]]blocksize
parameter is provided, the device
geometry will be modified to use the specified
blocksize
. If this parameter is different form the
Current or Default Mode Page 3 parameters, the device will update Mode
Page 3 at the successful completion of the Format. Device geometry may
change as a result of using a new device
blocksize
. When the optional
blocksize
parameter is specified, the Defect List
on the drive will revert to the original primary defect list created at
the time of manufacture if available. The drive will usually recertify
itself during the Format and add any other defective blocks to the new
Defect List. Some disks may not support the ability to change the
blocksize and may enter a Degraded Mode when fed a Format command of this
type. If this happens the standard recovery for the drive requires issuing
a correct Format command, i.e. one without the blocksize parameter.
When the immediate
parameter is also
specified, the disk is instructed to return from the format command
right away. It continues to format, and every ten seconds
scsictl
issues a TEST UNIT READY command to
check the associated sense data. This associated sense data has a
progress indicator which indicates how far the format is progressing.
Note well that most SCSI disk drives prior to a few years ago do not
support this option.
identify
[vpd]When the optional vpd
parameter is
added, Vital Product Data that identifies the device is also queried and
displayed.
reassign
blkno ...release
reserve
reset
SCIOCRESET
ioctl.start
stop
tur
getcache
setcache
file ...
none
|r
|w
|rw
[save]flushcache
setspeed
speedgetrealloc
setrealloc
file ...
none
|r
|w
|rw
[save]reportluns
file ...
normal
|wellknown
|all
|#The following commands are supported for SCSI busses:
reset
SCBUSIORESET
ioctl.scan
target lundetach
target lunscan
command, and may also be wildcarded.When scanning the SCSI bus, information about newly recognized devices is printed to console. No information is printed for already probed devices.
/dev/scsibus* - for commands operating on SCSI busses
ioctl(2), cd(4), ch(4), scsi(4), sd(4), se(4), ss(4), st(4), uk(4), atactl(8), dkctl(8)
The scsictl
command first appeared in
NetBSD 1.4.
The scsictl
command was written by
Jason R. Thorpe of the Numerical Aerospace
Simulation Facility, NASA Ames Research Center.
November 9, 2024 | NetBSD 10.99 |