RPC_GSS_SET_SVC_NAME(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_SET_SVC_NAME(3) 💖

okay bestie, so this is a page from the Library Functions Manual — it's rpc_gss_set_svc_name, and it's literally the glow-up your RPC service needs to get a GSS-API service principal attached to it. let's get into it 🎀

✨ NAME ✨

rpc_gss_set_svc_name — Associate a GSS-API service principal with an RPC service

🌸 SYNOPSIS 🌸

#include <rpc/rpcsec_gss.h>

bool_t
rpc_gss_set_svc_name(const char *principal, const char *mechanism,
    u_int req_time, u_int program, u_int version);

💅 DESCRIPTION 💅

This function registers a service principal which will be used to authenticate RPCSEC_GSS security contexts for a given RPC program and version. that's it, that's the whole vibe — you hand it a principal, it makes it the identity for that program+version combo, and RPCSEC_GSS contexts get checked against it. iconic behavior, no cap 👑

🦋 PARAMETERS 🦋

  • principal — a string representing the service principal, and it has to be in the form "service@hostname". yes the @ is mandatory, don't skip it 💀
  • mechanism — the name of the security mechanism
  • req_time — the time in seconds that the service credentials should remain valid. peep gss_acquire_cred(3) for more details. principal.
  • program — RPC program number for this service
  • version — RPC program version for this service
not me pointing out that stray "principal." at the end of req_time — it's in the original, so it stays, bestie 🙈 copy the source, not the typo-eraser

⭐ RETURN VALUES ⭐

Returns TRUE if the service principal was registered or FALSE otherwise. binary. yes or no. slay or flop. that's the whole return contract 💖

🌈 AVAILABILITY 🌈

The rpc_gss_set_svc_name() function is part of libtirpc. so if you're missing it, that's a linking situation, not a you problem 🫶

👑 SEE ALSO 👑

rpc(3), gssapi(3), gss_acquire_cred(3), rpcsec_gss(3)

🎀 AUTHORS 🎀

This manual page was written by Doug Rabson <dfr@FreeBSD.org>. thank you Doug, absolute legend, we stan 💜

and that's the whole page, bestie!! this manual page came to you from Debian, dated January 26, 2010 — vintage but still serving looks ✨ go register that principal, mwah 💋

📦 where this page comes from