LFS-GETNAME(1)

📦 version 2.17.58, in ubuntu stonking

✨ LFS-GETNAME(1) ✨

okay bestie, welcome to the Lustre User Utilities section of the manual — this one's lfs-getname, and it's literally the "who even are you" command for your filesystems 💅

🌸 NAME 🌸

lfs-getname — retrieve the filesystem name and instance ID 🦋

🎀 SYNOPSIS 🎀

lfs getname [--help|-h] [--instance|-i] [--fsname|-n] [--uuid|-u]
            [PATHNAME...]

💖 DESCRIPTION 💖

So basically, lfs getname prints the filesystem name, the instance ID, and the mountpoint for all the Lustre mount points hanging out on your local client. All of them. It's giving full roster. 📋✨

But — and this is the tea — if you hand it one or more PATHNAME arguments, then it only prints the Lustre filesystem name and instance ID for those mount points. Like, narrowed down. Main character energy only. 👑

💅 OPTIONS 💅

  • -h, --help — prints the usage message. the "hi can someone explain this to me" button 🫶
  • -i, --instance — only shows the mount instance ID for each filesystem. and listen: if -i is used with a single PATHNAME, then the instance ID gets printed without the mountpoint. just the ID. raw. unbothered. ✨
  • -n, --fsname — prints only the Lustre filesystem name for each filesystem. same deal here: if -n is used with a single PATHNAME, the filesystem name prints without the mountpoint. no extra fluff 🎀
  • -u, --uuid — prints only the UUID for this client filesystem mountpoint. ok but real talk, do NOT get it twisted: this is not a common UUID you can use to mount the filesystem with — it's a unique identifier for this specific mount instance. so don't try to mount with it bestie I'm begging 😭. and obviously, if -u is used with a single PATHNAME, the uuid prints without the mountpoint. consistent queen 💅

🌈 EXAMPLES 🌈

the vibes, demonstrated:

# lfs getname
myth-ffff880428703400 /myth
testfs-ffff937009271000 /mnt/testfs
# lfs getname -n /mnt/testfs
testfs
# lfs getname -i /mnt/testfs
ffff937009271000
# lfs getname -u /mnt/testfs
78adbfe8-1c12-4bd2-a485-69afa166677e

see how clean that is?? obsessed. 🔥

⭐ AVAILABILITY ⭐

lfs getname has been part of the lustre(7) filesystem package since release 2.2.0. it's been here. it's been iconic. periodt. 👑

💜 SEE ALSO 💜

and that's the whole page, bestie!! 🦋 this lil slice of Lustre User Utilities lore is dated 2024-08-15, brought to you by the Lustre crew — so go forth, run lfs getname, and know exactly which filesystem you're standing in. slay 💖🌸✨

📦 where this page comes from