lsm_job_status_get(3)

✨ lsm_job_status_get ✨

okay bestie, so we're in the Libstoragemgmt C API Manual and today's main character is lsm_job_status_get(3) 💅 she's the one you call when you just wanna know how's my job doing without asking for a whole data dump back. lowkey the chillest little function in the whole library.

---

🌸 NAME 🌸

lsm_job_status_get — check on the status of a job with no data returned.

like... just vibes and a status, no receipts 🫶

---

🎀 SYNOPSIS 🎀

int lsm_job_status_get (lsm_connect *conn, const char *job_id,
lsm_job_status *status, uint8_t *percent_complete, lsm_flag flags);

---

💖 ARGUMENTS 💖

• conn — a valid connection, bestie. gotta be legit or she's not talking to you.
• job_id — a String. it's the job id, iykyk. the little name tag your job's been wearing this whole time.
• status — output pointer of lsm_job_status. she writes the answer here. the possible values are literally:
  • LSM_JOB_COMPLETE — job complete, no error. we ate and left no crumbs ✨
  • LSM_JOB_ERROR — job complete but with an error. not the vibe 😭
  • LSM_JOB_INPROGRESS — job is still in progress. she's cooking, give her a minute 🍓
• percent_complete — output pointer of uint8_t. percent job complete. domain 0..100, so don't come at her with 137, she will not know what to do with that.
• flags — reserved for future use, must be LSM_CLIENT_FLAG_RSVD. like, that's the only accepted value, periodt.

---

🌈 VERSION 🌈

1.0 — she's been iconic since day one, no cap.

---

🦋 DESCRIPTION 🦋

Check on the status of a job — no data, or just ignore the data that comes back on completion. that's it. that's the whole function. you want the status, not the whole story, and honestly? respect 🫶

---

⭐ RETURN ⭐

error code as enumerated by lsm_error_number. the way this function hands you a whole enum instead of just being normal 💀 here's the rundown:

• LSM_ERR_OK — on success. slay.
• LSM_ERR_INVALID_ARGUMENT — when any argument is NULL, or it's not a valid lsm_connect pointer, or the flags are invalid. basically she clocked you 👑
• LSM_ERR_NOT_FOUND_JOB — when the job is not found. that job is gone gone 🙈

---

ngl, if job_id doesn't exist you're getting LSM_ERR_NOT_FOUND_JOB and there's no cute workaround, that's just the truth fr fr.

---

kisses, and good luck out there with your jobs 💜 — this was the Libstoragemgmt C API Manual, page lsm_job_status_get(3), in the lsm_job_status_get edition, dated February 2026. mwah, go check on your jobs bestie 🧚💖