findproxyfile(1)

✨ findproxyfile — bestie edition ✨

okay so this is findproxyfile, a lil tool from the GridSite Manual (section 1, we're in the big leagues 💅) that literally just tells you the full path to a GSI Proxy file. that's it. that's the whole job. and she does it flawlessly. 🎀

---

🌸 NAME 🌸

findproxyfile — returns full path to GSI Proxy file 🦋

---

🌈 SYNOPSIS 🌈

findproxyfile [--proxycache=PATH] [--delegation-id=ID] [--user-dn=DN]
[--outsidecache]

no cap, that's the whole vibe. now let's get into it 💖

---

💜 DESCRIPTION 💜

so findproxyfile returns the full path to a GSI Proxy file. and the way it does that? two options, bestie:

• it looks in the proxy cache maintained by the GridSite G-HTTPS and delegation portType functions, or
• it checks other standard places.

if a User DN is given, findproxyfile uses the value of the --proxycache argument, the GRST_PROXY_PATH environment variable, or the compile time default to figure out where the proxy cache directory lives. then it searches that directory for a proxy having the given User DN and Delegation ID. (and if no Delegation ID is specified? the default value gets used, periodt.)

and if findproxyfile doesn't find a proxy, or if a User DN wasn't given in the first place but --outsidecache was given — then it also searches the X509_USER_PROXY environment variable and the standard location /tmp/x509up_uUID. 🫶

---

✨ OPTIONS ✨

• --proxycache=PATH — hands over the path of the proxy cache directory, like, explicitly. this overrides the default and the GRST_PROXY_PATH environment variable if it's present. main character move honestly 👑
• --delegation-id=ID — this optional delegation ID gets searched for in the proxy cache in addition to the User DN. if it's absent, the default Delegation ID value is what gets searched for instead. 💫
• --user-dn=DN — the DN of the full user certificate associated with the proxy you're searching for in the proxy cache. and listen, this is NOT the DN of any proxy earlier in the chain — it is the DN of a certificate issued by a recognised CA. don't get it twisted bestie 😭
• --outsidecache — if a User DN isn't given, or a proxy just isn't found in the cache, then go search for a proxy using the X509_USER_PROXY environment variable and the file name of form /tmp/x509up_uUID as well. backup plan energy 🌸

---

🎀 RETURN VALUE 🎀

if a proxy is found, its full path is output on standard out. slay. 💖

---

🔥 EXIT CODES 🔥

• 0 is returned on success ✨
• Non-zero otherwise. 💀

---

😭 BUGS 😭

in this version, no attempt is made to verify or validate the proxies. she's giving trust fall, not background check. 🙈

---

💅 AUTHOR 💅

Andrew McNab <Andrew.McNab@man.ac.uk>

findproxyfile is part of GridSite: http://www.gridsite.org/ 🌈

---

and that's the whole page bestie!! this was the GridSite Manual version, dated October 2004 — iconic, timeless, lowkey a legend. go find those proxy files. iykyk 🦋💖✨🎀