xref: /openbmc/linux/Documentation/ABI/testing/sysfs-devices-xenbus (revision d0034a7a4ac7fae708146ac0059b9c47a1543f0d)
1*06f45fe9SJuergen GrossWhat:		/sys/devices/*/xenbus/event_channels
2*06f45fe9SJuergen GrossDate:		February 2021
3*06f45fe9SJuergen GrossContact:	Xen Developers mailing list <xen-devel@lists.xenproject.org>
4*06f45fe9SJuergen GrossDescription:
5*06f45fe9SJuergen Gross		Number of Xen event channels associated with a kernel based
6*06f45fe9SJuergen Gross		paravirtualized device frontend or backend.
7*06f45fe9SJuergen Gross
8*06f45fe9SJuergen GrossWhat:		/sys/devices/*/xenbus/events
9*06f45fe9SJuergen GrossDate:		February 2021
10*06f45fe9SJuergen GrossContact:	Xen Developers mailing list <xen-devel@lists.xenproject.org>
11*06f45fe9SJuergen GrossDescription:
12*06f45fe9SJuergen Gross		Total number of Xen events received for a Xen pv device
13*06f45fe9SJuergen Gross		frontend or backend.
14*06f45fe9SJuergen Gross
15*06f45fe9SJuergen GrossWhat:		/sys/devices/*/xenbus/jiffies_eoi_delayed
16*06f45fe9SJuergen GrossDate:		February 2021
17*06f45fe9SJuergen GrossContact:	Xen Developers mailing list <xen-devel@lists.xenproject.org>
18*06f45fe9SJuergen GrossDescription:
19*06f45fe9SJuergen Gross		Summed up time in jiffies the EOI of an interrupt for a Xen
20*06f45fe9SJuergen Gross		pv device has been delayed in order to avoid stalls due to
21*06f45fe9SJuergen Gross		event storms. This value rising is a first sign for a rogue
22*06f45fe9SJuergen Gross		other end of the pv device.
23*06f45fe9SJuergen Gross
24*06f45fe9SJuergen GrossWhat:		/sys/devices/*/xenbus/spurious_events
25*06f45fe9SJuergen GrossDate:		February 2021
26*06f45fe9SJuergen GrossContact:	Xen Developers mailing list <xen-devel@lists.xenproject.org>
27*06f45fe9SJuergen GrossDescription:
28*06f45fe9SJuergen Gross		Number of events received for a Xen pv device which did not
29*06f45fe9SJuergen Gross		require any action. Too many spurious events in a row will
30*06f45fe9SJuergen Gross		trigger delayed EOI processing.
31*06f45fe9SJuergen Gross
32*06f45fe9SJuergen GrossWhat:		/sys/devices/*/xenbus/spurious_threshold
33*06f45fe9SJuergen GrossDate:		February 2021
34*06f45fe9SJuergen GrossContact:	Xen Developers mailing list <xen-devel@lists.xenproject.org>
35*06f45fe9SJuergen GrossDescription:
36*06f45fe9SJuergen Gross		Controls the tolerated number of subsequent spurious events
37*06f45fe9SJuergen Gross		before delayed EOI processing is triggered for a Xen pv
38*06f45fe9SJuergen Gross		device. Default is 1. This can be modified in case the other
39*06f45fe9SJuergen Gross		end of the pv device is issuing spurious events on a regular
40*06f45fe9SJuergen Gross		basis and is known not to be malicious on purpose. Raising
41*06f45fe9SJuergen Gross		the value for such cases can improve pv device performance.
42