myproxy-admin-query(8)

✨ myproxy-admin-query ✨

okay bestie, welcome to the myproxy-admin-query page, part of the MyProxy manual collection (section 8, admin girlies only 💅). sit down, hydrate, and let's go through ur credential repository together 🫶

🌸 NAME 🌸

myproxy-admin-query — literally just peek inside ur MyProxy repository and see what's in there 👀

🦋 SYNOPSIS 🦋

myproxy-admin-query [ options ]

💖 DESCRIPTION 💖

so the myproxy-admin-query command displays information about the credentials stored in the MyProxy repository. that's the main character job. but wait, there's more — you can also use it to remove credentials from the repository by combining query options with --remove. two-for-one, we love that for us ✨

it accesses the repository directly, no middleman, no server handshake, nothing. which means it must be run on the machine where the myproxy-server(8) is installed, and it has to run from the account that owns the repository. no borrowing ur friend's account for this one, sorry babe 🙈

also!! there's an example cron job for running myproxy-admin-query periodically to remove invalid (expired, revoked, etc.) credentials from the repository, and it lives at $GLOBUS_LOCATION/share/myproxy/myproxy.cron. set it and forget it, iconic behavior 👑

✨ OPTIONS ✨

• -h, --help — shows u the command usage text and then dips. that's it, that's the whole job 💅
• -u, --usage — also shows u the command usage text and exits. yes it's basically the same vibe as -h, they're both here, don't ask 🎀
• -v, --verbose — turns on verbose debugging output straight to ur terminal. chaos mode but make it informative 🔥
• -V, --version — prints the version info and bounces. quick little flex ⭐
• -l username, --username username — returns info on the credentials for one single username. by default tho, the command returns info on all credentials for all usernames, so this is ur narrowing-down bestie 🌸
• -k name, --credname name — returns info on the credentials that have the specified name. name drop only 🎀
• -o DN, --owner DN — returns info on the credentials owned by the specified distinguished name. fancy DN girlies rise up 👑
• -e hours, --expiring_in hours — returns info on credentials whose remaining lifetime is less than the number of hours u give it. for example, -e 0 will return all expired credentials. expired era 💀
• -t hours, --time_left hours — returns info on credentials whose remaining lifetime is greater than the number of hours u give it. the opposite energy of -e, we stan a balanced pair 🦋
• -i, --invalid — returns info on invalid (expired, revoked, etc.) credentials. the messy ones 🫶
• -s dir, --storage dir — specifies the location of the credential storage directory. > heads up bestie: for security reasons the directory must be accessible only by the user running the myproxy-server process. no sharing, no peeking, no exceptions 🔒 default is /var/lib/myproxy or /var/myproxy or $GLOBUS_LOCATION/var/myproxy
• -c file, --config file — specifies the location of the myproxy-server configuration file, used for OCSP options. default is /etc/myproxy-server.config or $GLOBUS_LOCATION/etc/myproxy-server.config 🧚
• -r, --remove — removes the credentials matching the query from the repository. for example, myproxy-admin-query -e 0 -r will remove all expired credentials from the repository. spring cleaning, but for certs 🧹✨
• -L 'msg', --lock 'msg' — places the credentials matching the query under an administrative lock and specifies a message that gets returned on access attempts. > bestie pls put the message in quotes so it gets captured as one argument to the command. quotes are not optional here, they're the whole point 🙏
• -U, --unlock — removes any administrative locks for the credentials matching the query. lock off, freedom restored 🕊️

🌈 EXIT STATUS 🌈

• 0 on success 🎉
• >0 on error 😭

💜 AUTHORS 💜

see http://grid.ncsa.illinois.edu/myproxy/about for the list of MyProxy authors. go say hi to the legends who built this 👑

🔥 SEE ALSO 🔥

myproxy-change-pass-phrase(1), myproxy-destroy(1), myproxy-init(1), myproxy-logon(1), myproxy-retrieve(1), myproxy-store(1), myproxy-server.config(5), myproxy-admin-adduser(8), myproxy-admin-change-pass(8), myproxy-admin-load-credential(8), myproxy-server(8)

and that's the whole page bestie 💖 this came from the MyProxy peeps, dated 2011-09-19. go query ur repo responsibly, mwah 🎀💅