GSP
Quick Navigator

Search Site

Linux 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_EVENT (3)

NAME

free_au_event_ent, setauevent, endauevent, getauevent, getauevent_r, getauevnam, getauevnam_r, getauevnum, getauevnum_r, getauevnonam, getauevnonam_r - look up information from the audit_event database

CONTENTS

Library
Synopsis
Description
Return Values
See Also
History
Authors
Bugs

LIBRARY


.Lb libbsm

SYNOPSIS


.In bsm/libbsm.h void setauevent void void endauevent void struct au_event_ent * getauevent void struct au_event_ent * getauevent_r struct au_event_ent *e struct au_event_ent * getauevnam const char *name struct au_event_ent * getauevnam_r struct au_event_ent *e const char *name struct au_event_ent * getauevnum au_event_t event_number struct au_event_ent * getauevnum_r struct au_event_ent *e au_event_t event_number au_event_t * getauevnonam const char *event_name au_event_t * getauevnonam_r au_event_t *ev const char *event_name

DESCRIPTION

These interfaces may be used to look up information from the audit_event(5) database, which describes audit events. Entries in the database are described by
.Vt struct au_event_ent entries, which are returned by calls to getauevent, getauevnam, or getauevnum. It is also possible to look up an event number via a call to getauevnonam.

The setauevent function resets the database access session for audit_event(5), so that the next call to getauevent will start with the first entry in the database.

The endauevent function closes the audit_event(5) database session.

The getauevent function returns a reference to the next entry in the audit_event(5) database.

The getauevnam function returns a reference to the entry in the audit_event(5) database with a name of name.

getauevnum returns a reference to the entry in the audit_event(5) database with an event number of event_number.

The getauevnonam function returns a reference to an audit event number using the audit_event(5) database.

RETURN VALUES

Functions getauevent, getauevent_r, getauevnam, getauevnam_r, getauevnum, getauevnum_r, and getauevnonam will return a reference to a
.Vt struct au_event_ent or
.Vt au_event_t on success, or NULL on failure, with errno set to provide further error information.

SEE ALSO

libbsm(3), audit_event(5)

HISTORY

The OpenBSM implementation was created by McAfee Research, the security division of McAfee Inc., under contract to Apple Computer, Inc., in 2004. It was subsequently adopted by the TrustedBSD Project as the foundation for the OpenBSM distribution.

AUTHORS


.An -nosplit This software was created by
.An Robert Watson ,
.An Wayne Salamon , and
.An Suresh Krishnaswamy for McAfee Research, the security research division of McAfee, Inc., under contract to Apple Computer, Inc.

The Basic Security Module (BSM) interface to audit records and audit event stream format were defined by Sun Microsystems.

BUGS

The errno variable is not always properly set following a failure.

These routines are thread-safe, but not re-entrant, so simultaneous or interleaved use of these functions will affect the iterator.

Search for    or go to Top of page |  Section 3 |  Main Index


April 19, 2005 AU_EVENT (3)

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