tail head cat sleep
QR code linking to this page



au_bsm_to_socket_type, au_socket_type_to_bsm – convert between BSM and local socket types



Basic Security Module User Library (libbsm, -lbsm)


#include <bsm/libbsm.h>

au_bsm_to_socket_type(u_short bsm_socket_type, int *local_socket_typep);

au_socket_type_to_bsm(int local_socket_type);


These interfaces may be used to convert between the local and BSM socket types. The au_bsm_to_socket_type() function accepts a BSM socket type, bsm_socket_type, and converts it to a local socket type, such as those passed to socket(2), that will be stored in the integer pointed to by local_socket_typep if successful. This call will fail if the BSM socket type cannot be mapped into a local socket type, which may occur if the socket token was generated on another operating system.

au_socket_type_to_bsm() function accepts a local socket type, and returns the BSM socket type for it. This call cannot fail, and instead returns a BSM socket type indicating to a later decoder that the socket type could not be encoded.


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

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


au_bsm_to_domain(3), au_domain_to_bsm(3), au_to_socket_ex(3), libbsm(3)


au_bsm_to_socket_type() and au_socket_type_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_SOCKET_TYPE (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.

Ken Thompson has an automobile which he helped design. Unlike most automobiles, it has neither speedometer, nor gas gauge, nor any of the other numerous idiot lights which plague the modern driver. Rather, if the driver makes a mistake, a giant “?” lights up in the center of the dashboard. “The experienced driver,” says Thompson, “will usually know what's wrong.”