cdi_release man page on DigitalUNIX

Man page or keyword search:  
man Server   12896 pages
apropos Keyword Search (all sections)
Output format
DigitalUNIX logo
[printable version]


cdi_release(8)							cdi_release(8)

NAME
       cdi_release - issue a 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 you	 wish  to  use
		   for	a persistent reservation release.  A persistent reser‐
		   vation key is a 64-bit value.  This can hold 8 text charac‐
		   ters	 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,	other‐
		   wise it will be treated as an 8 character text string.  The
		   default value if you do not specify a key 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.	Please refer to the libcdi (8) manpage
	      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.3.2			  Aug 23, 06			cdi_release(8)
[top]

List of man pages available for DigitalUNIX

Copyright (c) for man pages and the logo by the respective OS vendor.

For those who want to learn more, the polarhome community provides shell access and support.

[legal] [privacy] [GNU] [policy] [cookies] [netiquette] [sponsors] [FAQ]
Tweet
Polarhome, production since 1999.
Member of Polarhome portal.
Based on Fawad Halim's script.
....................................................................
Vote for polarhome
Free Shell Accounts :: the biggest list on the net