SYSEVENTS(3SYSEVENT) System Event Library Functions SYSEVENTS(3SYSEVENT)

NAME

sysevents - list of system events generated by the platform

SYNOPSIS

#include <sys/sysevent/eventdefs.h>

DESCRIPTION

System events are events that are generated by the operating system to
indicate that something has occurred that may be of interest to user land.
These notifications are asynchronous from the event themselves and
depending on the event, may be lossy. That is, the kernel may opt not to
generate an event in the face of memory pressure. Currently, every
generated event should make it to consumers.

Events are broken into classes such as ZFS, FMA, PCIe, and others. Classes
are further broken down into subclasses. Specific events may also have
more detailed payload which is available as name-value pairs. For more
information on subscribing to events, classes, and payloads, please see
sysevent_subscribe_event(3SYSEVENT), sysevent_get_attr_list(3SYSEVENT), and
libnvpair(3LIB).

Most system events are currently logged to the FMA information log which
can be retrieved with the -I option to the fmdump(8) command.

EVENTS

This section contains a list of some of the events that are generated by
the system, but it is not exhaustive. The names of events are macros that
the system provides. The payload member name is generally a macro and its
corresponding type is provided, along with a brief description. Unless
otherwise noted, it should be assumed that the event and its payload is
private to the system and may change at any time.

The following events belong to the class EC_DATALINK:

ESC_DATALINK_LINK_STATE
This event fires any time a data link (see dladm(8)) changes
its state. This may occur because a physical cable was
inserted or removed from a network adapter or because
something has changed on a virtual adapter such as a VNIC.
The event has the following payload:

DATALINK_EV_LINK_NAME - String
Indicates the name of the data link that had
the event.

DATALINK_EV_LINK_ID - int32
Indicates the data link's logical ID that is
used by the kernel.

DATALINK_EV_ZONE_ID - int32
Indicates the ID of the zone that the data link
belongs to.

INTERFACE STABILITY

While the library interface in libsysevent(3LIB) is committed, unless
otherwise indicated the events, classes, their payloads, are private and
subject to change at any time.

SEE ALSO

libnvpair(3LIB), libsysevent(3LIB), sysevent_get_attr_list(3SYSEVENT),
sysevent_subscribe_event(3SYSEVENT)

illumos August 28, 2021 illumos