RPC_GSS_GET_PRINCIPAL_NAME(3)

📦 version 15.1, in freebsd 14.5, freebsd 15.1

💅 RPC_GSS_GET_PRINCIPAL_NA(3) 💅

okay so bestie, welcome to a page straight out of the Library Functions Manual — yes, that's the manual section it lives in, and yes, the header on this one is literally RPC_GSS_GET_PRINCIPAL_NA(3) (the name got cut off at the end, iconic truncation behaviour honestly, don't @ me). sit down, grab a lil drink, we're learning how to build a principal name ✨

🌸 NAME 🌸

rpc_gss_get_principal_name — get a principal name. that's it, that's the whole vibe 🎀

🦋 LIBRARY 🦋

RPC GSS-API Authentication Library (librpcsec_gss, -lrpcsec_gss) — like, that's the lib you gotta link against, no cap 🫶

✨ SYNOPSIS ✨

#include <rpc/rpcsec_gss.h>

bool_t
rpc_gss_get_principal_name(rpc_gss_principal_t *principal,
    const char *mech, const char *name, const char *node,
    const char *domain);

💖 DESCRIPTION 💖

okay so this function can be used to generate a client principal name out of a bunch of different strings. that's literally what it does. it takes your lil string pieces and assembles them into a principal. main character energy 🔥

🧚 PARAMETERS 🧚

  • principal — if the principal gets created successfully (slay), *principal will be set to point at the brand new principal, in GSS-API exported name form. like, it's handed to you pre-wrapped. periodt 👑
  • mech — the name of the mechanism for this principal. which mechanism, bestie? that one. 🦋
  • name — the name part of the principal. yeah. the name part. ground-breaking, i know 💀
  • node — if it's non-null, this is the hostname or instance part of the principal. if it's null, well... it just isn't, and that's fine 🙈
  • domain — if it's non-null, this is the domain or realm part of the principal. same deal, null means it's not contributing today 💅

🌈 RETURN VALUES 🌈

Returns TRUE if the principal was created, or FALSE otherwise. binary queen. we love a clean boolean 🍓

⭐ SEE ALSO ⭐

go read those next, iykyk 📚

👑 HISTORY 👑

The rpc_gss_get_principal_name function first appeared in FreeBSD 8.0. so she's been around. a legacy icon honestly 🎀

💜 AUTHORS 💜

This manual page was written by Doug Rabson <dfr@FreeBSD.org>. thank you doug, king behaviour 🫶

💀 friendly reminder bestie: node and domain are only used when they're non-null. the manual says exactly that and nothing more, so don't come for me with the "but what happens if..." questions, i am simply relaying the facts ✨

and that's the whole page!! 💅 this lil beauty came from the Debian crew, dated January 26, 2010, and lives in section 3 under the name RPC_GSS_GET_PRINCIPAL_NAME(3). bye bestie, go build some principals 🦋🌸💖

📦 where this page comes from