RPC_GSS_SET_SVC_NAME(3)

📦 version 15.1, in freebsd 14.5, freebsd 15.1

💅 rpc_gss_set_svc_name(3) — Associate a GSS-API service principal with an RPC service

okay so bestie, welcome to rpc_gss_set_svc_name(3) from the Library Functions Manual — this one is short, sweet, and very much about making RPC security know who it is. ✨

🌸 NAME

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

💖 LIBRARY

RPC GSS-API Authentication Library (librpcsec_gss, -lrpcsec_gss) — like, that's the whole library vibe, no cap. 🫶

✨ 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. It's giving "put this identity on the guest list so the security handshake knows what's up." 💅

🎀 PARAMETERS

  • principal — A string representing the service principal in the form "service@hostname" — yes, exactly that shape, bestie. 🌸
  • mechanism — The name of the security mechanism. 🔐
  • req_time — The time in seconds that the service credentials should remain valid. See gss_acquire_cred(3) for more details. principal. (and yes, that trailing principal. is right there in the original — keeping every detail, periodt.) 😭
  • program — RPC program number for this service. 📟
  • version — RPC program version for this service. 🏷️

🌈 RETURN VALUES

Returns TRUE if the service principal was registered or FALSE otherwise. Simple vibe check: TRUE = slay, FALSE = not slay. ✅💀

👑 SEE ALSO

Go check out gss_acquire_cred(3), gssapi(3), rpc(3), and rpcsec_gss(3) — the whole friend group is linked here. 🔗✨

🧚 HISTORY

The rpc_gss_set_svc_name function first appeared in FreeBSD 8.0. throwback era, honestly. 🕰️

💜 AUTHORS

This manual page was written by Doug Rabson <dfr@FreeBSD.org>. credited and iconic. 👑

mwah 💋 — this little page comes to you from Debian, dated January 26, 2010, with the footer id RPC_GSS_SET_SVC_NAME(3). That's the whole manual, bestie — facts intact, vibe immaculate. 🎀🦋💖

📦 where this page comes from