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

Linux 6.18.37 · ABI / testing

Kernel module sysfs ABI

Module-specific MAC·firmware controls, EHCI periodic bandwidth, module size·state·taint와 Xen grant reclaim parameter를 정의합니다.

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

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

1. 요약·해설

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

Driver data와 EHCI bandwidth

sysfs-module:1-37

PCH device data와 EHCI periodic-transfer budget을 제공하며, USB standard limit을 넘길 때의 hardware risk를 명시합니다.

Module footprint, state and taint

sysfs-module:38-63

Module memory size, initialization lifecycle과 provenance·loading 상태를 나타내는 taint flags를 제공합니다.

Xen deferred grant reclaim

sysfs-module:64-73

Iteration당 회수할 grant entries 수를 조절하는 임시 성격의 runtime parameter입니다.

2. 영어 원문 전체

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

원문 전체 펼치기
1 What: /sys/module/pch_phub/drivers/.../pch_mac
2 Date: August 2010
3 KernelVersion: 2.6.35
4 Contact: masa-korg@dsn.okisemi.com
5 Description: Write/read GbE MAC address.
6
7 What: /sys/module/pch_phub/drivers/.../pch_firmware
8 Date: August 2010
9 KernelVersion: 2.6.35
10 Contact: masa-korg@dsn.okisemi.com
11 Description: Write/read Option ROM data.
12
13
14 What: /sys/module/ehci_hcd/drivers/.../uframe_periodic_max
15 Date: July 2011
16 KernelVersion: 3.1
17 Contact: Kirill Smelkov <kirr@mns.spb.ru>
18 Description: Maximum time allowed for periodic transfers per microframe (μs)
19
20 Note:
21 USB 2.0 sets maximum allowed time for periodic transfers per
22 microframe to be 80%, that is 100 microseconds out of 125
23 microseconds (full microframe).
24
25 However there are cases, when 80% max isochronous bandwidth is
26 too limiting. For example two video streams could require 110
27 microseconds of isochronous bandwidth per microframe to work
28 together.
29
30 Through this setting it is possible to raise the limit so that
31 the host controller would allow allocating more than 100
32 microseconds of periodic bandwidth per microframe.
33
34 Beware, non-standard modes are usually not thoroughly tested by
35 hardware designers, and the hardware can malfunction when this
36 setting differ from default 100.
37
38 What: /sys/module/*/{coresize,initsize}
39 Date: Jan 2012
40 KernelVersion: 3.3
41 Contact: Kay Sievers <kay.sievers@vrfy.org>
42 Description: Module size in bytes.
43
44 What: /sys/module/*/initstate
45 Date: Nov 2006
46 KernelVersion: 2.6.19
47 Contact: Kay Sievers <kay.sievers@vrfy.org>
48 Description: Show the initialization state(live, coming, going) of
49 the module.
50
51 What: /sys/module/*/taint
52 Date: Jan 2012
53 KernelVersion: 3.3
54 Contact: Kay Sievers <kay.sievers@vrfy.org>
55 Description: Module taint flags:
56 == =====================
57 P proprietary module
58 O out-of-tree module
59 F force-loaded module
60 C staging driver module
61 E unsigned module
62 == =====================
63
64 What: /sys/module/grant_table/parameters/free_per_iteration
65 Date: July 2023
66 KernelVersion: 6.5 but backported to all supported stable branches
67 Contact: Xen developer discussion <xen-devel@lists.xenproject.org>
68 Description: Read and write number of grant entries to attempt to free per iteration.
69
70 Note: Future versions of Xen and Linux may provide a better
71 interface for controlling the rate of deferred grant reclaim
72 or may not need it at all.
73 Users: Qubes OS (https://www.qubes-os.org)
74

3. 한국어 전문 번역

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

Kernel module sysfs ABI: pch mac

1-6
항목한국어 전문 번역
What/sys/module/pch_phub/drivers/.../pch_mac
Date2010년 8월
KernelVersion2.6.35
Contactmasa-korg@dsn.okisemi.com
Description`/sys/module/pch_phub/drivers/.../pch_mac`에서 GbE MAC address를 write하고 read할 수 있습니다.

Kernel module sysfs ABI: pch firmware

7-13
항목한국어 전문 번역
What/sys/module/pch_phub/drivers/.../pch_firmware
Date2010년 8월
KernelVersion2.6.35
Contactmasa-korg@dsn.okisemi.com
Description`/sys/module/pch_phub/drivers/.../pch_firmware`에서 Option ROM data를 write하고 read할 수 있습니다.

Kernel module sysfs ABI: uframe periodic max

14-37
항목한국어 전문 번역
What/sys/module/ehci_hcd/drivers/.../uframe_periodic_max
Date2011년 7월
KernelVersion3.1
ContactKirill Smelkov <kirr@mns.spb.ru>
Description`/sys/module/ehci_hcd/drivers/.../uframe_periodic_max`는 microframe당 periodic transfers에 허용되는 maximum time을 microseconds(`μs`) 단위로 지정합니다. USB 2.0의 standard maximum은 125-microsecond full microframe의 80%인 100 microseconds입니다. 그러나 두 video streams가 함께 동작하려면 microframe당 110 microseconds의 isochronous bandwidth가 필요한 것처럼 80% 제한이 부족한 경우가 있습니다. 이 setting으로 host controller가 microframe당 100 microseconds보다 많은 periodic bandwidth를 allocate하도록 limit을 높일 수 있습니다. Non-standard modes는 보통 hardware designers가 충분히 test하지 않으므로 value가 default `100`과 다르면 hardware가 malfunction할 수 있습니다.
EHCI microframe periodic budget
CasePeriodic time per 125 μs microframeMeaning
USB 2.0 default100 μs80% periodic-transfer limit
Example dual video streams110 μsMay require raised limit
Raised non-standard limit> 100 μsHardware may malfunction

Standard USB 2.0 budget과 예외적인 dual-stream 요구, 그리고 non-standard limit의 위험을 비교합니다.

Kernel module sysfs ABI: {coresize,initsize}

38-43
항목한국어 전문 번역
What/sys/module/*/{coresize,initsize}
Date2012년 1월
KernelVersion3.3
ContactKay Sievers <kay.sievers@vrfy.org>
Description`/sys/module/*/{coresize,initsize}`는 module size를 bytes 단위로 표시합니다.

