CDI_SPACE(8)CDI_SPACE(8)NAMEcdi_space - provides a variety of tape positioning functions.
SYNOPSIScdi_space-f device -T { b | f | sf | eod | sm | ssm } -n count [ -v ]
[ -t {s | t | g | n | m | i} ]
DESCRIPTION
The cdi_space program provides a variety of tape positioning operations
to the user. The cdi_space program accepts block, filemark, setmark as
valid tape positioning units. The cdi_space program also returns the
status of the named SCSI device (specified by the -f option).
OPERANDS-f device
Specifies the device to perform the tape positioning operation on.
-n count
The unit count for the space SCSI command. If a count of 0 is
specified, there will be no change in the tape position. If the
count value is greater than 0, the tape positioning will be in the
forward direction. A negative value for the count flag will cause
the tape positioning to move backwards. This flag and its value
are ignored if the tape positioning unit type is eod (end-of-
data).
OPTIONS-T { b | f | sf | eod | sm | ssm }
Specify the type of space positioning unit to use. Valid types
of units are:
SYMBOL UNIT TYPE
b block
f filemark
sf sequential filemark
eod end-of-data
sm setmark
ssm sequential setmark
The default type is block.
-t Use the -t option to specify the method of tape functions to use
to issue the space SCSI command. If the -t option is not speciā
fied, 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_space 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_space-f /dev/rmt/2cbn -T b -n 2
CDI_SPACE 2 successful.
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_SPACE(8)