tail head cat sleep
QR code linking to this page

Manual Pages  — AU_BSM_TO_DOMAIN


au_bsm_to_domain, au_domain_to_bsm – convert between BSM and local protocol domains



Basic Security Module User Library (libbsm, -lbsm)


#include <bsm/libbsm.h>

au_bsm_to_domain(u_short bsm_domain, int *local_domainp);

au_domain_to_bsm(int local_domain);


These interfaces may be used to convert between the local and BSM protocol domains. 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.

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.


On success, au_bsm_to_domain() returns 0 and a converted domain; on failure, it returns -1 but does not set errno(2).


au_bsm_to_socket_type(3), au_socket_type_to_bsm(3), au_to_socket_ex(3), libbsm(3)


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


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.

AU_BSM_TO_DOMAIN (3) December 28, 2008

tail head cat sleep
QR code linking to this page

Please direct any comments about this manual page service to Ben Bullock. Privacy policy.

One of the advantages of using UNIX to teach an operating systems course is the sources and documentation will easily fit into a student's briefcase.
— John Lions