au_bsm_to_socket_type(3) BSD Library Functions Manual au_bsm_to_socket_type(3)
NAME
au_bsm_to_socket_type, au_socket_type_to_bsm -- convert between BSM and
local socket types
LIBRARY
Basic Security Module Library (libbsm, -lbsm)
SYNOPSIS
#include <bsm/libbsm.h>
int
au_bsm_to_socket_type(u_short bsm_socket_type, int *local_socket_typep);
u_short
au_socket_type_to_bsm(int local_socket_type);
DESCRIPTION
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.
RETURN VALULES
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 fail-
ure it will return NULL.
SEE ALSO
au_bsm_to_domain(3), au_domain_to_bsm(3), au_to_socket_ex(3), libbsm(3)
HISTORY
au_bsm_to_socket_type() and au_socket_type_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
Mac OS X 10.8 - Generated Sun Aug 26 13:20:08 CDT 2012