RPC_GSS_GETCRED(3)

📦 version 15.1, in freebsd 14.5, freebsd 15.1

✨ NAME ✨

rpc_gss_getcred — Get authorization information for an RPC request. That’s the whole vibe, bestie: you’re pulling the auth info for an RPC request, and this function is the main character. 💅

okay so this is the RPC_GSS_GETCRED(3) page from the Library Functions Manual, and it’s here to explain the creds situation. 🫶

📚 LIBRARY 📚

RPC GSS-API Authentication Library (librpcsec_gss, -lrpcsec_gss). Slay, that’s the library you’re linking against. ✨

🛠 SYNOPSIS 🛠

#include <rpc/rpcsec_gss.h>

AUTH *
rpc_gss_getcred(struct svc_req *req, rpc_gss_rawcred_t **rcred,
    rpc_gss_ucred_t **ucred, void **cookie);

💖 DESCRIPTION 💖

This function returns the RPCSEC_GSS authenticated credentials associated with an RPC request. No cap, that’s literally the whole function’s job. 🔥

🎀 PARAMETERS 🎀

  • req — The RPC request to query. This is the request you’re asking about. 👑
  • rcred — If non-null, *rcred is set to point at the raw credentials for this request.
  • ucred — (the original page leaves this one with no description here, so I’m not inventing one 🫶)
  • rcred — If non-null, *ucred is set to point at the corresponding unix credentials. Yes, the label shows up twice in the original — I’m preserving the whole thing exactly, bestie 💅
  • cookie — If non-null, *cookie is set to the cookie value returned by a callback function registered with rpc_gss_set_callback(). 🍪

🌈 RETURN VALUES 🌈

Returns TRUE if successful, FALSE otherwise. That’s it — iconic binary behavior. ⭐

🦋 SEE ALSO 🦋

Go read those too if you want the full lore. iykyk. 🧚

💜 HISTORY 💜

The rpc_gss_getcred function first appeared in FreeBSD 8.0. A historic moment, honestly. 🎀

👑 AUTHORS 👑

This manual page was written by Doug Rabson <dfr@FreeBSD.org>. Respect the author, bestie. 🫶

mwah 💋 — this one’s from Debian, dated January 26, 2010, and it’s the RPC_GSS_GETCRED(3) page. Bye bestie! 🎀✨

📦 where this page comes from