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

Linux 6.18.37 · ABI / testing

x86 kernel boot parameters sysfs ABI

x86 kernel boot parameters를 kexec와 debugging용으로 export하는 data, version, setup_data directory 구조와 encoding을 설명합니다.

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

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

1. 요약·해설

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

Boot protocol export tree

sysfs-kernel-boot_params:1-39

x86 boot parameters 본체와 protocol version, linked-list setup_data의 type·payload를 binary 또는 string 형식으로 userspace에 제공합니다.

2. 영어 원문 전체

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

원문 전체 펼치기
1 What: /sys/kernel/boot_params
2 Date: December 2013
3 Contact: Dave Young <[email protected]>
4 Description: The /sys/kernel/boot_params directory contains two
5 files: "data" and "version" and one subdirectory "setup_data".
6 It is used to export the kernel boot parameters of an x86
7 platform to userspace for kexec and debugging purpose.
8
9 If there's no setup_data in boot_params the subdirectory will
10 not be created.
11
12 "data" file is the binary representation of struct boot_params.
13
14 "version" file is the string representation of boot
15 protocol version.
16
17 "setup_data" subdirectory contains the setup_data data
18 structure in boot_params. setup_data is maintained in kernel
19 as a link list. In "setup_data" subdirectory there's one
20 subdirectory for each link list node named with the number
21 of the list nodes. The list node subdirectory contains two
22 files "type" and "data". "type" file is the string
23 representation of setup_data type. "data" file is the binary
24 representation of setup_data payload.
25
26 The whole boot_params directory structure is like below::
27
28 /sys/kernel/boot_params
29 |__ data
30 |__ setup_data
31 | |__ 0
32 | | |__ data
33 | | |__ type
34 | |__ 1
35 | |__ data
36 | |__ type
37 |__ version
38
39 Users: Kexec
40

3. 한국어 전문 번역

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

x86 boot params

1-39
항목한국어 전문 번역
What/sys/kernel/boot_params
Date2013년 12월
ContactDave Young <[email protected]>
UsersKexec
Description`/sys/kernel/boot_params` directory는 `data`, `version` files와 `setup_data` subdirectory를 포함하며, x86 platform의 kernel boot parameters를 kexec와 debugging을 위해 userspace로 export합니다. `boot_params`에 `setup_data`가 없으면 해당 subdirectory도 만들지 않습니다. `data`는 `struct boot_params`의 binary representation이고 `version`은 boot protocol version의 string representation입니다. `setup_data`는 kernel에서 linked list로 관리되므로 각 list node number의 subdirectory가 생기며, 그 아래 `type`은 setup_data type의 string representation, `data`는 setup_data payload의 binary representation입니다. 사용자는 `Kexec`입니다.
x86 boot_params sysfs tree
PathRepresentationContent
/sys/kernel/boot_params/dataBinarystruct boot_params
/sys/kernel/boot_params/versionStringBoot protocol version
/sys/kernel/boot_params/setup_data/<node>/typeStringsetup_data type
/sys/kernel/boot_params/setup_data/<node>/dataBinarysetup_data payload
Conditional directorysetup_data가 없으면 setup_data subdirectory도 생성되지 않습니다.

원문의 directory tree를 path, representation과 의미로 구조화했습니다.