1MPATH_PERSISTENT_RESERVE_OUTL(i3b)rary Functions ManMuPaAlTH_PERSISTENT_RESERVE_OUT(3)
2
3
4

NAME

6       mpath_persistent_reserve_out - send PROUT command to DM device
7

SYNOPSIS

9       #include <mpath_persist.h>
10
11       int   mpath_persistent_reserve_out(int   fd,   int  rq_servact,  struct
12       prin_resp *resp, int noisy, int verbose)
13

DESCRIPTION

15       The function in the mpath_persistent_reserve_out () sends PROUT command
16       to the DM device and gets the response.
17
18       Parameters:
19
20              fd          The  file  descriptor  of  a multipath device. Input
21                          argument.
22
23              rq_servact  PROUT command service action. Input argument.
24
25              rq_scope    Persistent reservation scope. The  value  should  be
26                          always LU_SCOPE (0h).
27
28              rq_type     Persistent  reservation  type.  The  valid values of
29                          persistent reservation types are:
30
31                                 5h (Write exclusive - registrants only).
32
33                                 6h (Exclusive access - registrants only).
34
35                                 7h (Write exclusive - All registrants).
36
37                                 8h (Exclusive access - All registrants).
38
39              paramp      PROUT command parameter data. The paramp is a struct
40                          which  describes PROUT parameter list. Caller should
41                          manage the memory allocation of this structure.
42
43              noisy       Turn on debugging trace: Input argument. 0->Disable,
44                          1->Enable.
45
46              verbose     Set  verbosity level. Input argument. value: 0 to 3.
47                          0->Crits and Errors, 1->Warnings, 2->Info, 3->Debug.
48

RETURNS

50       MPATH_PR_SUCCESS
51                   If PR command successful else returns any one of the status
52                   mentioned below.
53
54       MPATH_PR_SYNTAX_ERROR
55                   If syntax error or invalid parameter.
56
57       MPATH_PR_SENSE_NOT_READY
58                   If command fails with [sk,asc,ascq: 0x2,*,*].
59
60       MPATH_PR_SENSE_MEDIUM_ERROR
61                   If command fails with [sk,asc,ascq: 0x3,*,*].
62
63       MPATH_PR_SENSE_HARDWARE_ERROR
64                   If command fails with [sk,asc,ascq: 0x4,*,*].
65
66       MPATH_PR_SENSE_INVALID_OP
67                   If command fails with [sk,asc,ascq: 0x5,0x20,0x0].
68
69       MPATH_PR_ILLEGAL_REQ
70                   If command fails with [sk,asc,ascq: 0x5,*,*].
71
72       MPATH_PR_SENSE_UNIT_ATTENTION
73                   If command fails with [sk,asc,ascq: 0x6,*,*].
74
75       MPATH_PR_SENSE_ABORTED_COMMAND
76                   If command fails with [sk,asc,ascq: 0xb,*,*].
77
78       MPATH_PR_NO_SENSE
79                   If command fails with [sk,asc,ascq: 0x0,*,*].
80
81       MPATH_PR_SENSE_MALFORMED
82                   If command fails with SCSI command malformed.
83
84       MPATH_PR_FILE_ERROR
85                   If  command  fails while accessing file (device node) prob‐
86                   lems(e.g. not found).
87
88       MPATH_PR_DMMP_ERROR
89                   If Device Mapper related error.(e.g  Error  in  getting  dm
90                   info).
91
92       MPATH_PR_OTHER
93                   If other error/warning has occurred(e.g transport or driver
94                   error).
95
96       MPATH_PR_RESERV_CONFLICT
97                   If command fails with reservation conflict.
98

SEE ALSO

100       mpathpersist(8).
101

AUTHORS

103       multipath-tools was developed by Christophe  Varoqui  <christophe.varo‐
104       qui@opensvc.com> and others.
105
106
107
108Linux                             2016-11-01   MPATH_PERSISTENT_RESERVE_OUT(3)
Impressum