MPATH_PERSISTENT_RESERVE_IN(3)

💅 MPATH_PERSISTENT_RESERVE_IN(3)

okay so bestie, welcome to the Library Functions Manual entry for this absolute icon of a function 🫶 it lives in section 3 (that's the library-functions girlies) and it's the one that goes "hey DM device, gimme that PRIN response". no cap, let's get into it.

---

🌸 NAME 🌸

mpath_persistent_reserve_in — send a PRIN command to a DM device ✨

---

🎀 SYNOPSIS 🎀

#include <mpath_persist.h>

int mpath_persistent_reserve_in(int fd, int rq_servact, struct prin_resp
*resp, int noisy, int verbose)

literally just five little arguments, she's lowkey low-maintenance 💖

---

✨ DESCRIPTION ✨

so the function mpath_persistent_reserve_in() sends a PRIN command to the DM device and gets the response back. that's it, that's the vibe. it's giving "ask and you shall receive" 👑

Parameters (the whole friend group):

• fd — the file descriptor of a multipath device. this one's an input argument. 🧚
• rq_servact — the PRIN command service action. also an input argument. 💫
• resp — the response from the PRIN service action. heads up bestie: the caller has to manage the memory allocation of this structure. that's on you, not her. 🙈
• noisy — turn on the debugging trace. input argument. 0 → Disable, 1 → Enable. it's literally a switch, iykyk 🔥
• verbose — set the verbosity level. input argument. value range: [0-3]. 0 → Errors, 1 → Warnings, 2 → Info, 3 → Debug. pick your fighter 💀

---

🌈 RETURNS 🌈

okay this is the part where she tells you how it went. the way she has a whole range of moods:

• MPATH_PR_SUCCESS — if the PR command was successful. slay, no notes 💅
• MPATH_PR_SYNTAX_ERROR — if there's a syntax error or an invalid parameter. typo era 😭
• MPATH_PR_SENSE_NOT_READY — if the command fails with [sk,asc,ascq: 0x2,*,*].
• MPATH_PR_SENSE_MEDIUM_ERROR — if the command fails with [sk,asc,ascq: 0x3,*,*].
• MPATH_PR_SENSE_HARDWARE_ERROR — if the command fails with [sk,asc,ascq: 0x4,*,*].
• MPATH_PR_SENSE_INVALID_OP — if the command fails with [sk,asc,ascq: 0x5,0x20,0x0]. specific queen 🎯
• MPATH_PR_ILLEGAL_REQ — if the command fails with [sk,asc,ascq: 0x5,*,*].
• MPATH_PR_SENSE_UNIT_ATTENTION — if the command fails with [sk,asc,ascq: 0x6,*,*]. pay attention to her fr fr 👀
• MPATH_PR_SENSE_ABORTED_COMMAND — if the command fails with [sk,asc,ascq: 0xb,*,*].
• MPATH_PR_NO_SENSE — if the command fails with [sk,asc,ascq: 0x0,*,*].
• MPATH_PR_SENSE_MALFORMED — if the SCSI command is malformed. she's got opinions about your formatting 💀
• MPATH_PR_FILE_ERROR — if the command fails while accessing the file (device node) — problems like not found, you know the drill. 🍓
• MPATH_PR_DMMP_ERROR — if there's a Device Mapper related error (e.g. an error in getting dm info). device mapper said "not today" 😭
• MPATH_PR_OTHER — if some other error/warning has occurred (e.g. a transport or driver error). the catch-all bestie, the miscellaneous main character 🌟

ngl, if you're matching on this, keep every constant exactly as spelled above — they're case-sensitive and MPATH_PR_... does not appreciate freestyling 🙅‍♀️

---

⭐ SEE ALSO ⭐

mpathpersist(8) — go read it, she's the older sister and she knows things 💜

---

👑 AUTHORS 👑

multipath-tools was developed by Christophe Varoqui <christophe.varoqui@opensvc.com> and others. give credit where credit is due, periodt 🫶

---

and that's the page, bestie!! 🎀 this lovely little writeup comes to you from Linux, dated 2024-02-09, and it's filed under MPATH_PERS..._RESERVE_IN(3) in the Library Functions Manual — go forth and PRIN responsibly ✨💖