LCTL-NOD...EL_OFFSET(8)

💅 lctl-nodemap_del_offset — the section-8 girlie from the Lustre Configuration Utilities crew ✨

okay so bestie, welcome to lctl-nodemap_del_offset(8), and yes that's a section-8 manual page, we're in the big leagues now 🫶

---

✨ NAME ✨

lctl-nodemap_del_offset — remove an ID mapping offset from a nodemap. that's it, that's the whole job 💖

---

🌸 SYNOPSIS 🌸

lctl nodemap_del_offset or
lctl nodemap del_offset --name NAME

two ways to say the same thing, pick your fave, both slay 💅

---

🦋 DESCRIPTION 🦋

nodemap_del_offset removes an identity mapping offset from a nodemap — and it does it for the UID, GID and PROJID types. all three, no picking favourites 🔥

---

💜 OPTIONS 💜

• --name NAME — the name of the nodemap you're removing the offset from. tell it which nodemap, bestie, it can't read your mind 🎀

---

👑 NOTES 👑 (read this one, fr fr)

okay so this is the part where I hold your hand 🫶 removing an offset from a nodemap does NOT affect the UID, GID, or PROJID of any files that were previously created under this nodemap. like, the files are just out there living their lives with the old numbers 😭

so if those files get mapped into a different nodemap, then their UID, GID, and PROJID must be changed on a trusted client — and that client needs access to the unmapped, canonical file system IDs, periodt. you do that with chown(1), chgrp(1), and lfs project(1), going from the old offset range to the new offset. no cap, that's the whole procedure 💀

the way that removing an offset from a nodemap should be avoided whenever possible… yeah. it's giving "last resort energy". plan around it if you can 🙈

---

🍓 EXAMPLES 🍓

remove the already existing offset from nodemap remotesite:

# lctl nodemap_del_offset --name remotesite

look at her go. iconic. ✨

---

🌈 AVAILABILITY 🌈

lctl nodemap_del_offset is part of the lustre(7) filesystem package, and it's been here since release 2.16.0. she's new-ish but she's thriving 🧚

---

⭐ SEE ALSO ⭐

lustre(7), lctl-nodemap-activate(8), lctl-nodemap-add-idmap(8), lctl-nodemap-add-offset(8), lctl-nodemap-add-range(8), lctl-nodemap-del(8), lctl-nodemap-del-idmap(8), lctl-nodemap-del-range(8), lctl-nodemap-modify(8), lctl-nodemap-new(8)

the whole friend group, go say hi 💖

---

that's the page, bestie 🎀 brought to you by Lustre, dated 2024-08-21, straight out of the LCTL-NOD...EL_OFFSET(8) corner of the manual. go off, map responsibly, and don't delete offsets you might need later 😭💜