sysevent_alloc_event(3EXT)

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

NAME

sysevent_alloc_event, _sysevent_alloc_event- allocate a system event

SYNOPSIS

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

sysevent_t * sysevent_alloc_event(char * class, char * subclass, char * vendor, char * pub_name, nvlist_t * *ttr_list);
sysevent_t * _sysevent_alloc_event(int queue, char * class, char * subclass, char * vendor, char * pub_name, nvlist_t * 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.

DESCRIPTION

The sysevent_alloc_event() function allocates a system event from a preallocated event pool. There is one pool per configured event queue. The sysevent_alloc_event() function tries to allocate the event from the pool associated to the default event queue. If there is no available event in the queue, a null value is returned and an errno condition is set.

The _sysevent_alloc_event() function behaves like sysevent_alloc_event() , except that the event queue to which the event belongs must be specified.

RETURN VALUES

Upon successful completion, sysevent_alloc_event() and _sysevent_alloc_event() return 0. Otherwise, they return NULL and set errno to indicate one of the following error conditions.

ERRORS

[EINVAL]

Invalid argument; notably set if one of the following conditions is met

• The subclass , vendor or publisher argument is a null address

• The class string is greater than MAX_CLASS_LEN

• The subclass string is greater than MAX_SUBCLASS_LEN

• The concatenated vendor and publisher strings are greater than MAX_PUB_LEN - 16

[EPERM]

Permission denied

[EAGAIN]

No available system event.

[ENOXIO]

The system event feature is not configured or no system event server is available.

ATTRIBUTES

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

ATTRIBUTE TYPE	ATTRIBUTE VALUE
Interface Stability	Evolving

SEE ALSO

sysevent_post_event(3EXT) , _sysevent_post_event(3EXT) , sysevent_free(3EXT)

ChorusOS 5.0  Last Revised December 2001

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