dmmp_...s_get(3)

✨ dmmp_path_status_get — the vibe check for your paths ✨

okay bestie, welcome to the Device Mapper Multipath API corner of the libdmmp manual 💖 this one's a little function that tells you what's actually going on with a multipath path. no cap, it's giving "is this path okay or is it going through it". 🦋

---

💅 NAME 💅

dmmp_path_status_get — go get that path status, queen. Retrieve the path status. 👑

---

🌸 SYNOPSIS 🌸

uint32_t dmmp_path_status_get (struct dmmp_path *dmmp_p);

---

🎀 ARGUMENTS 🎀

• dmmp_p — a pointer to a struct dmmp_path. sounds chill, right? WRONG. if this pointer is NULL, your program gets terminated by assert. like, straight up ended. no warning text, no apology, just 💀. so please, for the love of everything, don't pass NULL. 🙈

---

🫶 DESCRIPTION 🫶

so the function hands you back a status, and here's the full menu of possible statuses, because the valid path statuses are:

• DMMP_PATH_STATUS_UNKNOWN — mystery era. we simply do not know. 🕵️
• DMMP_PATH_STATUS_DOWN — the path is down, and you should not try to send commands to it. it's not answering, bestie, leave it alone. 😭
• DMMP_PATH_STATUS_UP — the path is up and I/O can be sent to it. main character energy, we love to see it. 🔥
• DMMP_PATH_STATUS_SHAKY — only the emc_clariion checker reports this, when the path is not available for "normal" operations. it's giving shaky, fr fr. 🫨
• DMMP_PATH_STATUS_GHOST — only the hp_sw and rdac checkers. this one means a "passive/standby" path on active/passive HP arrays. these paths will return valid answers to certain SCSI commands (tur, read_capacity, inquiry, start_stop), but they will fail I/O commands. the path needs an initialization command sent to it before I/Os will succeed. so it's technically there but it's ghosting you 👻
• DMMP_PATH_STATUS_PENDING — available for all async checkers, when a check IO is in flight. like, hold on, we're mid-check, be patient. ⏳
• DMMP_PATH_STATUS_TIMEOUT — only the tur checker, when the command timed out. it didn't ghost you on purpose, it just ran out of time. 💀
• DMMP_PATH_STATUS_DELAYED — okay so if a path fails after being up for fewer than delay_watch_checks checks, then when it comes back up again it will not be marked as up until it has been up for delay_wait_checks checks. during that window, it's marked as "delayed". it's in its healing era, give it a sec. 🌱

---

⭐ RETURN ⭐

uint32_t. that's it, that's the return type. a whole unsigned 32-bit int. slay. 💅

---

heads up bestie: those status constants are the exact strings — copy them character for character or your code will simply not vibe. 💜

---

that's the whole page, bestie — you're officially fluent in dmmp_path_status_get. 🌈 this gorgeous little writeup is dmmp_path_status_get from dmmp_...s_get(3), June 2025 edition, brought to you by the libdmmp girlies. mwah, go forth and check those paths. 🎀✨🫶