Previous section.

Distributed Audit Service (XDAS)
Copyright © 1998 The Open Group


xdas_create_filter - create the specified audit filter


OM_uint32 xdas_create_filter ( 
    OM_uint32				*minor_status, 
    const xdas_audit_ref_t		*das_ref,
    const xdas_buffer_t		*name,
    const OM_uint32			 filter_type,
    const xdas_buffer_t		*filter_exp,
    const xdas_buffer_t		*filter_act


xdas_create_filter() is a member of the XDAS Filter Management API Option Conformance class.

The xdas_create_filter() function creates a filter for the name specified. If a filter with the specified name already exists the call fails. On creation the filter is in a disabled state.

The caller must possess the XDAS_AUDIT_CONTROL authority.

If successful, the function returns [XDAS_S_COMPLETE].

The arguments for xdas_create_filter() are:

minor_status (out)

An implementation specific return status that provides additional information when [XDAS_S_FAILURE] is returned by the function.

das_ref (in)

The handle to the XDAS server, obtained from a previous call to xdas_initialize_session.

name (in)

The name of the filter.

filter_type (in)

The type of filter. This may be either XDAS_C_SUBMIT or XDAS_C_IMPORT.

filter_exp (in)

The expression list which defines the criteria for detection of the event.

filter_act (in)
The list of actions to be taken when the event is submitted or imported.


The following XDAS status codes shall be returned:


The caller does not possess the required authority.


Successful completion.


An implementation specific error or failure has occurred.


The filter type supplied is not recognized.


The audit service handle supplied does not point to the audit daemon.


The filter name supplied already exists.


The filter expression supplied is not valid.


The filter type supplied is not recognized.


The called function is not supported by this implementation.


No other errors are defined.

[??] Some characters or strings that appear in the printed document are not easily representable using HTML.

Why not acquire a nicely bound hard copy?
Click here to return to the publication details or order a copy of this publication.

Contents Next section Index