cdi_locate(8)                                                             cdi_locate(8)

NAME

       cdi_locate - position to a given block on a tape mounted on a tape device

SYNOPSIS

       cdi_locate -f device -n block [ -a ] [ -v ] [ -t { s | t | g | n | m  |
                  i } ]

DESCRIPTION

       The  cdi_locate program positions to a given block on a tape mounted on
       a tape device.

OPERANDS

       -f     device
            Specifies the device to position to.

       -n     block
            Specify the block on a mounted tape to position to.

OPTIONS

       -a     Use asynchronous I/O for the operation.   Rather  than  blocking
              till  completion,  the  program  will  return  immediately.  The
              default is synchronous I/O.

       -t     Use the -t option to specify the method of tape functions to use
              to  position  to a given block on tape.  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 complete list of access methods currently supported by the
              cdi_locate 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_locate:

     % cdi_locate -f /dev/rmt/2cbn -n 300

     CDI_GET_STATUS returns:
      locate successful:  position to block 300 took 0 seconds
       cdi_info.drivestat is:
         status = 0, DRIVE_STATUS_READY
         msg = The tape drive is ready for use

SEE ALSO

       libcdi(8)

NetWorker 8.0.1			 Dec 02, 12			 cdi_locate(8)