summary: A set of helpers for audit testing.
description: |+
    NAME
        CoreOS/audit/audit - a set of helpers for audit testing

    DESCRIPTION
        This is a library intended for audit testing. It will set the best
        setting for audit testing, can be used to configure audit and query
        audit events and related syslog messages.

    FUNCTIONS
      auditConfig
        Configue auditd using a given key-value pair. If a third parameter is
        given, then it is used as a configuration file. Otherwise auditd.conf is
        used. Return 0 in case of success.

      auditWaitForEvent
        For a given audit event type, message and timeout in seconds, wait at
        most until timeout for the message to appear in the audit log. Fourth
        parameter is optional, it is a file and if is given - event is stored in
        that file. Return 0 if a message was found, 1 otherwise.

      auditWaitForSyslogEvent
        For a given message and timeout in seconds, wait at most until timeout
        for the message to appear in the syslog log. Return 0 if a message was
        found, 1 otherwise.

      auditIncreaseLogSize
        Increase size of the audit log BY given size in megabytes

      auditLibraryLoaded
        Initialization callback.

    AUTHORS
        *   Ondrej Moris <omoris@redhat.com>

contact: Ondrej Moris <omoris@redhat.com>
test: ./runtest.sh
recommend:
  - audit
  - audispd-plugins
duration: 30m
extra-summary: /CoreOS/audit/Library/testing
extra-task: /CoreOS/audit/Library/testing