Content-type: text/html Man page of CDI_LOAD_UNLOAD

CDI_LOAD_UNLOAD

Section: Maintenance Commands (8)
Updated: Dec 11, 01m
Index Return to Main Contents
 

NAME

cdi_load_unload - load or unload a tape device  

SYNOPSIS

cdi_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 specific 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 (1m) manpage for a complete 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 ALSO

libcdi(1m)


 

Index

NAME
SYNOPSIS
DESCRIPTION
OPERANDS
OPTIONS
EXAMPLES
SEE ALSO

This document was created by man2html, using the manual pages.
Time: 02:37:00 GMT, October 02, 2010