AU_BSM_TO_DOMAIN(3)

🌸 NAME 🌸

okay so bestie, you're reading AU_BSM_TO_DOMAIN(3) from the Library Functions Manual, and it's literally about au_bsm_to_domain, au_domain_to_bsm — convert between BSM and local protocol domains. 💅

🎀 LIBRARY 🎀

Basic Security Module Library (libbsm, -lbsm) — that's the library line, bestie. 🫶

✨ 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 are your little conversion station between the local and BSM protocol domains, no cap.

So au_bsm_to_domain() takes a BSM domain called bsm_domain, converts it into a local domain — like the kind you pass to socket(2) — and if it works, tucks that converted value into the integer that local_domainp points at. 🦋

Heads up: this call fails if the BSM domain can't be mapped into a local domain — that can happen when the socket token was generated on another operating system. 😭

Then au_domain_to_bsm() flips it: it takes a local domain and returns the BSM domain for it. This call cannot fail, and instead returns a BSM domain that tells a later decoder the domain could not be encoded. Iconic non-failure behavior, honestly. ✨

🔥 RETURN VALUES 🔥

Success slay: au_bsm_to_domain() returns 0 and gives you a converted domain. Failure era: it returns -1, but plot twist, it does not set errno(2). 💀

🌈 SEE ALSO 🌈

• au_bsm_to_socket_type(3)
• au_socket_type_to_bsm(3)
• au_to_socket_ex(3)
• libbsm(3)

🦋 HISTORY 🦋

au_bsm_to_domain() and au_domain_to_bsm() were introduced in OpenBSM 1.1. periodt. 👑

👑 AUTHORS 👑

These functions were implemented by Robert Watson under contract to Apple Inc. — main character implementation energy. 💅

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

---

💖 and that's the page, bestie! brought to you by Debian, dated December 28, 2008, under the AU_BSM_TO_DOMAIN(3) manual banner. mwah. 🎀