← Documents Documentation/ABI/testing/sysfs-devices-xenbus GitHub 원문 ↗

Linux 6.18.37 · ABI / testing

Xenbus paravirtual-device event sysfs ABI

Xen PV frontend/backend의 event-channel·event·spurious-event counters와 event storm 방지용 delayed EOI threshold를 설명합니다.

Source pathDocumentation/ABI/testing/sysfs-devices-xenbus
Source versionLinux v6.18.37
TranslationDUJINLABS 전문 번역 + 해설

요약·해설과 원문, 전문 번역을 서로 분리했습니다. API 이름, symbol, source path는 원문 표기를 사용합니다.

1. 요약·해설

원문의 핵심 논리와 kernel programming 관점의 보충 설명입니다. 아래의 전문 번역과는 별도로 작성했습니다.

PV device event counters

sysfs-devices-xenbus:1-31

Device별 channel 수, received event 수, delayed-EOI jiffies와 action이 불필요했던 spurious-event 수를 제공합니다.

Delayed-EOI trigger threshold

sysfs-devices-xenbus:32-41

연속 spurious event 허용 수를 조정하며 known-benign peer에는 default 1을 높여 PV device 성능을 개선할 수 있습니다.

2. 영어 원문 전체

번역 기준이 된 Linux v6.18.37 원문입니다. 줄 번호는 이 버전의 파일 좌표입니다.

원문 전체 펼치기
1 What: /sys/devices/*/xenbus/event_channels
2 Date: February 2021
3 Contact: Xen Developers mailing list <[email protected]>
4 Description:
5 Number of Xen event channels associated with a kernel based
6 paravirtualized device frontend or backend.
7
8 What: /sys/devices/*/xenbus/events
9 Date: February 2021
10 Contact: Xen Developers mailing list <[email protected]>
11 Description:
12 Total number of Xen events received for a Xen pv device
13 frontend or backend.
14
15 What: /sys/devices/*/xenbus/jiffies_eoi_delayed
16 Date: February 2021
17 Contact: Xen Developers mailing list <[email protected]>
18 Description:
19 Summed up time in jiffies the EOI of an interrupt for a Xen
20 pv device has been delayed in order to avoid stalls due to
21 event storms. This value rising is a first sign for a rogue
22 other end of the pv device.
23
24 What: /sys/devices/*/xenbus/spurious_events
25 Date: February 2021
26 Contact: Xen Developers mailing list <[email protected]>
27 Description:
28 Number of events received for a Xen pv device which did not
29 require any action. Too many spurious events in a row will
30 trigger delayed EOI processing.
31
32 What: /sys/devices/*/xenbus/spurious_threshold
33 Date: February 2021
34 Contact: Xen Developers mailing list <[email protected]>
35 Description:
36 Controls the tolerated number of subsequent spurious events
37 before delayed EOI processing is triggered for a Xen pv
38 device. Default is 1. This can be modified in case the other
39 end of the pv device is issuing spurious events on a regular
40 basis and is known not to be malicious on purpose. Raising
41 the value for such cases can improve pv device performance.
42

3. 한국어 전문 번역

영어 원문의 문단 순서와 의미를 유지한 전체 번역입니다. 코드, 함수명, symbol과 URL은 원문 표기를 유지합니다.

Xen PV event-channel count

1-7
항목한국어 전문 번역
What/sys/devices/*/xenbus/event_channels
Date2021년 2월
ContactXen Developers mailing list <[email protected]>
DescriptionKernel-based paravirtualized device frontend 또는 backend와 연관된 Xen event channel 수입니다.
Xenbus PV event metrics
AttributeMetric / control
event_channelsAssociated channel count
eventsTotal received events
jiffies_eoi_delayedAccumulated delayed-EOI time
spurious_eventsNo-action event count
spurious_thresholdConsecutive count before delayed EOI

Frontend/backend event activity와 storm handling state입니다.

Xen PV received-event count

8-14
항목한국어 전문 번역
What/sys/devices/*/xenbus/events
Date2021년 2월
ContactXen Developers mailing list <[email protected]>
DescriptionXen PV device frontend 또는 backend가 받은 Xen event의 total count입니다.

Delayed interrupt-EOI time

15-23
항목한국어 전문 번역
What/sys/devices/*/xenbus/jiffies_eoi_delayed
Date2021년 2월
ContactXen Developers mailing list <[email protected]>
DescriptionEvent storm 때문에 stall이 발생하지 않도록 Xen PV device interrupt의 EOI를 지연한 시간을 jiffies로 합산한 값입니다. 이 값이 증가하면 PV device의 rogue peer endpoint를 의심할 수 있는 첫 징후입니다.

Xen PV spurious-event count

24-31
항목한국어 전문 번역
What/sys/devices/*/xenbus/spurious_events
Date2021년 2월
ContactXen Developers mailing list <[email protected]>
Description어떤 action도 필요하지 않았던 Xen PV device event의 수입니다. Spurious event가 연속으로 너무 많이 발생하면 delayed EOI processing이 trigger됩니다.

Spurious-event delayed-EOI threshold

32-41
항목한국어 전문 번역
What/sys/devices/*/xenbus/spurious_threshold
Date2021년 2월
ContactXen Developers mailing list <[email protected]>
DescriptionXen PV device에서 delayed EOI processing을 trigger하기 전에 허용할 연속 spurious event 수를 제어합니다. Default는 1입니다. PV device의 peer endpoint가 regular하게 spurious event를 발생시키지만 의도적으로 malicious하지 않다고 알려진 경우 이 값을 바꿀 수 있습니다. 그런 경우 값을 높이면 PV device performance를 개선할 수 있습니다.
Spurious-event storm handling
PV device receives event requiring no actionIncrement spurious_eventsConsecutive count reaches spurious_thresholdTrigger delayed EOI processing to avoid stalls

Threshold를 넘는 연속 no-action events가 delayed EOI를 활성화합니다.