lsm_job_free(3)

📦
version 1.10.3 · 3 versions
, in fedora 43, fedora 44

✨ lsm_job_free(3) ✨

okay bestie, welcome to lsm_job_free from the Libstoragemgmt C API Manual — this is the lil cleanup queen that takes your job's resources and yeets them into the void 💅 no cap, she's tiny but she's important.

🎀 NAME 🎀

lsm_job_free — frees the resources used by a job.

🦋 SYNOPSIS 🦋

int lsm_job_free (lsm_connect *conn, char **job_id, lsm_flag flags);

🌸 ARGUMENTS 🌸

  • conn — a valid connection pointer, like fr, it has to actually point at a real lsm_connect. Don't be handing her nonsense.
  • job_id — a string, bestie. It's the job ID. Yes it's a char **, and yes that double pointer matters — hold that thought, the NOTE section is about to explain why 🙈
  • flags — reserved for future use, so you literally must pass LSM_CLIENT_FLAG_RSVD. No freestyling. The future isn't here yet 💀

💜 VERSION 💜

1.0 — iconic, established, we stan a stable API 🫶

🌈 DESCRIPTION 🌈

Frees the resources used by a job. That's the whole vibe. She takes the job's stuff, she cleans it up, she goes home. Main character energy in like three lines of code ✨

⭐ NOTE ⭐

listen up, this part is lowkey the most important bit: the memory used for the job id string will be freed during this call, and job_id will be set to NULL.

so do NOT go touching that job_id pointer afterwards, okay? she's gone. she's been freed. she is NULL now and that's on purpose 🍓 that's also why it's a char ** in the synopsis — she has to reach in and null it out for you.

🔥 RETURN 🔥

She hands back an error code, as enumerated by lsm_error_number. The possibilities, bestie:

  • LSM_ERR_OK — on success. slay, it worked 💖
  • LSM_ERR_INVALID_ARGUMENT — when any argument is NULL, or conn isn't a valid lsm_connect pointer, or the flags are invalid. basically "girl what did you just pass me" 😭
  • LSM_ERR_NOT_FOUND_JOB — when the job isn't found. can't free what isn't there, bestie 💀

and that's the page!! this was the Libstoragemgmt C API Manual energy, dated February 2026, and lsm_job_free is still out here freeing job resources and nulling your pointers like the absolute queen she is 👑 mwah, go forth and free responsibly 🧚💜

📦 where this page comes from