LCTL-LLOG_CATLIST(8)

📦 version 2.17.58, in ubuntu stonking

🦋 NAME 🦋

okay bestie, meet lctl-llog_catlist — the little subcommand that just lists your Lustre configuration log files ✨ nothing more, nothing less, and honestly? iconic behaviour.

💅 SYNOPSIS 💅

lctl llog_catlist [--device device]

that's it. that's the whole vibe. 🎀

🌸 DESCRIPTION 🌸

so lctl llog_catlist is the girl whose entire job is listing the configuration log files on the MGS, or on some other target if you're feeling spicy. 🫶

why do you care?? because it's literally the move for finding out the names of all the configuration files available. no guessing, no cap. 🔥

here's the tea on what's inside each one, and yes you need to know this:

  • the FSNAME-client logs — they hold the configuration records for the client nodes 🧚
  • the FSNAME-MDTXXXX logs — those carry the records for the MDT(s) 👑
  • the FSNAME-OSTXXXX logs — and these ones carry the records for the OSTs ⭐

and the lctl conf_param parameters? yeah, those get stored in these very log files, for the specified filesystem. 💖

one more thing, super important: the params log file is the one holding the lctl set_param -P parameters for all filesystems serviced by this MGS. so like, it's the main character of params, basically. periodt. 💅

✨ OPTIONS ✨

  • --device device — tells it which device to use 🎀 by default the MGS device is used for this operation. so if you don't say anything, it just assumes MGS, which is lowkey very chill of it.

🌈 EXAMPLES 🌈

listing all of the configuration logs on the MGS — the classic, the debut single:

# lctl llog_catlist
config_log: testfs-OST0000
config_log: testfs-MDT0000
config_log: testfs-OST0001
config_log: testfs-client
config_log: params

look at that lil list. five entries, all accounted for, no crumbs. 🍓

listing all of the recovery llog files on the MGS — now we're passing a device, because we're fancy:

# lctl --device testfs-MDT0000 llog_catlist
catalog_log: [0x5:0x1:0x0]:0
catalog_log: [0x6:0x1:0x0]:0
catalog_log: [0x7:0x1:0x0]:0

see how the output says catalog_log: instead of config_log:? yeah. that's a thing. don't @ me, that's just what it does 😭

🎀 AVAILABILITY 🎀

so lctl llog_catlist is a subcommand of lctl(8) — not its own whole thing, it lives inside the lctl house 🏠 — and it's distributed as part of the lustre(7) filesystem package, since release 0.9.0. so it's been around, bestie. it's a veteran. 👑

💀 SEE ALSO 💀

go read these next, they're all in the same friend group:

and that's the whole page!! 🫶 this one came out of the Lustre manual, version dated 2024-08-14, filed under LCTL-LLOG_CATLIST(8) — go list some logs, you absolute legend 💖✨

📦 where this page comes from