Content-type: text/html Man page of CDI_SPACE

CDI_SPACE

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

NAME

cdi_space - provides a variety of tape positioning functions.  

SYNOPSIS

cdi_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:



SYMBOLUNIT TYPE

bblock

ffilemark

sfsequential filemark

eodend-of-data

smsetmark

ssmsequential 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 specified, the default method is to use the OS tape driver SCSI passthrough functions. Please refer to the libcdi (1m) 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 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:11 GMT, October 02, 2010