1a25df667SRobert Mustacchi.\" 2a25df667SRobert Mustacchi.\" This file and its contents are supplied under the terms of the 3a25df667SRobert Mustacchi.\" Common Development and Distribution License ("CDDL"), version 1.0. 4a25df667SRobert Mustacchi.\" You may only use this file in accordance with the terms of version 5a25df667SRobert Mustacchi.\" 1.0 of the CDDL. 6a25df667SRobert Mustacchi.\" 7a25df667SRobert Mustacchi.\" A full copy of the text of the CDDL should have accompanied this 8a25df667SRobert Mustacchi.\" source. A copy of the CDDL is also available via the Internet at 9a25df667SRobert Mustacchi.\" http://www.illumos.org/license/CDDL. 10a25df667SRobert Mustacchi.\" 11a25df667SRobert Mustacchi.\" 12a25df667SRobert Mustacchi.\" Copyright 2019 Joyent, Inc. 13a25df667SRobert Mustacchi.\" 142cdd73dbSPeter Tribble.Dd August 28, 2021 15a25df667SRobert Mustacchi.Dt SYSEVENTS 3SYSEVENT 16a25df667SRobert Mustacchi.Os 17a25df667SRobert Mustacchi.Sh NAME 18a25df667SRobert Mustacchi.Nm sysevents 19a25df667SRobert Mustacchi.Nd list of system events generated by the platform 20a25df667SRobert Mustacchi.Sh SYNOPSIS 21a25df667SRobert Mustacchi.In sys/sysevent/eventdefs.h 22a25df667SRobert Mustacchi.Sh DESCRIPTION 23a25df667SRobert MustacchiSystem events are events that are generated by the operating system to 24a25df667SRobert Mustacchiindicate that something has occurred that may be of interest to user 25a25df667SRobert Mustacchiland. 26a25df667SRobert MustacchiThese notifications are asynchronous from the event themselves and 27a25df667SRobert Mustacchidepending on the event, may be lossy. 28a25df667SRobert MustacchiThat is, the kernel may opt not to generate an event in the face of 29a25df667SRobert Mustacchimemory pressure. 30a25df667SRobert MustacchiCurrently, every generated event should make it to consumers. 31a25df667SRobert Mustacchi.Pp 32a25df667SRobert MustacchiEvents are broken into classes such as ZFS, FMA, PCIe, and others. 33a25df667SRobert MustacchiClasses are further broken down into subclasses. 34a25df667SRobert MustacchiSpecific events may also have more detailed payload which is available 35a25df667SRobert Mustacchias name-value pairs. 36a25df667SRobert MustacchiFor more information on subscribing to events, classes, and payloads, 37a25df667SRobert Mustacchiplease see 38a25df667SRobert Mustacchi.Xr sysevent_subscribe_event 3SYSEVENT , 39a25df667SRobert Mustacchi.Xr sysevent_get_attr_list 3SYSEVENT , 40a25df667SRobert Mustacchiand 41a25df667SRobert Mustacchi.Xr libnvpair 3LIB . 42a25df667SRobert Mustacchi.Pp 43a25df667SRobert MustacchiMost system events are currently logged to the FMA information log which 44a25df667SRobert Mustacchican be retrieved with the 45a25df667SRobert Mustacchi.Ar -I 46a25df667SRobert Mustacchioption to the 47*bbf21555SRichard Lowe.Xr fmdump 8 48a25df667SRobert Mustacchicommand. 49a25df667SRobert Mustacchi.Sh EVENTS 50a25df667SRobert MustacchiThis section contains a list of some of the events that are generated by 51a25df667SRobert Mustacchithe system, but it is not exhaustive. 52a25df667SRobert MustacchiThe names of events are macros that the system provides. 53a25df667SRobert MustacchiThe payload member name is generally a macro and its corresponding type 54a25df667SRobert Mustacchiis provided, along with a brief description. 55a25df667SRobert MustacchiUnless otherwise noted, it should be assumed that the event and its 56a25df667SRobert Mustacchipayload is private to the system and may change at any time. 57a25df667SRobert Mustacchi.Pp 58a25df667SRobert MustacchiThe following events belong to the class 59a25df667SRobert Mustacchi.Dv EC_DATALINK : 60a25df667SRobert Mustacchi.Bl -tag -width Dv 61a25df667SRobert Mustacchi.It Dv ESC_DATALINK_LINK_STATE 62a25df667SRobert MustacchiThis event fires any time a data link 63*bbf21555SRichard Lowe.Pq see Xr dladm 8 64a25df667SRobert Mustacchichanges its state. 65a25df667SRobert MustacchiThis may occur because a physical cable was inserted or removed from a 66a25df667SRobert Mustacchinetwork adapter or because something has changed on a virtual adapter 67a25df667SRobert Mustacchisuch as a VNIC. 68a25df667SRobert MustacchiThe event has the following payload: 69a25df667SRobert Mustacchi.Bl -tag -width Dv 70a25df667SRobert Mustacchi.It Dv DATALINK_EV_LINK_NAME - String 71a25df667SRobert MustacchiIndicates the name of the data link that had the event. 72a25df667SRobert Mustacchi.It Dv DATALINK_EV_LINK_ID - int32 73a25df667SRobert MustacchiIndicates the data link's logical ID that is used by the kernel. 74a25df667SRobert Mustacchi.It Dv DATALINK_EV_ZONE_ID - int32 75a25df667SRobert MustacchiIndicates the ID of the zone that the data link belongs to. 76a25df667SRobert Mustacchi.El 77a25df667SRobert Mustacchi.El 78a25df667SRobert Mustacchi.Sh INTERFACE STABILITY 79a25df667SRobert MustacchiWhile the library interface in 802cdd73dbSPeter Tribble.Xr libsysevent 3LIB 81a25df667SRobert Mustacchiis committed, unless otherwise indicated the events, classes, their 82a25df667SRobert Mustacchipayloads, are private and subject to change at any time. 83a25df667SRobert Mustacchi.Sh SEE ALSO 84a25df667SRobert Mustacchi.Xr libnvpair 3LIB , 85a25df667SRobert Mustacchi.Xr libsysevent 3LIB , 86a25df667SRobert Mustacchi.Xr sysevent_get_attr_list 3SYSEVENT , 87a25df667SRobert Mustacchi.Xr sysevent_subscribe_event 3SYSEVENT 88