NAME
sg_reset - sends SCSI device, target, bus or host reset; or checks
reset state
SYNOPSIS
sg_reset [-b] [-d] [-h] [-t] [-V] DEVICE
DESCRIPTION
The sg_reset utility with no options (just a DEVICE) reports on the
reset state (e.g. if a reset is underway) of DEVICE. When given a -d,
-t, -b or -h option it requests a device, target, bus or host reset
respectively.
The ability to reset a SCSI target (often called a "hard reset" at the
transport level) was added in linux kernel 2.6.27 . Low level drivers
that support target reset hopefully reset a logical unit only when
given the device reset (i.e. -d) option. This should removed the
ambiguity of whether "device" meant LU or target that we have had in
the past.
In the linux kernel 2.6 series this utility can be called on sd, sr
(cd/dvd), st or sg device nodes; if the user has appropriate
permissions.
In the linux kernel 2.4 series support for this utility first appeared
in lk 2.4.19 and could only be called on sg device nodes. Various
vendors made this capability available in their kernels prior to lk
2.4.19.
OPTIONS
-b attempt a SCSI bus reset. This would normally be tried if the
device reset (i.e. option -d) was not successful.
-d attempt a SCSI device reset. If the device seems stuck, this is
the first reset that should be tried. This assumes the linux
scsi mid level error handler is not already in the process of
resetting DEVICE.
-h attempt a host adapter reset. This would normally be tried if
both device reset (i.e. option -d) and bus reset (i.e. option
-b) were not successful.
-t attempt a SCSI target reset. This assumes the linux scsi mid
level error handler is not already in the process of resetting
the target that contains the given DEVICE.
-V prints the version string then exits.
NOTES
The error recovery code within the linux kernel when faced with a SCSI
command timing out and no response from the device (LU), first tries a
device reset and if that is not successful tries a target reset. If
that is not successful it tries a bus reset. If that is not successful
it tries a host reset. Users of this utility should check whether such
a recovery is already underway before trying to reset with this
utility. The "device,target,bus,host" order is also recommended (i.e.
first start with the smallest hammer). The above is a generalization
and exact details will vary depending on the transport and the low
level driver concerned.
SAM-4 defines a hard reset, a logical unit reset and a I_T nexus reset.
A hard reset is defined to be a power on condition, a microcode change
or a transport reset event. A LU reset and an I_T nexus reset can be
requested via task management function (and support for LU reset is
mandatory). In Linux the SCSI subsystem leaves it up to the low level
drivers as to whether a "device reset" is only for the addressed LU or
all the LUs in the device that contains the addressed LU (i.e. a target
reset). The additional of the target reset (i.e. option -t) should give
more control in this area. The "bus reset" is a transport reset and
may be a dummy operation, depending on the transport. A "host reset"
attempts to re-initialize the HBA that the request passes through en
route to the DEVICE. Note that a "host reset" and a "bus reset" may
cause collateral damage.
This utility does not allow individual SCSI commands (or tasks as they
are called in SAM-4) to be aborted. SAM-4 defines ABORT TASK and ABORT
TASK SET task management functions for that.
Prior to SAM-3 there was a TARGET RESET task management function.
Several transports still support that function and many associated
linux low level drivers map the -t option to it.
AUTHORS
Written by Douglas Gilbert.
COPYRIGHT
Copyright © 1999-2009 Douglas Gilbert
This software is distributed under the GPL version 2. There is NO
warranty; not even for MERCHANTABILITY or FITNESS FOR A PARTICULAR
PURPOSE.