MPATH_PERSISTENT_RESERVE_OUT(3)MPATH_PERSISTENT_RESERVE_OUT(3)NAME
mpath_persistent_reserve_out
SYNOPSIS
#include <mpath_persist.h>
int mpath_persistent_reserve_out (int fd, int rq_servact, struct
prin_resp *resp, int noisy, int verbose)
DESCRIPTION
The function in the mpath_persistent_reserve_out() sends PR OUT 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 alloca‐
tion 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
RETURNS
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_RESERV_CONFLICT if command fails with reservation conflict
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 get‐
ting dm info)
MPATH_PR_OTHER if other error/warning has occurred(e.g transport or
driver error)
SEE ALSO
mpath_persistent_reserve_in mpathpersist /usr/share/doc/mpath‐
persist/README
Linux Manpage 2011-04-08 MPATH_PERSISTENT_RESERVE_OUT(3)