LCTL-LLOG_CANCEL(8)

📦 version 2.17.58, in ubuntu stonking

💅 lctl-llog_cancel — bestie's guide to cancelling Lustre log records ✨

okay so real talk, this is the lctl-llog_cancel page from the Lustre Configuration Utilities manual, section 8 of the man pages, no cap. it cancels a record in a Lustre log file. and honestly? it's giving "small command, big power" energy. let's go 🫶

🌸 NAME 🌸

lctl-llog_cancel — cancel a record in a Lustre log file. periodt.

✨ SYNOPSIS ✨

lctl llog_cancel --log_idx INDEX LOGNAME

that's the whole thing bestie, one line, and it ate. 😌

🦋 DESCRIPTION 🦋

so here's the tea, and i mean this literally because this is a log we're talking about 💀

lctl llog_cancel cancels the configuration record given by INDEX from the LOGNAME configuration log, typically on the MGS. if a persistent configuration record got set incorrectly, or if it's just not needed anymore, this is your girl. it's the "actually, no" button. it's the "we don't claim that anymore" button. 🌈

BUT — and this part matters SO much — cancelling a record does not "undo" any effect it had on clients that are currently mounted. it only stops the record from being seen in the future. it's not a time machine, bestie, it's a "moving forward, this never happened (for newly-reading clients)" situation. important, don't forget it. 😭

also if you want the list of configuration logs so you know what LOGNAME even is, go peek at lctl-llog_catlist(8). it's the menu 📋✨

👑 OPTIONS 👑

  • --log_idx INDEX — the record INDEX number you're cancelling, exactly as it was printed by lctl llog_print for that log. don't make one up, look it up, i promise it'll save you. 💅

🔥 EXAMPLES 🔥

cancel record 15 from the testfs-client conf_param log 🎀

# lctl llog_cancel --log_idx=15 testfs-client

cancel record 22 from the params set_param log 🍓

# lctl llog_cancel --log_idx=22 params

look at her go. so clean. so precise. no notes. ⭐

💖 AVAILABILITY 💖

lctl llog_cancel is a subcommand of lctl(8), and it's distributed as part of the lustre(7) filesystem package since release 0.10.0. so she's been here since 0.10.0, and she's here for you now. 🧚

🌈 SEE ALSO 🌈

go read your sisters, they're all iconic in their own way 💜

and that's the whole page bestie, mwah 😽 this was brought to you by the Lustre folks, dated 2024-08-14 — look at her, aged like fine wine, still serving. go cancel a record responsibly. 🫶✨

📦 where this page comes from