AU_BSM_TO_SOCKET_TYPE(3)

💅 au_bsm_to_socket_type, au_socket_type_to_bsm 💅

okay bestie, so this is a page from libbsm — that's the Basic Security Module Library — and it lives in section 3 of the manual, the whole "library functions" girlie section. buckle up, we're talking socket types today 🧦

---

🌸 NAME 🌸

au_bsm_to_socket_type, au_socket_type_to_bsm — the glow-up translators that convert between BSM and local socket types ✨

🦋 LIBRARY 🦋

Basic Security Module Library (libbsm, -lbsm) — she's giving main character energy, link her with -lbsm 💖

🎀 SYNOPSIS 🎀

#include <bsm/libbsm.h>

int
au_bsm_to_socket_type(u_short bsm_socket_type, int *local_socket_typep);

u_short
au_socket_type_to_bsm(int local_socket_type);

✨ DESCRIPTION ✨

so these two interfaces are literally your little conversion duo 🫶 they take you back and forth between local socket types and BSM socket types, no cap.

au_bsm_to_socket_type() takes a BSM socket type, bsm_socket_type, and converts it into a local socket type — like the ones you'd pass to socket(2) — and if it works, that converted value gets stored in the integer that local_socket_typep points at 💾. but listen: this call will fail if the BSM socket type can't be mapped into a local socket type 😭 and that can happen when the socket token was generated on a different operating system. so like, cross-OS drama, not her fault.

au_socket_type_to_bsm() is the chill one 💅 she takes a local socket type and returns the BSM socket type for it. this call cannot fail — instead it returns a BSM socket type that tells a later decoder "yeah bestie, the socket type could not be encoded" 🙈 iconic behavior honestly.

⭐ RETURN VALUES ⭐

on success, au_bsm_to_socket_type() returns 0 plus a converted socket type 🎉 on failure, it returns -1 — but it does not set errno(2). yes, you read that right, no errno for you 🫠

on success, au_strerror() returns a pointer to an error string; on failure it will return NULL 🕳️

ngl that second paragraph is straight from the page and it does talk about au_strerror(), not the socket functions. keep that in your notes, don't @ me 💀

🔥 SEE ALSO 🔥

• au_bsm_to_domain(3)
• au_domain_to_bsm(3)
• au_to_socket_ex(3)
• libbsm(3)

🌈 HISTORY 🌈

au_bsm_to_socket_type() and au_socket_type_to_bsm() were introduced in OpenBSM 1.1 — vintage, but make it cute 🎀

👑 AUTHORS 👑

these functions were implemented by Robert Watson under contract to Apple Inc. 🍎

and the Basic Security Module (BSM) interface to audit records and audit event stream format were defined by Sun Microsystems ☀️

---

mwah 💋 this page came from the Debian crew, dated December 28, 2008 — yeah she's an elder but she still slays, and that's the whole manual page, periodt. 🌸🦋💜