This manual page is for Mac OS X version 10.6

Reading manual pages

AU_BSM_TO_DOMAIN(3)                     BSD Library Functions Manual                     AU_BSM_TO_DOMAIN(3)

NAME
     au_bsm_to_domain, au_domain_to_bsm -- convert between BSM and local protocol domains

LIBRARY
     Basic Security Module Library (libbsm, -lbsm)

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.  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 suc-cessful. successful.
     cessful.  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.

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).

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.

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.

BSD                                           December 28, 2008                                          BSD