GFAL-STAT(1)

💖 GFAL-STAT(1) 💖

okay so bestie, welcome to the gfal-stat page from the General Commands Manual, and trust me when I say this one is lowkey the glow-up of ls. She shows you the extended info — like the whole story — about a file or a directory. ✨

---

🌸 NAME 🌸

gfal-stat — display extended information about a file or directory

no cap, that's the whole vibe. she stats, she spills the tea, she tells you everything. 💅

---

✨ SYNOPSIS ✨

gfal-stat [ OPTION ]...  URL

yep that's it. some options, one URL, and she's off. periodt.

---

🦋 DESCRIPTION 🦋

gfal-stat Display extended information about a file or directory.

like literally that's the job. you hand her a URL, she hands you back the receipts: size, access perms, uid, gid, timestamps, the works. main character energy fr fr. 👑

---

🎀 OPTIONS 🎀

• -h, --help — show help about the command. (she'll explain herself, iconic behaviour)
• -V, --version — output version information and exit. boom, done, bye.
• -v, --verbose — verbose mode. Repeat up to 3 times for the most verbose mode. so like -v, -vv, -vvv — the more v's, the more she yaps, and honestly? we love that for her.
• -D, --definition DEFINITION — define properties for gfal2. Definitions have the following syntax: "CONFIG_GROUP:KEY=VALUE". it's giving ✨customisation✨.
• -t, --timeout TIMEOUT — global timeout for the execution of the command. Command is interrupted if time expires before it finishes. Note: A grace period of 30 seconds is given to the global timeout. so she's not heartless, she gives you 30 extra seconds before she fully gives up on you. 🫶
• -E, --cert CERT — user certificate. (This option takes effect only after X509_USER_PROXY environment variable and default /tmp/x509up_u\id -u`` location cannot provide a certificate) — so like, she checks her usual spots first, and only then does this one kick in. backup plan energy.
• --key KEY — user private key.
• -4 — forces Gfal2 to use IPv4 addresses only. (Option valid only for GridFTP protocol)
• -6 — forces Gfal2 to use IPv6 addresses only. (Option valid only for 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. for when you wanna read the group chat later. 📝

ngl, -4 and -6 are picky — they only do anything for the GridFTP protocol. don't come for me, that's just what the page says. 💀

---

🌈 EXAMPLES 🌈

okay so here's what it actually looks like when she does her thing:

gfal-stat file:///tmp/path1/path2

File: 'file:///tmp/path1/path2'
Size: 1986     directory
Access: (1777/drwxrwxrwx)     Uid: 0    Gid: 0
Access: 2017-05-10 13:15:35.000000
Modify: 2017-05-10 13:24:04.000000
Change: 2017-05-10 13:24:04.000000

and on a remote endpoint? same energy bestie:

gfal-stat srm://endpoint.cern.ch/path/directory1

File: 'srm://endpoint.cern.ch/path/directory1'
Size: 1986     directory
Access: (1777/drwxrwxrwx)     Uid: 0    Gid: 0
Access: 2017-05-10 13:15:35.000000
Modify: 2017-05-10 13:24:04.000000
Change: 2017-05-10 13:24:04.000000

see? she ate that. 🔥

---

🍓 FILES 🍓

• /etc/gfal2.d/* — All configuration files in this directory affect the behavior of the underlying gfal2.

so like, everything in that lil folder is influencing the gfal2 underneath. mind your business there, iykyk. 🙈

---

💜 AUTHORS 💜

these are the legends who made her:

• 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>

absolute icons, every single one. 👑

---

🧚 SEE ALSO 🧚

she rolls with a whole squad:

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)

go say hi to her friends, they're all slay. 💖

---

and that's the whole page bestie!! this one's from v1.7.1, dated March 2022 — yeah she's been that girl for a minute now. mwah. 💅✨