cdi_filemark(8)                                                     cdi_filemark(8)

NAME

       cdi_filemark - issue a write filemark/setmark command to a tape device

SYNOPSIS

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

DESCRIPTION

       The cdi_filemark program issues a write filemark/setmark  SCSI  command
       to a given device.  The cdi_filemark program also returns the status of
       the named SCSI device (specified by the -f option).  The default behav-
       ior is to write a single filemark to the specified device.

OPERANDS

       -f     device
            Specifies the device to send the write filemark SCSI command 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.

       -n     count
            The  filemark  count  for  the  write  filemark SCSI command.  The
            default count is 1.

       -s     Write a setmark instead of a filemark for the operation.

       -t     Use the -t option to specify the method of tape functions to use
              for  the  write  filemark 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 (1) manpage
              for the complete list of access methods currently  supported  by
              the cdi_filemark 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_filemark -f /dev/rmt/2cbn -n 2 -v

      CDI_GET_VERSION returns 1
       CDI_WRITE_FILEMARKS 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_filemark(8)