요약·해설과 원문, 전문 번역을 서로 분리했습니다. API 이름, symbol, source path는 원문 표기를 사용합니다.
1. 요약·해설
원문의 핵심 논리와 kernel programming 관점의 보충 설명입니다. 아래의 전문 번역과는 별도로 작성했습니다.
Hotplug and capture-kernel parameters
sysfs-kernel-fadump:42-59Second kernel의 elfcorehdr 준비 상태를 memory-hotplug udev rule에 알리고 capture kernel에 추가 boot parameters를 전달합니다.
2. 영어 원문 전체
번역 기준이 된 Linux v6.18.37 원문입니다. 줄 번호는 이 버전의 파일 좌표입니다.
원문 전체 펼치기
1
What: /sys/kernel/fadump/*
2
Date: Dec 2019
3
Contact: [email protected]
4
Description:
5
The /sys/kernel/fadump/* is a collection of FADump sysfs
6
file provide information about the configuration status
7
of Firmware Assisted Dump (FADump).
9
What: /sys/kernel/fadump/enabled
10
Date: Dec 2019
11
Contact: [email protected]
12
Description: read only
13
Primarily used to identify whether the FADump is enabled in
14
the kernel or not.
15
User: Kdump service
17
What: /sys/kernel/fadump/registered
18
Date: Dec 2019
19
Contact: [email protected]
20
Description: read/write
21
Helps to control the dump collect feature from userspace.
22
Setting 1 to this file enables the system to collect the
23
dump and 0 to disable it.
24
User: Kdump service
26
What: /sys/kernel/fadump/release_mem
27
Date: Dec 2019
28
Contact: [email protected]
29
Description: write only
30
This is a special sysfs file and only available when
31
the system is booted to capture the vmcore using FADump.
32
It is used to release the memory reserved by FADump to
33
save the crash dump.
35
What: /sys/kernel/fadump/mem_reserved
36
Date: Dec 2019
37
Contact: [email protected]
38
Description: read only
39
Provide information about the amount of memory reserved by
40
FADump to save the crash dump in bytes.
42
What: /sys/kernel/fadump/hotplug_ready
43
Date: Apr 2024
44
Contact: [email protected]
45
Description: read only
46
Kdump udev rule re-registers fadump on memory add/remove events,
47
primarily to update the elfcorehdr. This sysfs indicates the
48
kdump udev rule that fadump re-registration is not required on
49
memory add/remove events because elfcorehdr is now prepared in
50
the second/fadump kernel.
51
User: kexec-tools
53
What: /sys/kernel/fadump/bootargs_append
54
Date: May 2024
55
Contact: [email protected]
56
Description: read/write
57
This is a special sysfs file available to setup additional
58
parameters to be passed to capture kernel. For HASH MMU it
59
is exported only if RMA size higher than 768MB.
3. 한국어 전문 번역
영어 원문의 문단 순서와 의미를 유지한 전체 번역입니다. 코드, 함수명, symbol과 URL은 원문 표기를 유지합니다.
Firmware *
1-8| 항목 | 한국어 전문 번역 |
|---|---|
| What | /sys/kernel/fadump/* |
| Date | 2019년 12월 |
| Contact | [email protected] |
| Description | `/sys/kernel/fadump/*`는 Firmware Assisted Dump(FADump)의 configuration status 정보를 제공하는 FADump sysfs files 모음입니다. |
Firmware enabled
9-16| 항목 | 한국어 전문 번역 |
|---|---|
| What | /sys/kernel/fadump/enabled |
| Date | 2019년 12월 |
| Contact | [email protected] |
| User | Kdump service |
| Description | Read-only file입니다. Kernel에서 FADump가 enabled인지 식별하는 데 주로 사용하며 사용자는 `Kdump service`입니다. |
Firmware registered
17-25| 항목 | 한국어 전문 번역 |
|---|---|
| What | /sys/kernel/fadump/registered |
| Date | 2019년 12월 |
| Contact | [email protected] |
| User | Kdump service |
| Description | Read/write file입니다. Userspace에서 dump collection 기능을 제어합니다. `1`을 쓰면 system이 dump를 수집하도록 enable하고 `0`을 쓰면 disable합니다. 사용자는 `Kdump service`입니다. |
Firmware release mem
26-34| 항목 | 한국어 전문 번역 |
|---|---|
| What | /sys/kernel/fadump/release_mem |
| Date | 2019년 12월 |
| Contact | [email protected] |
| Description | Write-only 특수 sysfs file입니다. FADump로 `vmcore`를 capture하기 위해 system이 boot된 경우에만 사용할 수 있으며, crash dump 저장을 위해 FADump가 reserve한 memory를 release하는 데 사용합니다. |
Firmware mem reserved
35-41| 항목 | 한국어 전문 번역 |
|---|---|
| What | /sys/kernel/fadump/mem_reserved |
| Date | 2019년 12월 |
| Contact | [email protected] |
| Description | Read-only file입니다. Crash dump 저장을 위해 FADump가 reserve한 memory 양을 bytes 단위로 제공합니다. |
AttributeAccessMeaning
enabledRead-onlyKernel FADump enable state
registeredRead/write1 enables and 0 disables dump collection
release_memWrite-onlyRelease crash-dump reserved memory
mem_reservedRead-onlyReserved memory in bytes
Configuration, registration과 reserved-memory lifecycle을 권한별로 정리합니다.
Firmware hotplug ready
42-52| 항목 | 한국어 전문 번역 |
|---|---|
| What | /sys/kernel/fadump/hotplug_ready |
| Date | 2024년 4월 |
| Contact | [email protected] |
| User | kexec-tools |
| Description | Read-only file입니다. Kdump udev rule은 memory add/remove events에서 `elfcorehdr`를 update하려고 FADump를 다시 register합니다. 이 sysfs 값은 `elfcorehdr`가 이제 second/fadump kernel에서 준비되므로 memory add/remove 때 FADump re-registration이 필요하지 않음을 kdump udev rule에 알립니다. 사용자는 `kexec-tools`입니다. |
Firmware bootargs append
53-59| 항목 | 한국어 전문 번역 |
|---|---|
| What | /sys/kernel/fadump/bootargs_append |
| Date | 2024년 5월 |
| Contact | [email protected] |
| Description | Read/write 특수 sysfs file이며 capture kernel에 전달할 추가 parameters를 설정합니다. HASH MMU에서는 RMA size가 768MB보다 클 때만 export됩니다. |
AttributeAccessCondition or effect
hotplug_readyRead-onlyRe-registration not required; elfcorehdr prepared in fadump kernel
bootargs_appendRead/writeExtra capture-kernel parameters; HASH MMU requires RMA > 768MB
Memory hotplug과 capture-kernel command line을 조정합니다.
Dump registration and reserved memory
sysfs-kernel-fadump:1-41FADump의 enable·registration 상태를 확인하고 dump collection을 켜거나 끄며 crash dump용 reserved memory를 조회·release합니다.