cdi_release(8)                                                         cdi_release(8)

NAME

       cdi_release - issue SCSI release command to a tape device

SYNOPSIS

          cdi_release -f device [ -T{ s | p } ] [ -k persistent reserve key ] 
         [ -v ] [ -t{ s | t | g | n | m | i } ]
      

DESCRIPTION

 	The cdi_release program issues a SCSI release command to a tape device.
	This will either be a "simple" SCSI release (default or -T s ) or a
	persistent reservation release if you specify -T p.

	If you specify Persistent , you may also specify a persistent reserva-
	tion key. This key is used to identify the host you are running on to
	the tape drive, and may be an 8 character text string (e.g. NetWorkr )
	or a text representation of a 64-bit hex number (e.g.
	0x123456789abcdef0 ). The default reservation key is NetWorkr. The
	key used (whether specified on the command line or the default) must
	match the key that was used to create the reservation. You can see any
	keys and persistent reservations for a particular drive using the
	cdi_pr utility. This utility will always use the "exclusive access"
	type of persistent reservation.

	The cdi_release program also returns the status of the named SCSI
	device (specified by the -f option).

OPERANDS

       -f     device
              Specifies the device to send the release request to.
              
      -T     type
	      Specifies the type of the	 release  command  that	 you  wish  to
	      issue.   Use  's'	 or  'S' for simple reserve, or 'p' or 'P' for
	      persistent reservation release.  The default is simple if you do
	      not supply this operand.

      -k     persistent reserve key
	      Specifies	 the  key to use for a persistent reservation release.
	      A persistent reservation key is a 64-bit value.  This can hold 8
	      text  characters or a 64-bit number.  You can specify either for
	      this parameter.  If the key entered starts with 0x (zero x) then
	      it  is  assumed  to  be  a  64-bit  number, otherwise it will be
	      treated as an 8 character text string.  The default value if  no
	      key is specified is NetWorkr.
            

OPTIONS

        -t     Use the -t option to specify the method of tape functions to use
	      to issue the release SCSI command.  If  the  -t  option  is  not
	      specified,  the default method is to use the OS tape driver SCSI
	      passthrough functions.  Refer to the libcdi(8) man page for the
	      complete	list  of  access  methods  currently  supported by the
	      cdi_release 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_RELEASE successful.
	   cdi_info.drivestat is:
	    status = 0, DRIVE_STATUS_READY
	    msg = The tape drive is ready for use


	If the drive is reserved by another host, you should see something like
	this:

	CDI_RELEASE failed.
	   cdi_info.status = CDI_RESERVATION_ERROR (c)
	   cdi_info.drivestat is:
	    status = 0, DEVICE_STATUS_READY
	    msg = The tape drive is ready for use

SEE ALSO

       libcdi(8), cdi_reserve(8), cdi_pr(8)

NetWorker 7.6.2			 Jul 14, 11		        cdi_release(8)