MPATH_PERSISTENT_RESERVE_OUT

Section: C Library Functions (3)
Updated: 2016-11-01
Page Index

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 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.

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_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.

AUTHORS

multipath-tools was developed by Christophe Varoqui <christophe.varoqui@opensvc.com> and others.