Kernel module sysfs ABI: initstate

44-50
항목한국어 전문 번역
What/sys/module/*/initstate
Date2006년 11월
KernelVersion2.6.19
ContactKay Sievers <kay.sievers@vrfy.org>
Description`/sys/module/*/initstate`는 module initialization state인 `live`, `coming`, `going` 중 하나를 표시합니다.

Kernel module sysfs ABI: taint

51-63
항목한국어 전문 번역
What/sys/module/*/taint
Date2012년 1월
KernelVersion3.3
ContactKay Sievers <kay.sievers@vrfy.org>
Description`/sys/module/*/taint`는 module taint flags를 표시합니다. `P`는 proprietary module, `O`는 out-of-tree module, `F`는 force-loaded module, `C`는 staging driver module, `E`는 unsigned module을 뜻합니다.
Module taint flags
FlagModule condition
PProprietary module
OOut-of-tree module
FForce-loaded module
CStaging driver module
EUnsigned module

원문의 RST flag table을 같은 의미의 구조화 표로 다시 그렸습니다.

Kernel module sysfs ABI: free per iteration

64-73
항목한국어 전문 번역
What/sys/module/grant_table/parameters/free_per_iteration
Date2023년 7월
KernelVersion6.5 but backported to all supported stable branches
ContactXen developer discussion <xen-devel@lists.xenproject.org>
UsersQubes OS (https://www.qubes-os.org)
Description`/sys/module/grant_table/parameters/free_per_iteration`은 iteration마다 free를 시도할 grant entries 수를 read하고 write합니다. 향후 Xen과 Linux는 deferred grant reclaim rate를 제어하는 더 나은 interface를 제공하거나 이 interface가 아예 필요하지 않을 수 있습니다. User는 Qubes OS(`https://www.qubes-os.org`)입니다.