gluster-setgfid2path(8)

✨ gluster-setgfid2path — the manual, bestie edition ✨

okay so you're reading the gluster-setgfid2path(8) page from the System Manager's Manual, and honestly? it's giving "tiny tool, huge glow-up" 💅 let's get into it 🫶

🎀 NAME 🎀

gluster-setgfid2path — a Gluster tool that sets GFID to Path xattrs ✨

🌸 SYNOPSIS 🌸

gluster-setgfid2path file

that's it. one file. no drama, no extra flags. simple queen behaviour 👑

🦋 DESCRIPTION 🦋

so new feature alert 🚨 — this landed with Gluster release 3.12, and its whole job is letting you find the full path from a GFID. iconique, truly.

to turn it on, you use the Volume set command:

gluster volume set <VOLUME> storage.gfid2path enable

ngl, this part matters: once gfid2path is enabled it starts recording the necessary xattrs required for the feature — but it will NOT go back and add xattrs for the files that already existed. it's not doing retroactive work, bestie, it's not that kind of girl 😭

and that's literally why this tool exists: gluster-setgfid2path gives you the facility to update the gfid2path xattrs for the given file path 💖 so your old files can finally catch up. slay.

🍓 EXAMPLES 🍓

to add xattrs of a single file — one file, one command, main character energy:

gluster-setgfid2path /bricks/b1/hello.txt

to set xattr for all the existing files — run the below script on each bricks (yes, every single one, no skipping 🫶):

BRICK=/bricks/b1
find $BRICK -type d \( -path "${BRICK}/.trashcan" -o -path \
    "${BRICK}/.glusterfs" \) -prune -o -type f \
    -exec gluster-setgfid2path {} \;

look at that find line eating and leaving no crumbs 🔥 it prunes .trashcan and .glusterfs so you're not out here setting xattrs on stuff you shouldn't, then hits every regular file with the tool. periodt.

🌈 SEE ALSO 🌈

• gluster(8) — go read that one too, iykyk 💜

👑 COPYRIGHT 👑

Copyright(c) 2017 Red Hat, Inc. <http://www.redhat.com>

💀 reminder for the girlies: the xattrs only get recorded after you enable the feature, and this tool is your fix for the files that were already there before you did. no cap.

and that's the whole page!! mwah 💅

sign-off time 🎀 this was gluster-setgfid2path(8) from the System Manager's Manual — literally just a command line utility to set GFID to Path — and the copyright is Red Hat, Inc., 2017 🫶 stay iconic, bestie ✨🌸