GSP
Quick Navigator

Search Site

Unix VPS
A - Starter
B - Basic
C - Preferred
D - Commercial
MPS - Dedicated
Previous VPSs
* Sign Up! *

Support
Contact Us
Online Help
Handbooks
Domain Status
Man Pages

FAQ
Virtual Servers
Pricing
Billing
Technical

Network
Facilities
Connectivity
Topology Map

Miscellaneous
Server Agreement
Year 2038
Credits
 

USA Flag

 

 

Man Pages


Manual Reference Pages  -  AU_ERRNO_TO_BSM (3)

NAME

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

CONTENTS

Library
Synopsis
Description
Return Valules
See Also
History
Authors
Bugs

LIBRARY


.Lb libbsm

SYNOPSIS


.In 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
.An 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.
Search for    or go to Top of page |  Section 3 |  Main Index


Powered by GSP Visit the GSP FreeBSD Man Page Interface.
Output converted with manServer 1.07.