LFS-GETSOM(1)

📦 version 2.17.58, in ubuntu stonking

✨ LFS-GETSOM(1) ✨

okay bestie, welcome to lfs-getsom 💖 this one lives in the Lustre User Utilities corner of your man pages and it's literally just "hey, what does the MDS know about this file?"

🌸 NAME 🌸

lfs-getsom — list file attributes that are stored on an MDS 🫶

🎀 SYNOPSIS 🎀

lfs getsom [-h] [-s|-b|-f] FILE

🦋 DESCRIPTION 🦋

so the way this works: lfs getsom spills the tea on the file attributes that the MDS is holding onto, no cap 💅

You call it with the full path and file name for a file that's chillin' on the Lustre file system. That part matters — full path, full filename, don't be shy with it.

And if you don't pass any flags at all? Then all the file attributes stored on the MDS get shown. All of them. The whole vibe check. 👑

💖 OPTIONS 💖

  • -h — prints the usage message, i.e. the "here's how you use me" moment 🙈
  • -s — only shows the size value of the SOM data for a given file
  • -b — only shows the blocks value of the SOM data for a given file ✨ (blocks value, specifically, nothing else)
  • -f — only shows the flag value of the SOM data for a given file. And the valid flags are, drumroll pls 🥁:
    • 0 — Unknown or no SoM data, must get size from OSTs.
    • 1 — Known strictly correct, FLR or DoM file (SoM guaranteed).
    • 2 — Known stale — was right at some point in the past, but it is known (or likely) to be incorrect now (e.g. opened for write).
    • 4 — Approximate, may never have been strictly correct, need to sync SOM data to achieve eventual consistency.
ngl bestie, flag 2 is giving "we were so back but now it's so over" 😭 and flag 4 is just pure chaos energy — approximate is approximate, keep an eye on it.

🌈 AVAILABILITY 🌈

The lfs getsom command is part of the lustre(7) filesystem package, and it's been there since release 2.12.0 🎀 so if you're on something older than that... yeah, not me finding it for you 💀

⭐ SEE ALSO ⭐

and that's the whole page, bestie, you ate it 💅🫶 this was Lustre, dated 2024-08-15 — main character energy only, periodt ✨👑

📦 where this page comes from