GFAL-LS(1)

🌸 GFAL-LS(1) — the "what's in this directory tho" manual 🌸

okay bestie, welcome to the gfal-ls page from the General Commands Manual — yes that manual, the fancy one ✨

---

✨ NAME ✨

gfal-ls — list directory contents or file information. that's it, that's the job 💅

---

🦋 SYNOPSIS 🦋

gfal-ls [ OPTION ]...  FILE

---

💖 DESCRIPTION 💖

so gfal-ls lists info about the file, periodt. Depending on the implementation, some info from the long listing — like group and user ids — might not be available, and in that case it just shows up as 0 🫠 no drama.

⚠️ real talk though: when you're listing several files or directories, if one of them returns an error, the execution is canceled. the whole thing. gone. so keep that in mind bestie 😭

---

🎀 OPTIONS 🎀

• -h, --help — shows help about the command. classic, iconic 🫶
• -V, --version — spits out version information and exits. bye 👋
• -v, --verbose — verbose mode. repeat it up to 3 times for the most verbose mode, aka main character energy.
• -D, --definition DEFINITION — define properties for gfal2. Definitions have this syntax: "CONFIG_GROUP:KEY=VALUE" — yes, exactly like that, no cap.
• -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. so it's a lil generous, we love that 💖
• -E, --cert CERT — user certificate. (this option only takes effect after the X509_USER_PROXY environment variable and the default /tmp/x509up_u`id -u` location cannot provide a certificate — iykyk)
• --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. receipts, but for logs 📝
• -a, --all — don't hide files with a name starting in . — yes we're showing the hidden ones, we're nosy and that's valid 🌸
• -l, --long — long listing format. these columns get displayed for each entry: mode, number of links, group id, user id, last modification time, size and name. the full serve 💅
• -d, --directory — list directory entries instead of its contents. so you see the folder itself, not what's inside it 🙈
• -H, --human-readable — with -l, print sizes in human readable format (e.g.: 1K, 234M, 2G). we love numbers we can actually read ✨
• --xattr XATTR — with -l, query additional attributes. can be specified multiple times. stack 'em up 🧚
• --time-style STYLE — specify the time style. supports these values: locale, iso, long-iso or full-iso (partially). note the "partially", bestie, don't come for me 👑
• --full-time — equivalent to --time-style=full-iso. it's giving the same thing.
• --color MODE — with -l, enable or disable color output. supports these values: always, never, auto. pick your vibe 🌈

---

🔥 EXAMPLES 🔥

Long listing of all files:

gfal-ls -laH srm://endpoint.cern.ch/path/file

List a directory instead of its contents:

gfal-ls -d file:///tmp

---

🌟 FILES 🌟

• /etc/gfal2.d/* — all configuration files in this directory affect the behavior of the underlying gfal2. yes, all of them, they're running the show 💜

---

👑 AUTHORS 👑

the literal icons who made this happen:

• 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, go say hi:

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)

---

and that's the whole page, bestie ✨ this was v1.7.1, dated March 2022 — slay, stay hydrated, and may all your listings return zero errors 💖🦋🌸