GRID-PROXY-INFO(1)

💅 NAME 💅

grid-proxy-info — bestie, it literally just spills the tea about a proxy certificate ✨

🦋 SYNOPSIS 🦋

grid-proxy-info -help | -usage | -version

grid-proxy-info -e | -exists [-valid HOURS:MINUTES | -v HOURS:MINUTES]
[-hours HOURS | -h HOURS] [-bits BITS | -b BITS]

grid-proxy-info [OPTIONS]

🌸 DESCRIPTION 🌸

okay so grid-proxy-info is that girl who goes digging through an X.509 proxy certificate, pulls out the info, and then either shows it to you or just quietly hands you an exit code based on what she found. no cap 💖

Default mode? She prints the following facts about the current user's default proxy: subject, issuer, identity, type, strength, path, and time left. iconic behavior.

BUT — the second you drop -exists or -e in there, she goes silent unless you also asked for one of the print options. Instead she just checks: does a valid proxy exist? If yes → exit code 0 💚. If the proxy doesn't exist or isn't valid → exit code 1 💀.

Wanna add more validity criteria? Slap on -valid, -v, -hours, -h, -bits, or -b. ⚠️ important ⚠️ — if you use those, they must come after the -e or -exists option. They're only valid when one of -e or -exists is present. the way that she needs her friends in the right order… periodt.

✨ OPTIONS ✨

here's the complete set of command-line options, bestie, no gatekeeping 🫶

• -help, -usage — shows you the command-line options for grid-proxy-info. a little menu moment 🎀
• -version — tells you the version number of the grid-proxy-info command.
• -debug — turns on verbose error messages. she gets chatty when things go wrong 😭
• -file PROXYFILE, -f PROXYFILE — read the proxy sitting in the file PROXYFILE instead of the default proxy. picking your own fave ✨
• -subject, -s — displays the proxy certificate's subject distinguished name.
• -issuer, -i — displays the proxy certificate issuer's distinguished name.
• -identity — displays the proxy certificate's identity. For non-independent proxies, the identity is the subject of the certificate which issued the first proxy in the proxy chain. iykyk 🌈
• -type — displays the type of proxy certificate. The type string includes the format ("legacy", "draft", or RFC 3280 compliant), identity type ("impersonation" or "independent"), and policy ("limited" or "full"). Peep grid-proxy-init(1) for how to create the different types of proxies 💜
• -timeleft — displays the number of seconds remaining until the proxy certificate expires. the countdown, literally ⏳
• -strength — displays the strength (in bits) of the key associated with the proxy certificate.
• -all — displays the default information for the proxy when you're also using the -e or -exists option. have it all, queen 👑
• -text — displays the proxy certificate contents to standard output, including policy information, issuer, public key, and modulus. full dump energy 💅
• -path — displays the path to the file containing the default proxy certificate.
• -rfc2253 — displays distinguished names for the subject, issuer, and identity using the string representation described in RFC 2253, instead of the legacy format. glow-up format ✨
• -exists, -e — performs an existence and validity check for the proxy. If a valid proxy exists and matches the criteria described by the other command-line options (if any), exit with 0; otherwise, exit with 1. This option must be before the other validity check predicates in the command-line options. If this option is specified, the output of the default facts about the proxy is disabled — use the -all option if you want the info displayed and the exit code set. main character of this whole page fr fr 💖
• -valid HOURS:MINUTES, -v HOURS:MINUTES, -hours HOURS, -h HOURS — checks that the proxy certificate is valid for at least HOURS hours and MINUTES minutes. If it's not, grid-proxy-info will exit with exit code 1. not passing the vibe check = bye 💀
• -bits BITS, -b BITS — checks that the proxy certificate key strength is at least BITS bits.

🧚 ENVIRONMENT 🧚

these environment variables affect how grid-proxy-info runs, bestie:

• X509_USER_PROXY — path to the default user proxy. 🌸

⭐ SEE ALSO ⭐

grid-proxy-init(1), grid-proxy-destroy(1)

🎀 AUTHOR 🎀

Copyright © 1999-2014 University of Chicago

okay that's the whole page, love you, go check your proxy 💖

Grid Community Toolkit 6 🌈 03/31/2018 🦋 mwah, bye bestie ✨