au_fcntl_cmd_t_bsm(3) [freebsd man page]

AU_BSM_TO_FCNTL_CMD(3)					   BSD Library Functions Manual 				    AU_BSM_TO_FCNTL_CMD(3)

NAME

     au_bsm_to_fcntl_cmd, au_fcntl_cmd_to_bsm -- convert between BSM and local fcntl(2) command values

LIBRARY

     Basic Security Module Library (libbsm, -lbsm)

SYNOPSIS

     #include <bsm/libbsm.h>

     int
     au_bsm_to_fcntl_cmd(u_short bsm_fcntl_cmd, int *local_fcntl_cmdp);

     u_short
     au_fcntl_cmd_to_bsm(int local_fcntl_cmd);

DESCRIPTION

     These interfaces may be used to convert between the local and BSM fcntl(2) command values.  The au_bsm_to_fcntl_cmd() function accepts a BSM
     command value, bsm_fcntl_cmd, and converts it to a local command value passed to fcntl(2), that will be stored in the integer pointed to by
     local_fcntl_cmdp if successful.  This call will fail if the BSM command value cannot be mapped into a local fcntl(2) command value which may
     occur if the command token was generated on another operating system.

     The au_fcntl_cmd_to_bsm() function accepts a local fcntl(2) command value, and returns the BSM fcntl(2) command value for it.  This call can-
     not fail, and instead returns a BSM command value indicating to a later decoder that the command value could not be encoded.

RETURN VALUES

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

SEE ALSO

     fcntl(2), au_bsm_to_domain(3), au_domain_to_bsm(3), au_bsm_to_socket_type(3), au_socket_type_to_bsm(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 Stacey Son 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
								   March 5, 2009							       BSD

AU_BSM_TO_ERRNO(3)					   BSD Library Functions Manual 					AU_BSM_TO_ERRNO(3)

NAME

     au_bsm_to_errno, au_errno_to_bsm, au_strerror -- convert between BSM and local error numbers

LIBRARY

     Basic Security Module Library (libbsm, -lbsm)

SYNOPSIS

     #include <bsm/libbsm.h>

     int
     au_bsm_to_errno(u_char bsm_error, int *errorp);

     u_char
     au_errno_to_bsm(int error);

     const char *
     au_strerror(int bsm_error);

DESCRIPTION

     These interfaces may be used to convert between the local ( errno(2)) and BSM error number spaces found in BSM return tokens.

     The au_bsm_to_errno() function accepts a BSM error value, bsm_error, and converts it to an errno(2) that will be stored in the integer
     pointed to by errorp if successful.  This call will fail if the BSM error cannot be mapped into a local error number, which may occur if the
     return token was generated on another operating system.

     The au_errno_to_bsm() function accepts a local errno(2) value, and returns the BSM error number for it.  This call cannot fail, and instead
     returns a BSM error number indicating to a later decoder that the error could not be encoded.

     The au_strerror() function converts a BSM error value to a string, generally by converting first to a local error number and using the local
     strerror(3) function, but will also work for errors that are not locally defined.

RETURN VALULES

     On success, au_bsm_to_errno() returns 0 and a converted error value; 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.

SEE ALSO

     au_to_return(3), au_to_return32(3), au_to_return64(3), libbsm(3)

HISTORY

     au_bsm_to_errno() and au_errno_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.

BUGS

     au_strerror is unable to provide localized strings for errors not available in the local operating system.

BSD
								 December 8, 2008							       BSD