cdi_release(8)cdi_release(8)NAMEcdi_release - issue a SCSI release command to a tape device
SYNOPSIScdi_release-f device [ -T { s | p } ] [ -k persistent reserve key ] [
-v ] [ -t { s | t | g | n | m | i } ]
DESCRIPTION
The cdi_release program issues a SCSI release command to a tape device.
This will either be a "simple" SCSI release (default or -T s ) or a
persistent reservation release if you specify -T p.
If you specify Persistent , you may also specify a persistent reserva‐
tion key. This key is used to identify the host you are running on to
the tape drive, and may be an 8 character text string (e.g. NetWorkr )
or a text representation of a 64-bit hex number (e.g.
0x123456789abcdef0 ). The default reservation key is NetWorkr.
The key used (whether specified on the command line or the default)
must match the key that was used to create the reservation. You can
see any keys and persistent reservations for a particular drive using
the cdi_pr utility. This utility will always use the "exclusive
access" type of persistent reservation.
The cdi_release program also returns the status of the named SCSI
device (specified by the -f option).
OPERANDS-f device
Specifies the device to send the release request to.
-T type Specifies the type of the release command that you
wish to issue. use 's' or 'S' for simple reserve, or 'p'
or 'P' for persistent reservation release. The default is
simple if you do not supply this operand.
-k persistent reserve key Specifies the key you wish to use
for a persistent reservation release. A persistent reser‐
vation key is a 64-bit value. This can hold 8 text charac‐
ters or a 64-bit number. You can specify either for this
parameter. If the key entered starts with 0x
(zero x) then it is assumed to be a 64-bit number, other‐
wise it will be treated as an 8 character text string. The
default value if you do not specify a key is NetWorkr.
OPTIONS-t Use the -t option to specify the method of tape functions to use
to issue the release SCSI command. If the -t option is not
specified, the default method is to use the OS tape driver SCSI
passthrough functions. Please refer to the libcdi (8) manpage
for the complete list of access methods currently supported by
the cdi_release program.
-v Run the program in verbose mode. This option will print out the
version number of the CDI library used by the program.
EXAMPLES
Sample output including drive status information:
CDI_RELEASE successful.
cdi_info.drivestat is:
status = 0, DRIVE_STATUS_READY
msg = The tape drive is ready for use
If the drive is reserved by another host, you should see something like this:
CDI_RELEASE failed.
cdi_info.status = CDI_RESERVATION_ERROR (c)
cdi_info.drivestat is:
status = 0, DEVICE_STATUS_READY
msg = The tape drive is ready for use
SEE ALSOlibcdi(8), cdi_reserve(8), cdi_pr(8)NetWorker 7.3.2 Aug 23, 06 cdi_release(8)