GFAL-MKDIR(1)

🎀 GFAL-MKDIR(1) — General Commands Manual 🎀

okay bestie, pull up a chair (or don't, it's a manpage) because this is gfal-mkdir(1), and it's literally just mkdir but for the grid 💅 if you've ever used mkdir you already know 90% of this, and the other 10% is where it gets cute.

---

✨ NAME ✨

gfal-mkdir — make directories. that's it. that's the whole vibe. 🦋

---

✨ SYNOPSIS ✨

gfal-mkdir [ OPTION ]...  DIRECTORY...

---

🌸 DESCRIPTION 🌸

gfal-mkdir creates the DIRECTORY(ies) you hand it — but only if they don't already exist, because we're not messy like that 🙈 by default it makes them with mode 0755.

---

💖 OPTIONS 💖

• -h, --help — shows help about the command. your little "what does this do again" button 🫶
• -V, --version — outputs version info and dips out. bye 👋
• -v, --verbose — verbose mode. you can repeat it up to 3 times for the most verbose mode. yes, three. go off, stack them, be extra, the tool supports it ✨
• -D, --definition DEFINITION — define properties for gfal2. definitions use this syntax: "CONFIG_GROUP:KEY=VALUE"
• -t, --timeout TIMEOUT — global timeout for running the command. if time runs out before it finishes, the command gets interrupted. note: a grace period of 30 seconds is given to the global timeout, so it's not instant-instant 🕐
• -E, --cert CERT — user certificate. (this one only kicks in after the X509_USER_PROXY environment variable and the default /tmp/x509up_uid -u`` location can't provide a certificate — so it's the backup plan, not the main character)
• --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. tell it about yourself, it's listening 💬
• --log-file LOG_FILE — write Gfal2 library logs to the given file location. receipts, but saved to disk 🧾
• -m, --mode MODE — set file mode (default is 0755). heads up though: depending on the storage implementation, it might not be used at all. so, like, suggesting a mode 😭
• -p, --parents — make parent directories as needed. and it reports no error if the directory already exists. this is the peacekeeper of flags fr fr 🕊️

---

🌈 EXAMPLES 🌈

make a nested path with a specific mode:

gfal-mkdir -p -m 0700 file:///tmp/path1/path2

make two directories on an SRM endpoint at once, because why do two commands when one slays:

gfal-mkdir srm://endpoint.cern.ch/path/directory1 srm://endpoint.cern.ch/path/directory2

---

🧚 FILES 🧚

• /etc/gfal2.d/* — all configuration files in this directory affect the behavior of the underlying gfal2. yes, all of them. that whole folder is the personality 💅

---

👑 AUTHORS 👑

these are the people who made this, show some respect 💜

• 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, no cap:

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 page, bestie 🫶 this little icon is v1.7.1, dated March 2022 — go make some directories, you absolute legend ⭐