LFS-MIRROR-DELETE(1)

📦 version 2.17.58, in ubuntu stonking

💅 LFS-MIRROR-DELETE(1) 💅

okay bestie, so this is a page from the Lustre User Utilities manual, and we're talking about lfs-mirror-delete today. sit down, hydrate, and let's get into it 🫶

✨ NAME ✨

lfs-mirror-delete — delete a specified mirror from an existing mirrored file

like, you have a mirrored file, and you want one of its mirrors GONE? that's literally this. bye bestie 👋

🌸 SYNOPSIS 🌸

lfs mirror delete {--mirror-id MIRROR_ID | --component-id|--comp-id|-I
                  COMP_ID | --pool POOL} MIRRORED_FILE

so you pick one of those three ways to point at the mirror you're evicting, and then you name the MIRRORED_FILE. yes it's that simple. no cap 💖

🦋 DESCRIPTION 🦋

This command deletes a mirror with mirror ID MIRROR_ID, or containing a component with COMP_ID, or containing a component on POOL, out of a mirrored file specified by the path name MIRRORED_FILE.

If MIRRORED_FILE has only one mirror existing after split, it will be converted to a regular non-mirrored file. so basically the file loses its whole mirror girl era and becomes Just A Regular File. character development honestly ✨

If the original MIRRORED_FILE is not a mirrored file, then the command will return an error. 💀 yes. if there's nothing to delete, it's not gonna manifest a mirror out of thin air. error. that's it.

💅 OPTIONS 💅

  • --mirror-id MIRROR_ID — the numerical unique identifier for a mirror. the mirror ID is unique within a mirrored file and is automatically assigned at file creation or extension time. wanna peep it first? it can be fetched by the lfs getstripe command (see lfs(1)). 🎀
  • -I, --comp-id COMP_ID — the numerical unique identifier for a component contained within a mirror. give it the component's digits and it'll hunt down the mirror that's holding it. 🔍
  • --pool POOL — the pool storing a component contained within a mirror. so like, which pool is the mirror's component chilling on? that one. 🏊♀️

🔥 EXAMPLES 🔥

Delete the mirror with ID 2 of /mnt/lustre/file1:

# lfs mirror delete --mirror-id 2 /mnt/lustre/file1

Delete the mirror containing the component with ID 65537 of /mnt/lustre/file1:

# lfs mirror delete --comp-id 65537 /mnt/lustre/file1

Split a mirror on pool ssd out of /mnt/lustre/file1 and destroy it:

# lfs mirror delete --pool ssd /mnt/lustre/file1

see how each one is just one of the three selectors? pick your fighter, don't mash them all together bestie 😭

👑 AVAILABILITY 👑

The lfs mirror delete command is part of the lustre(7) filesystem package since release 2.13.0. so if you're on something ancient, that's giving pre-glow-up energy and you won't find it. 🫶

🌈 SEE ALSO 🌈

the whole mirror squad fr fr — create it, extend it, resync it, split it, verify it, and yeah, delete it 💖

and that's the whole page, bestie! this one's straight from the Lustre manual, dated 2024-08-20, and it's LFS-MIRROR-DELETE(1) in all its glory. go forth and delete responsibly, mwah 💅✨🎀

📦 where this page comes from