sysevent_get_seq(3EXT)

NAME | SYNOPSIS | API RESTRICTIONS | PARAMETERS | DESCRIPTION | RETURN VALUE | ATTRIBUTES

NAME

sysevent_get_class_name, sysevent_get_subclass_name, sysevent_get_pub_name, sysevent_get_vendor_name, sysevent_get_time, sysevent_get_pid, sysevent_get_seq, sysevent_get_size, sysevent_get_queue- retrieve information from system event header

SYNOPSIS

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

char *sysevent_get_class_name(sysevent_t * ev);
char *sysevent_get_subclass_name(sysevent_t * ev);
char *sysevent_get_pub_name(sysevent_t * ev);
char *sysevent_get_vendor_name(sysevent_t * ev);
void sysevent_get pid(sysevent_t * ev, pid_t * pid);
void sysevent_get time(sysevent_t * ev, hrtime_t * se_time);
uint64_t sysevent_get time(sysevent_t * ev);
int t sysevent_get time(sysevent_t * ev);

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 object.

se_time

Pointer to hrtime_t object

DESCRIPTION

The sysevent_get_class_name() function and sysevent_get_subclass_name() return, the class and subclass names for the provided event ev respectively.

The sysevent_get_time() function returns the event time stamp in *se_time.

The sysevent_get_seq() function returns the event sequence ID.

The sysevent_get_size() function returns the size of the event buffer, ev .

The sysevent_get_pub_name() function returns the publisher name for the sysevent handle, ev . It identifies the name of the publishing application or ChorusOS subsystem of the sysevent.

The sysevent_get_pid() function returns the process ID for the publishing application or SE_KERN_PID for sysevents originating in the microkernel.

The sysevent_get_vendor_name() function returns the vendor string for the publishing application or microkernel subsystem. A vendor string is the stock symbol of the company that provided the application or microkernel subsystem that generated the system event. This information is useful for filtering sysevents for one or more vendors .

The sysevent_get_queue() function returns the queue id that the system event was posted to.

The interface manages the allocation of the vendor and publisher name strings, but it is up to the caller to free the strings when they are no longer needed with a call to free() . In contrast, no memory is dynamically allocated when the event class or subclass names are retrieved.

RETURN VALUE

Stated above.

ATTRIBUTES

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

ATTRIBUTE TYPE	ATTRIBUTE VALUE
Interface Stability	Evolving

ChorusOS 5.0  Last Revised December 2001

NAME | SYNOPSIS | API RESTRICTIONS | PARAMETERS | DESCRIPTION | RETURN VALUE | ATTRIBUTES