mpath_persistent_reserve_out(3) - man - phpMan

MPATH_PERSISTENT_RESERVE_OUT(3)       Library Functions Manual       MPATH_PERSISTENT_RESERVE_OUT(3)



NAME
       mpath_persistent_reserve_out - send PROUT command to DM device

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 struc‐
                          ture.

              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.

SEE ALSO
       mpathpersist(8).

AUTHORS
       multipath-tools was developed by Christophe Varoqui <christophe.varoqui AT opensvc.com> and oth‐
       ers.



Linux                                        2016-11-01              MPATH_PERSISTENT_RESERVE_OUT(3)