cdi_space(8)                                                         cdi_space(8)

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:

              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 ALSO

       libcdi(8)

NetWorker 7.6.2			 Jul 14, 11 			 cdi_space(8)