MPATH_PERS...ESERVE_OUT(3)

💫 NAME 💫

okay so bestie, this is the mpath_persistent_reserve_out(3) page from the Library Functions Manual, and it is literally here to send a PROUT command to a DM device. Main character energy fr fr.

✨ SYNOPSIS ✨

#include <mpath_persist.h>

int mpath_persistent_reserve_out(int fd, int rq_servact, int rq_scope,
unsigned int rq_type, struct prout_param_descriptor *paramp, int noisy,
int verbose)

💖 DESCRIPTION 💖

mpath_persistent_reserve_out() sends a PROUT command to the DM device and gets the response back. slay.

Parameters, bestie:

• 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. paramp is a struct which describes the PROUT parameter list. Caller should manage the memory allocation of this structure, no cap.
• noisy — turn on debugging trace: input argument. 0->Disable, 1->Enable.
• verbose — set verbosity level. Input argument. value: 0 to 3. 0->Errors, 1->Warnings, 2->Info, 3->Debug.

👑 RETURNS 👑

• MPATH_PR_SUCCESS — if PR command successful; otherwise it 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@opensvc.com> and others.

---

okay that's literally the whole page — signing off from the Linux source, date 2026-02-02, manual MPATH_PERS...ESERVE_OUT(3). bye bestie, go slay those reservations 💅✨