GFAL-BRINGONLINE(1)

💖 GFAL-BRINGONLINE(1) 💖

okay bestie, welcome to the General Commands Manual section for gfal-bringonline, and no this is not a drill — this is the tool that wakes your files up from their little cold-storage nap. 🦋

---

✨ NAME ✨

gfal-bringonline — Perform a staging operation on the given SURL

---

🌸 SYNOPSIS 🌸

gfal-bringonline [ OPTION ]...  FILE

---

🎀 DESCRIPTION 🎀

so basically, gfal-bringonline performs a staging operation on the given SURL. like, it goes and asks for the file to actually be brought online.

a bringonline token gets returned if the staging request is successful — slay. ✨

and also, if the polling timeout is greater than 0, the command blocks while it polls the status of the staging request, and it only returns when the file is online or the timeout expires. so it will literally just stand there waiting, main character energy, until one of those two things happens. 💅

---

🔥 OPTIONS 🔥

• -h, --help — show help about the command. the classic.
• -V, --version — output version information and exit. bye bestie 👋
• -v, --verbose — verbose mode. repeat it up to 3 times for the most verbose mode. yes, three. go off.
• -D, --definition DEFINITION — define properties for gfal2. definitions have the following syntax: "CONFIG_GROUP:KEY=VALUE"
• -t, --timeout TIMEOUT — global timeout for the execution of the command. the command is interrupted if time expires before it finishes. > note: a grace period of 30 seconds is given to the global timeout. she's generous like that.
• -E, --cert CERT — user certificate. (this option takes effect only after the X509_USER_PROXY environment variable and the default /tmp/x509up_uid -u`` location cannot provide a certificate)
• --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.
• --pin-lifetime — desired pin lifetime
• --desired-request-time — desired total request time
• --staging-metadata — metadata for the bringonline operation
• --from-file FROM_FILE — read list of surls from a file.
• --polling-timeout — the timeout for the polling operation. if a polling timeout greater than 0 is provided, the command blocks for polling the status of the staging request and only returns when the file is on disk or the timeout expires. ⏳

---

🌈 EXAMPLES 🌈

here's the vibe, fr fr:

gfal-bringonline http://endpoint.cern.ch/path/file --polling-timeout=3600

---

🧚 FILES 🧚

• /etc/gfal2.d/* — all configuration files in this directory affect the behavior of the underlying gfal2. yes, all of them. they're all up in your business, lowkey.

---

👑 AUTHORS 👑

these iconic humans made it happen:

• Duarte Meneses <duarte.meneses@cern.ch>
• Adrien Devresse <adrien.devresse@cern.ch>
• Alejandro Alvarez Ayllon <alejandro.alvarez.ayllon@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 version v1.8.0, dated May 2022 — so like, vintage, but make it iconic. mwah 💋✨