mpath_persistent_reserve_out - send PROUT command to DM device
#include <mpath_persist.h>
int mpath_persistent_reserve_out(int fd, int rq_servact,
struct prin_resp *resp, int noisy, int verbose)
The function in the mpath_persistent_reserve_out () sends
PROUT command to the DM device and gets the response.
- Parameters:
- fd
- The file descriptor of a multipath device. Input argument.
- rq_servact
- PROUT command service action. Input argument.
- rq_scope
- Persistent reservation scope. The value should be always LU_SCOPE
(0h).
- rq_type
- Persistent reservation type. The valid values of persistent reservation
types are:
- 5h (Write exclusive - registrants only).
- 6h (Exclusive access - registrants only).
- 7h (Write exclusive - All registrants).
- 8h (Exclusive access - All registrants).
- paramp
- PROUT command parameter data. The paramp is a struct which describes PROUT
parameter list. Caller should manage the memory allocation of this
structure.
- noisy
- Turn on debugging trace: Input argument. 0->Disable, 1->Enable.
- verbose
- Set verbosity level. Input argument. value: 0 to 3. 0->Crits and
Errors, 1->Warnings, 2->Info, 3->Debug.
- MPATH_PR_SUCCESS
- If PR command successful else returns any one of the status mentioned
below.
- MPATH_PR_SYNTAX_ERROR
- If syntax error or invalid parameter.
- MPATH_PR_SENSE_NOT_READY
- If command fails with [sk,asc,ascq: 0x2,*,*].
- MPATH_PR_SENSE_MEDIUM_ERROR
- If command fails with [sk,asc,ascq: 0x3,*,*].
- MPATH_PR_SENSE_HARDWARE_ERROR
- If command fails with [sk,asc,ascq: 0x4,*,*].
- MPATH_PR_SENSE_INVALID_OP
- If command fails with [sk,asc,ascq: 0x5,0x20,0x0].
- MPATH_PR_ILLEGAL_REQ
- If command fails with [sk,asc,ascq: 0x5,*,*].
- MPATH_PR_SENSE_UNIT_ATTENTION
- If command fails with [sk,asc,ascq: 0x6,*,*].
- MPATH_PR_SENSE_ABORTED_COMMAND
- If command fails with [sk,asc,ascq: 0xb,*,*].
- MPATH_PR_NO_SENSE
- If command fails with [sk,asc,ascq: 0x0,*,*].
- MPATH_PR_SENSE_MALFORMED
- If command fails with SCSI command malformed.
- MPATH_PR_FILE_ERROR
- If command fails while accessing file (device node) problems(e.g. not
found).
- MPATH_PR_DMMP_ERROR
- If Device Mapper related error.(e.g Error in getting dm info).
- MPATH_PR_OTHER
- If other error/warning has occurred(e.g transport or driver error).
- MPATH_PR_RESERV_CONFLICT
- If command fails with reservation conflict.
multipath-tools was developed by Christophe Varoqui
<christophe.varoqui@opensvc.com> and others.