GFXATTR(1)

💖 GFXATTR(1) — the Gfarm extended-attribute page, bestie edition 💖

okay so this is gfxattr, a lil tool from the Gfarm manual (section 1, the user commands, we love her) and she is literally your bestie for playing with extended attributes in the Gfarm file system. let's get into it 🫶

✨ NAME ✨

gfxattr — manipulate extended attributes in Gfarm file system 💅

🌸 SYNOPSIS 🌸

gfxattr [-s | -g | -l | -r] [-x] [-c | -m] [-f xattrfile] file
        [xattrname]

🦋 DESCRIPTION 🦋

so gfxattr manipulates extended attributes and XML extended attributes of a specified file. no cap, that's the whole job and she ate.

an extended attribute is made of two things: an attribute name and an attribute value, and both of them are just arbitrary strings. do with that what you will 💫

an XML extended attribute is an extended attribute whose value is an XML attribute value. and here's the cute part: XML extended attributes live in a different name space from regular extended attributes, which means the same attribute name can be used in both. two completely separate little worlds, same name, no drama 😌

when you pass the -x option, you're manipulating XML extended attributes. and iykyk — you can search those XML extended attributes with an XPath query using the gffindxmlattr command. iconic.

🌈 every single file and directory in the Gfarm file system can keep extended attributes. but heads up bestie: when you remove a file or directory, the associated extended attributes get removed right along with it. gone, deleted, no takebacks 💀

and one thing you cannot skip: either -s, -g, -l, or -r should be specified. pick one, she's not gonna guess for you 🙈

🎀 OPTIONS 🎀

• -s — sets a new value with an extended attribute xattrname for a specified file. with the -f option, the value can be specified by the file xattrfile instead of by the standard input. and if neither -c nor -m is specified, the extended attribute is overwritten if it's already set. so like, it'll just bulldoze right over the old value, periodt 💅
• -g — reads a value with an extended attribute xattrname for a specified file. get that value, girl 💖
• -l — display a list of extended attributes for a specified file. the full rundown, the whole menu ✨
• -r — removes an extended attribute xattrname for a specified file. bye bye 🦋
• -x — manipulates XML extended attributes. the purple ones, remember? 💜
• -c — sets a new extended attribute if it is not set. this option is used with the -s option. no overwriting, only fresh starts 🌱
• -m — modifies the extended attribute if there it is. this option is used with the -s option. (yes, that's the original wording, she's a lil quirky, we stan 🫶)
• -f xattrfile — with the -s option, reads an extended attribute from the specified xattrfile instead of from the standard input. with the -g option, writes the extended attribute to the specified xattrfile instead of to the standard output. so it flips direction depending on which mode you're in, main character energy fr fr 👑
• -? — displays usage. when you're lost, she's there 🌈

👀 SEE ALSO 👀

• gffindxmlattr(1)

that's the whole page bestie, go forth and attribute responsibly 🎀✨

this was the Gfarm manual, gfxattr(1), dated 18 Aug 2008 — yeah she's vintage, she's a classic, she's still slaying. mwah 💋