bb_setfilters(3EXT)

NAME | SYNOPSIS | API RESTRICTIONS | ARGUMENTS | DESCRIPTION | RETURN VALUES | ERRORS | ATTRIBUTES | SEE ALSO

NAME

bb_setfilters- set the fine-grained filters

SYNOPSIS

$(OS_DIR)/lib/libblackbox.a
#include <sys/blackbox.h>

int bb_setfilters(bb_filter_t *filters, uint_t nfilters);

API RESTRICTIONS

The function or functions documented here may not be used safely in all application contexts with all APIs provided in the ChorusOS 5.0 product.

See API(5FEA) for details.

ARGUMENTS

filters(IN):

an array of nfilters bb_filter_ts

nfilters(IN):

the number of bb_filter_ts passed in filters.

DESCRIPTION

bb_setfilters() sets the filter list and the filtered severity bitmap for the node.

The members of the bb_filter_ts and the way to specify the filtered severity bitmap are described in bb_getfilters().

bb_setfilters() does not add to or modify the current filter list or filtered severity bitmap; it replaces them entirely. If multiple conflicting filters are passed in in a single array, the filter with higher array index will take precedence.

RETURN VALUES

bb_setfilters() returns 0 on success and -1 on failure.

ERRORS

If it returns -1, errno is set to:

EFAULT:

The filters argument points to an illegal address

EPERM:

The caller does not have permission to set the filters

ENOTSUP:

The black box service is not configured on this node

ATTRIBUTES

See attributes(5) for descriptions of the following attributes:

ATTRIBUTE TYPE	ATTRIBUTE VALUE
Interface Stability	Evolving

SEE ALSO

bb_getfilters(3EXT)

ChorusOS 5.0  Last Revised December 2001

NAME | SYNOPSIS | API RESTRICTIONS | ARGUMENTS | DESCRIPTION | RETURN VALUES | ERRORS | ATTRIBUTES | SEE ALSO