GFAL-ARCHIVEPOLL(1)

✨ GFAL-ARCHIVEPOLL ✨

okay bestie, welcome to the gfal-archivepoll(1) glow-up 💅 this is a page from the General Commands Manual and it's all about checking on your archive requests like the nosy icon you are 🎀

🌸 NAME 🌸

gfal-archivepoll — does an archive polling operation on the SURL you hand it, no cap 🦋

🌈 SYNOPSIS 🌈

gfal-archivepoll [ OPTION ]...  FILE

💖 DESCRIPTION 💖

so. gfal-archivepoll performs an archive polling operation on a given SURL, periodt ✨ and here's the tea: if you give it a polling timeout that's greater than 0, the command literally just blocks and sits there polling the status of your archiving request. it only comes back when either the file is actually on tape 🎀 or your timeout expires 😭

👑 OPTIONS 👑

• -h, --help — shows you the help for this command 🫶
• -V, --version — spits out version info and dips immediately ✌️
• -v, --verbose — verbose mode. repeat it up to 3 times to unlock the most verbose mode 🔥
• -D, --definition DEFINITION — defines properties for gfal2. the syntax goes like this: "CONFIG_GROUP:KEY=VALUE" 📝
• -t, --timeout TIMEOUT — the global timeout for running the command. if time runs out before it finishes, the command gets interrupted 💀 heads up tho: there's a grace period of 30 seconds given to the global timeout ⏳
• -E, --cert CERT — your user certificate. (and this option only takes effect after the X509_USER_PROXY environment variable and the default /tmp/x509up_u`id -u` location can't provide a certificate 🎫)
• --key KEY — your user private key 🔑
• -4 — forces Gfal2 to use IPv4 addresses only. (option is valid only for the GridFTP protocol 📡)
• -6 — forces Gfal2 to use IPv6 addresses only. (option is valid only for the GridFTP protocol 📡)
• -C, --client-info CLIENT_INFO — gives you a way to provide custom client-side info 💁‍♀️
• --log-file LOG_FILE — writes the Gfal2 library logs to the file location you choose 📄
• --from-file FROM_FILE — reads sources from a file 📚
• --polling-timeout — the timeout for the polling operation. if you hand it a polling timeout greater than 0, the command blocks and polls the status of the archiving request, only returning once the file is on tape or the timeout expires ⏰

🌟 EXAMPLES 🌟

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

🍓 FILES 🍓

• /etc/gfal2.d/* — every single config file sitting in this directory affects the behavior of the underlying gfal2 🧚

💜 AUTHORS 💜

the absolute legends behind this:

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

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.8.0, dated Set 2022, and honestly? iconic. go poll your archives, you got this 👑✨🦋