CDI_LOAD_UNLOAD(8)CDI_LOAD_UNLOAD(8)NAMEcdi_load_unload - load or unload a tape device
SYNOPSIScdi_load_unload-f device { -l | -u } [ -a ] [ -e ] [ -r ] [ -v ] [ -t
{ s | t | g | n | m | i } ]
DESCRIPTION
The cdi_load_unload program loads or unloads medium into or from a tape
device.
OPERANDS-f device
Specifies the device to perform the load/unload operation on.
{ -l | -u }
Perform a load (-l) or unload (-u) medium operation.
OPTIONS-a Use asynchronous I/O for the operation. Rather than blocking
till completion, the program will return immediately. If this
flag is set and CHECK CONDITION status is returned for the
load/unload operation, the load or unload operation will not be
performed. The default is synchronous I/O.
-e Position to end-of-medium before unloading the medium. If this
flag is specified with the -l flag (i.e., load medium), the SCSI
device will return CHECK CONDITION status and the sense key will
be set to ILLEGAL REQUEST in the sense data.
-r Apply the correct tension to the medium. Not all devices have
the capability to re-tension media. Please refer to the spe‐
cific device manuals to confirm whether the re-tension function
is available for the device.
-t Use the -t option to specify the method of tape functions to use
to load/unload medium. 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 a com‐
plete list of access methods currently supported by the
cdi_load_unload 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 from cdi_load_unload:
% cdi_load_unload-l -f /dev/rmt/2cbn
cdi load unload succeeds for via /dev/rmt/2cbn:
elapsed time for command was 0 seconds
cdi_info.drivestat is:
status = 0, DRIVE_STATUS_READY
msg = The tape drive is ready for use
SEE ALSOlibcdi(8)NetWorker 7.3.2 Aug 23, 06 CDI_LOAD_UNLOAD(8)