auparse_add_callback(3) - Linux manual page

NAME | SYNOPSIS | DESCRIPTION | RETURN VALUE | SEE ALSO | AUTHOR | COLOPHON

AUPARSE_ADD_CALLBACK(3)        Linux Audit API       AUPARSE_ADD_CALLBACK(3)

NAME         top

       auparse_add_callback - add a callback handler for notifications

SYNOPSIS         top

       #include <auparse.h>

       void
       auparse_add_callback(auparse_state_t *au, auparse_callback_ptr callback,
                            void *user_data, user_destroy user_destroy_func);

DESCRIPTION         top

       auparse_add_callback adds a callback function to the parse state
       which is invoked to notify the application of parsing events. This is
       part of the event feed API.

       The signature of the callback is:

       void
       auparse_callback(auparse_state_t *au, auparse_cb_event_t cb_event_type,
                        void *user_data);

       When the callback is invoked it is passed:

       au
               a pointer to the parse_state

       cb_event_type
              enumerated value indicating the reason why the callback was
              invoked

       user_data
              pointer to user supplied private data. May be NULL.

       user_destroy_func
              pointer to function called when user_data is destroyed. May be
              NULL.  The signature is:

              void destroy(void *user_data);

              The destroy() function should be prepared to accept user_data
              possibly being NULL.

       The cb_event_type argument indicates why the callback was invoked.
       It's possible values are:

       AUPARSE_CB_EVENT_READY
              A complete event has been parsed and is ready to be examined.
              This is logically equivalent to the parse state immediately
              following auparse_next_event()

       See auparse_feed(3) for a complete code example.

RETURN VALUE         top

       Returns the previous callback pointer.

SEE ALSO         top

       auparse_feed(3), auparse_flush_feed(3).

AUTHOR         top

       John Dennis

COLOPHON         top

       This page is part of the audit (Linux Audit) project.  Information
       about the project can be found at 
       ⟨http://people.redhat.com/sgrubb/audit/⟩.  If you have a bug report
       for this manual page, send it to linux-audit@redhat.com.  This page
       was obtained from the project's upstream Git repository
       ⟨https://github.com/linux-audit/audit-userspace.git⟩ on 2018-02-02.
       (At that time, the date of the most recent commit that was found in
       the repository was 2018-01-23.)  If you discover any rendering prob‐
       lems in this HTML version of the page, or you believe there is a bet‐
       ter or more up-to-date source for the page, or you have corrections
       or improvements to the information in this COLOPHON (which is not
       part of the original manual page), send a mail to man-pages@man7.org

Red Hat                           May 2007           AUPARSE_ADD_CALLBACK(3)

Pages that refer to this page: auparse_feed(3)