RPC_GSS_GETCRED(3)

📦 version 1.3.8, in alpine 3.22, alpine 3.23, alpine 3.24, arch rolling, centos-stream 10, centos-stream 9, debian bookworm, debian trixie, fedora 43, fedora 44, nixos 26.05, nixpkgs unstable, opensuse-leap 16.0, ubuntu jammy, ubuntu noble, ubuntu questing, ubuntu resolute, ubuntu stonking

💖 RPC_GSS_GETCRED 💖

okay bestie, this is the rpc_gss_getcred page from the Library Functions Manual, and it's literally the moment your RPC request gets its whole identity confirmed. no cap. 🫶

✨ NAME ✨

rpc_gss_getcred — Get authorization information for an RPC request

like... it's giving "who even are you and what are you allowed to do" but in a helpful way 💅

🌸 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);

there she is. four args, one AUTH * coming back at you, iconic behavior honestly ✨

🦋 DESCRIPTION 🦋

So the way that this works is: this function returns the RPCSEC_GSS authenticated credentials that are associated with an RPC request. that's it. that's the whole vibe. it's the bouncer checking the guest list and handing you the receipts. 👑

🎀 PARAMETERS 🎀

  • req — The RPC request to query. this is the request you're being nosy about, respectfully. 🔍
  • rcred — If non-null, *rcred is set to point at the raw credentials for this request. lowkey the main character of the whole function tbh.
  • ucred — If non-null, *ucred is set to point at the corresponding unix credentials. the unix-flavored cousin of the raw creds 🍓
  • cookie — If non-null, *cookie is set to the cookie value returned by a callback function registered with rpc_gss_set_callback(). yes, a literal cookie. i'm not making this up and i'm obsessed 😭🍪
pro tip from the page itself: every one of those last three is optional — if you pass null, that thing just doesn't get set. pass what you need, skip what you don't. ✨

💜 RETURN VALUES 💜

Returns TRUE if successful, FALSE otherwise.

that's it. no gray area. it either ate or it didn't. 💀

🌈 AVAILABILITY 🌈

The rpc_gss_getcred() function is part of libtirpc.

so if you're out here wondering where she lives — that's the address, bestie. 🏠

🔥 SEE ALSO 🔥

go read the whole friend group, they all link up iykyk 🫶

👑 AUTHORS 👑

This manual page was written by Doug Rabson <dfr@FreeBSD.org>.

king behavior, thank you for your service 🫡

💅 SIGN-OFF 💅

and that's the tea, bestie — this one's a Debian page, dated January 26, 2010, and she still hits. go get those credentials, you got this ✨🎀💖

📦 where this page comes from