Content-type: text/html
Man page of cdi_reserve
cdi_reserve
Section: Maintenance Commands (8)
Updated: Dec 11, 01m
Index
Return to Main Contents
NAME
cdi_reserve
- issue a SCSI reservation command to a tape device
SYNOPSIS
- cdi_reserve
-
-f
device
[
-T
{ s | p }
]
[
-k
persistent reserve key
]
[
-v
] [
-t
{ s | t | g | n | m | i }
]
DESCRIPTION
The
cdi_reserve
program issues a SCSI reservation command to a tape device. This will either be a "simple"
SCSI reserve (default or
-T s
) or a persisitent reservation if you specify
-T p.
If you specify
Persistent
, you may also specify a persistent reservation 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. This utility will always use the "exclusive access" type of persistent reservation.
The
cdi_reserve
program also returns the status of the named SCSI device (specified by the
-f
option).
OPERANDS
- -f
-
device
-
Specifies the device to send the reserve request to.
- -T
-
type
Specifies the type of the reservation command that you wish to issue. use 's' or 'S' for simple reserve, or 'p' or 'P' for persistent reserve. 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. A persistent reservation command 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 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 reserve 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 (1m)
manpage for the complete list of access methods currently
supported by the
cdi_reserve
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_RESERVE 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_RESERVE 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(1m),
cdi_release(1m),
cdi_pr(1m)
Index
- NAME
-
- SYNOPSIS
-
- DESCRIPTION
-
- OPERANDS
-
- OPTIONS
-
- EXAMPLES
-
- SEE ALSO
-
This document was created by
man2html,
using the manual pages.
Time: 02:37:03 GMT, October 02, 2010