Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help 
AU_EVENT(3)            FreeBSD Library Functions Manual            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

LIBRARY
     Basic Security Module User Library (libbsm, -lbsm)

SYNOPSIS
     #include <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(char *name);

     struct au_event_ent *
     getauevnam_r(struct au_event_ent *e, 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(char *event_name);

     au_event_t *
     getauevnonam_r(au_event_t *ev, 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 struct au_event_ent entries, which are returned
     by calls to getauevent(), getauevnam(), or getauevnum().  It is also pos-
     sible look up an event number via a call to getauevnonam.

     setauevent() 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.

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

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

     getauevnam() returns a reference to the entry in the audit_event(5) data-
     base with a name of name.

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

     getauevnonam() 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 getauevnuam() will return a reference
     to a struct au_event_ent or au_event_t on success, or NULL on failure,
     with errno set to provide further error information.

SEE ALSO
     libbsm(3), audit_event(5)

AUTHORS
     This software was created by Robert Watson, Wayne Salamon, and 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.

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.

BUGS
     errno 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.

FreeBSD 6.2                     April 19, 2005                     FreeBSD 6.2
NAME | LIBRARY | SYNOPSIS | DESCRIPTION | RETURN VALUES | SEE ALSO | AUTHORS | HISTORY | BUGS

Want to link to this manual page? Use this URL:
<https://www.freebsd.org/cgi/man.cgi?query=getauevnonam_r&sektion=3&manpath=FreeBSD+6.2-RELEASE>

home | help