sysevent_get_attr_list(3EXT)

NAME | SYNOPSIS | API RESTRICTIONS | PARAMETERS | DESCRIPTION | RETURN VALUE | ERRORS | ATTRIBUTES | SEE ALSO

NAME

sysevent_get_attr_list- get a system event attribute list

SYNOPSIS

$(OS_DIR)/lib/libsysevent.a
#include <libsysevent.h>
#include <libnvpair.h>

int sysevent_get_attr_list(sysevent_t *ev, nvlist **attr_list);

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.

PARAMETERS

ev

Handle pointing to a system event

attr_list

Address of a pointer to an nvlist_t attribute list

DESCRIPTION

The sysevent_get_attr_list() function updates *attr_list so that it points to a searchable name-value pair list associated with the sysevent event, ev. The interface manages the allocation of the attribute list, but it is up to the caller to free the list when it is no longer needed with a call to nvlist_free().

RETURN VALUE

The sysevent_get_attr_list() function returns 0 if the attribute list for ev is found to be valid, or -1 and sets errno to the following errors.

ERRORS

[ENOMEM]

Insufficient memory available to allocate an nvlist

[EINVAL]

Invalid sysevent event attribute list

ATTRIBUTES

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

ATTRIBUTE TYPE	ATTRIBUTE VALUE
Interface Stability	Evolving

SEE ALSO

nvlist_alloc(3EXT), nvlist_free(3EXT), nvlist_add_boolean(3EXT), nvlist_add_byte(3EXT), nvlist_add_int16(3EXT), nvlist_add_uint16(3EXT), nvlist_add_int32(3EXT), nvlist_add_uint32(3EXT), nvlist_add_int64(3EXT), nvlist_add_uint64(3EXT), nvlist_add_string(3EXT), nvlist_add_byte_array(3EXT), nvlist_add_int16_array(3EXT), nvlist_add_uint16_array(3EXT), nvlist_add_int32_array(3EXT), nvlist_add_uint32_array(3EXT), nvlist_add_int64_array(3EXT), nvlist_add_uint64_array(3EXT), nvlist_add_string_array(3EXT), nvlist_add_hrtime(3EXT)

ChorusOS 5.0  Last Revised December 2001

NAME | SYNOPSIS | API RESTRICTIONS | PARAMETERS | DESCRIPTION | RETURN VALUE | ERRORS | ATTRIBUTES | SEE ALSO