myproxy-destroy(1)

✨ myproxy-destroy ✨

okay bestie, welcome to myproxy-destroy(1), part of the MyProxy fam 💖 this is the little command that yeets a credential OUT of the repository. let's go 🦋

🌸 NAME 🌸

myproxy-destroy — remove a credential from the repository 💅

🎀 SYNOPSIS 🎀

myproxy-destroy [ options ]

👑 DESCRIPTION 👑

so basically? myproxy-destroy removes a credential from the myproxy-server(8) that somebody stored earlier using myproxy-init(1). gone. deleted. no cap 🫶

and the way that you need a valid proxy credential to run this at all?? yeah. you gotta have one, either generated by grid-proxy-init or retrieved by myproxy-logon(1). no proxy, no destroy. that's the vibe check 🔥

💅 OPTIONS 💅

• -h, --help — shows you the command usage text and then dips out. that's it, that's the whole thing ✨
• -u, --usage — also shows the command usage text and exits. yeah bestie, it's giving twins, it's giving same energy 💀
• -v, --verbose — turns ON verbose debugging output to your terminal. loud and proud, all the little details coming through 🌈
• -V, --version — displays version info and exits. cute lil flex 👑
• -s hostname[:port], --pshost hostname[:port] — tells it the hostname(s) of the myproxy-server(s). you can drop multiple hostnames in a comma-separated list, and each hostname can optionally be followed by a ':' and a port number. this option is required if the MYPROXY_SERVER environment variable isn't defined. if you DO specify it, it overrides MYPROXY_SERVER. and if you give a port number next to a hostname, that port overrides the -p option AND the MYPROXY_SERVER_PORT environment variable — for that host specifically 🎯
• -p port, --psport port — the TCP port number of the myproxy-server(8). default is 7512 ⭐
• -l, --username — picks the MyProxy account under which the credential you're destroying is stored. by default the command just uses whatever's in the LOGNAME environment variable. use this option when you need a different account username on the MyProxy server. and no, the MyProxy username doesn't have to match a real Unix username — it's not that deep 🦋
• -d, --dn_as_username — uses the certificate subject (the DN) as the default username, instead of the LOGNAME environment variable 🙈
• -k name, --credname name — specifies the name of the credential to be destroyed 💖

💀 EXIT STATUS 💀

0 on success, >0 on error. slay when it's zero, sad when it's not 😭

🧚 ENVIRONMENT 🧚

• GLOBUS_GSSAPI_NAME_COMPATIBILITY — by default this client does a reverse-DNS lookup to figure out the FQHN (Fully Qualified Host Name), and uses that to verify the identity of the server by checking the FQHN against the CN in the server's certificate. set this variable to STRICT_RFC2818 and the reverse-DNS lookup will NOT be performed — instead the user-specified name gets used. heads up tho: this variable setting gets ignored if MYPROXY_SERVER_DN (described later) is set 👀
• MYPROXY_SERVER — the hostname(s) where the myproxy-server(8) is running. multiple hostnames can go in a comma separated list, each one optionally followed by a ':' and a port number. this env var can be used in place of the -s option 🌸
• MYPROXY_SERVER_PORT — the port where the myproxy-server(8) is running. this env var can be used in place of the -p option 🌈
• MYPROXY_SERVER_DN — the distinguished name (DN) of the myproxy-server(8). every MyProxy client program authenticates the server's identity. by default MyProxy servers run with host credentials, so MyProxy client programs expect the server to have a distinguished name with /CN=host/<fqhn> or /CN=myproxy/<fqhn> or /CN=<fqhn> (where <fqhn> is the fully-qualified hostname of the server). if your server is running with some other DN, set this environment variable to tell the MyProxy clients to accept the alternative DN. also peep GLOBUS_GSSAPI_NAME_COMPATIBILITY above 👆
• MYPROXY_TCP_PORT_RANGE — a range of valid port numbers in the form "min,max" for the client side of the network connection to the server. by default the client binds to any available port. use this env var to restrict the ports used to a range your firewall actually allows 🔥 if unset, MyProxy follows the setting of the GLOBUS_TCP_PORT_RANGE environment variable.
• X509_USER_CERT — a non-standard location for the certificate used for authentication to the myproxy-server(8) 🎀
• X509_USER_KEY — a non-standard location for the private key used for authentication to the myproxy-server(8) 🔑
• X509_USER_PROXY — a non-standard location for the proxy credential used for authentication to the myproxy-server(8) 🫶
• X509_CERT_DIR — a non-standard location for the CA certificates directory 📁

💜 AUTHORS 💜

see http://grid.ncsa.illinois.edu/myproxy/about for the list of MyProxy authors. iconic of them, honestly 👑

🌟 SEE ALSO 🌟

myproxy-change-pass-phrase(1), myproxy-get-trustroots(1), myproxy-info(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-admin-query(8), myproxy-server(8)

and that's the whole page bestie 🥰 this one's brought to you by MyProxy, dated 2009-12-1, and the manual page itself is myproxy-destroy(1). go forth and destroy (credentials only, please) 💅✨