GFAL-XATTR(1)

✨ NAME ✨

gfal-xattr — bestie edition 💅 show or set attributes of a file

So like, this is gfal-xattr(1), one of the General Commands Manual girlies, and she does exactly one job but she does it so well. 🫶

---

🎀 SYNOPSIS 🎀

gfal-xattr [ OPTION ]...  FILE [ ATTRIBUTE [ = VALUE ]]

---

🌸 DESCRIPTION 🌸

gfal-xattr shows you the attributes of a file, or sets them to a brand new value. That's the whole vibe. 🌈

And here's the cute part — this command comes in three forms, so for whatever file you point it at, you can:

• list all the attributes and their corresponding values,
• display the value of one particular attribute,
• or assign a new value to one particular attribute.

Not me giving you options, bestie. 😌 Go look at the examples below if you want to see each form in the wild.

---

💖 OPTIONS 💖

• -h, --help — show help about the command. Your girl is helpful fr fr.
• -V, --version — output version information and exit. Then she's gone, bye. 👋
• -v, --verbose — verbose mode. Repeat it up to 3 times for the most verbose mode. Stack them like accessories. 💅
• -D, --definition DEFINITION — define properties for gfal2. Definitions have this syntax: "CONFIG_GROUP:KEY=VALUE" — exact format, no improvising.
• -t, --timeout TIMEOUT — global timeout for the execution of the command. The command gets interrupted if time expires before it finishes. > ⚠️ Note: a grace period of 30 seconds is given to the global timeout. She's strict but she's not that strict.
• -E, --cert CERT — user certificate. (This option takes effect only after the X509_USER_PROXY environment variable and the default `/tmp/x509up_u`id -u` location cannot provide a certificate) — so she's the backup plan, not the first choice. 😭
• --key KEY — user private key.
• -4 — forces Gfal2 to use IPv4 addresses only. (Option valid only for the GridFTP protocol)
• -6 — forces Gfal2 to use IPv6 addresses only. (Option valid only for the GridFTP protocol)
• -C, --client-info CLIENT_INFO — provide custom client-side information.
• --log-file LOG_FILE — write Gfal2 library logs to the given file location.
• FILE — file URI. The main character, honestly. 👑
• ATTRIBUTE — optional argument, specifying an attribute to get or set. If no attribute is given, all attributes and their corresponding values are displayed. Slay, no filter.
• VALUE — if an attribute is given, a new value can optionally be assigned to it.

---

🦋 EXAMPLES 🦋

Show all attributes and values of a file:

gfal-xattr srm://endpoint.cern.ch/path/file

Show the value of a particular attribute:

gfal-xattr srm://endpoint.cern.ch/path/file user.status

Set a new value to an attribute:

gfal-xattr srm://endpoint.cern.ch/path/file user.status=new_value

Typically, you can get the transport urls (turls) with the "user.replicas" attribute:

srm://endpoint.cern.ch/path/file user.replicas

Not me writing user.status=new_value with zero spaces around the = — that's literally the syntax, bestie, don't @ me. 😭

---

🍓 FILES 🍓

• /etc/gfal2.d/* — All configuration files in this directory affect the behavior of the underlying gfal2. So if something's acting up, it's giving... config files. 🙈

---

🧚 AUTHORS 🧚

The icons who made this happen, periodt:

• Duarte Meneses <duarte.meneses@cern.ch>
• Adrien Devresse <adrien.devresse@cern.ch>
• Alejandro Alvarez Ayllon <alejandro.alvarez.ayllon@cern.ch>
• Andrea Manzi <andrea.manzi@cern.ch>
• Mihai Patrascoiu <mihai.patrascoiu@cern.ch>
• Joao Lopes <joao.pedro.batista.lopes@cern.ch>

---

⭐ SEE ALSO ⭐

The whole friend group, iykyk:

gfal-cat(1), gfal-chmod(1), gfal-copy(1), gfal-ls(1), gfal-mkdir(1), gfal-rename(1), gfal-rm(1), gfal-save(1), gfal-stat(1), gfal-sum(1), gfal-token(1), gfal-xattr(1), gfal-evict(1), gfal-bringonline(1), gfal-archivepoll(1)

---

okay that's the whole page, bestie 💜 This one's v1.7.1 from March 2022, and yeah she's been sitting in the General Commands Manual section this whole time like the iconic queen she is. Go get those attributes. ✨🎀🦋