AU_BSM_TO_DOMAIN(3)

💅 AU_BSM_TO_DOMAIN(3) — bestie edition 💅

okay so this page is from the Library Functions Manual, and the whole vibe is AU_BSM_TO_DOMAIN(3). We're converting between BSM and local protocol domains, and yes it's giving niche-but-iconic 💖

🌸 NAME 🌸

au_bsm_to_domain, au_domain_to_bsm — convert between BSM and local protocol domains. literally their whole job 🫶

✨ LIBRARY ✨

Basic Security Module Library (libbsm, -lbsm) — that's the library bestie, no cap 🎀

🦋 SYNOPSIS 🦋

#include <bsm/libbsm.h>

int
au_bsm_to_domain(u_short bsm_domain, int *local_domainp);

u_short
au_domain_to_bsm(int local_domain);

💜 DESCRIPTION 💜

These interfaces may be used to convert between the local and BSM protocol domains. They're your little converter besties ✨

The au_bsm_to_domain() function accepts a BSM domain, bsm_domain, and converts it to a local domain, such as those passed to socket(2), that will be stored in the integer pointed to by local_domainp if successful. This call will fail if the BSM domain cannot be mapped into a local domain, which may occur if the socket token was generated on another operating system. so yeah, cross-OS socket token? it can lowkey fail 😭

The au_domain_to_bsm() function accepts a local domain, and returns the BSM domain for it. This call cannot fail, and instead returns a BSM domain indicating to a later decoder that the domain could not be encoded. no failure era for this one, it just sends the "couldn't encode" signal forward 💅

💀 RETURN VALULES 💀

On success, au_bsm_to_domain() returns 0 and a converted domain; on failure, it returns -1 but does not set errno(2). so like, it's failing but not giving errno any info — noted, bestie 🙈

🌈 SEE ALSO 🌈

au_bsm_to_socket_type(3), au_socket_type_to_bsm(3), au_to_socket_ex(3), libbsm(3) — go read the whole friend group 🫶

⭐ HISTORY ⭐

au_bsm_to_domain() and au_domain_to_bsm() were introduced in OpenBSM 1.1. iconic little debut ✨

👑 AUTHORS 👑

These functions were implemented by Robert Watson under contract to Apple Inc. 💖

The Basic Security Module (BSM) interface to audit records and audit event stream format were defined by Sun Microsystems. periodt 🌸

---

source/version: Debian 🎀 date: December 28, 2008 🦋 page: AU_BSM_TO_DOMAIN(3) 💅 that's the whole footer, mwah 💋