bb_setprodids(3EXT)

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

NAME

bb_setprodids- registers a list of producers to use the filter list and the filtered severity bitmap

SYNOPSIS

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

int bb_setprodids(bb_prodid_t *bb_prodid_t ids, uint_t *nids);

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

ids(OUT):

An array of bb_prodid_ts.

nids(IN/OUT):

Points to the number of bb_prodid_ts passed in ids.

DESCRIPTION

bb_setprodids() registers a list of producers to use the filter list and the filtered severity bitmap on this node.

The members of the bb_prodid_ts, and the meanings of the BB_ALL_PIDS and BB_ALL_PROD wild cards, are as specified in bb_getprodids().

bb_setprodids() does not add to or modify the current list of producers using the fine-grained filters; it replaces it entirely.

If multiple conflicting producer identifiers are passed in at once, the identifier with higher array index will take precedence.

If a producer has fine-grained filtering enabled because it matches one of the wild cards (a producer name with BB_ALL_PIDS, or just with BB_ALL_PROD), any further producers created with that name will also have fine-grained filtering enabled. However, if a producer name is registered along with a specific PID, and that producer dies, future producers with that PID won't have fine-grained filtering enabled unless it is enabled explicitly. Any filter that specifies a PID which doesn't match an existing producer will be ignored.

RETURN VALUES

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

ERRORS

If it returns -1, errno is set to:

EFAULT:

The ids argument points to an illegal address.

EPERM:

The caller doesn't have permission to set the list of producers using the fine-grained 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_getprodids(3EXT)

ChorusOS 5.0  Last Revised December 2001

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