RPC_GSS_MECH_TO_OID(3)

📦 version 15.1, in freebsd 14.5, freebsd 15.1

💅 RPC_GSS_MECH_TO_OID(3) — like, the manual page bestie

okay so real talk: this is RPC_GSS_MECH_TO_OID(3), a page from the Library Functions Manual (section 3, functions, you know the vibe), and it's here to teach you how to turn a mechanism name into a GSS-API oid. yes, that's the whole plot. it's a short one. we love a concise queen. 🎀

✨ NAME ✨

rpc_gss_mech_to_oid — bestie, it converts a mechanism name into a GSS-API oid. that's it. that's the job. 💅

📚 LIBRARY 📚

RPC GSS-API Authentication Library (librpcsec_gss, -lrpcsec_gss)

so when you link this, you're linking against librpcsec_gss and the flag is -lrpcsec_gss. write it down. put it in your notes app. 🫶

🦋 SYNOPSIS 🦋

#include <rpc/rpcsec_gss.h>

bool_t
rpc_gss_mech_to_oid(const char *mech, gss_OID *oid_ret);

look at her go. #include <rpc/rpcsec_gss.h>, function returns bool_t, takes a const char *mech and a gss_OID *oid_ret. iconic signature tbh. ⭐

💖 DESCRIPTION 💖

no cap, this function is a little detective. it looks up a mechanism by name by reading the file /etc/gss/mech. that's the source of truth, that's where it goes shopping. literally just opens that file and searches. simple. elegant. she ate. 🔥

heads up bestie: the lookup is driven by /etc/gss/mech, so if that file doesn't have what you're looking for, neither does this function. 😭

🌸 PARAMETERS 🌸

  • mech — the mechanism name you're searching for. the thing you're hunting. the main character of the search. 👑
  • oid_ret — if the mechanism is found, the corresponding GSS-API oid gets returned in *oid_ret. so you pass in a pointer-to-oid and she fills it in for you. give her somewhere to put the goods. 💜

🌈 RETURN VALUES 🌈

if the mechanism is found, TRUE is returned. otherwise FALSE. that's the whole vibe check — TRUE or FALSE, found or not found, slay or no slay. 💀

🧚 SEE ALSO 🧚

go read those next, iykyk. 📖✨

🍓 HISTORY 🍓

the rpc_gss_mech_to_oid function first appeared in FreeBSD 8.0. a legend was born. 🎀

🐚 AUTHORS 🐚

this manual page was written by Doug Rabson <dfr@FreeBSD.org>. thank you Doug, we appreciate you fr fr. 🫶

okay that's the whole page bestie, big hugs, go convert some mechanism names — and remember this is the Debian version of the page, dated January 26, 2010, so it's vintage and that's on periodt. 💅🌸💖

📦 where this page comes from