요약·해설과 원문, 전문 번역을 서로 분리했습니다. API 이름, symbol, source path는 원문 표기를 사용합니다.
1. 요약·해설
원문의 핵심 논리와 kernel programming 관점의 보충 설명입니다. 아래의 전문 번역과는 별도로 작성했습니다.
값 문법
kernel-parameters.rst:54-105CPU 목록의 범위·그룹·N·all 표기와 K/M/G/T/P/E 이진 접미사를 정리합니다.
빌드 조건 태그
kernel-parameters.rst:106-203매개변수 설명 앞에 붙는 아키텍처·하위 시스템·기능 태그 84개를 설명합니다.
표기와 길이 제한
kernel-parameters.rst:204-230BOOT·BUGS·KNL 표기, 대소문자와 환경 변수 구분, 명령줄 길이 제한을 안내합니다.
2. 영어 원문 전체
번역 기준이 된 Linux v6.18.37 원문입니다. 줄 번호는 이 버전의 파일 좌표입니다.
원문 전체 펼치기
1
.. SPDX-License-Identifier: GPL-2.0
3
.. _kernelparameters:
5
The kernel's command-line parameters
6
====================================
8
The following is a consolidated list of the kernel parameters as implemented
9
by the __setup(), early_param(), core_param() and module_param() macros
10
and sorted into English Dictionary order (defined as ignoring all
11
punctuation and sorting digits before letters in a case insensitive
12
manner), and with descriptions where known.
14
The kernel parses parameters from the kernel command line up to "``--``";
15
if it doesn't recognize a parameter and it doesn't contain a '.', the
16
parameter gets passed to init: parameters with '=' go into init's
17
environment, others are passed as command line arguments to init.
18
Everything after "``--``" is passed as an argument to init.
20
Module parameters can be specified in two ways: via the kernel command
21
line with a module name prefix, or via modprobe, e.g.::
23
(kernel command line) usbcore.blinkenlights=1
24
(modprobe command line) modprobe usbcore blinkenlights=1
26
Parameters for modules which are built into the kernel need to be
27
specified on the kernel command line. modprobe looks through the
28
kernel command line (/proc/cmdline) and collects module parameters
29
when it loads a module, so the kernel command line can be used for
30
loadable modules too.
32
This document may not be entirely up to date and comprehensive. The command
33
"modinfo -p ${modulename}" shows a current list of all parameters of a loadable
34
module. Loadable modules, after being loaded into the running kernel, also
35
reveal their parameters in /sys/module/${modulename}/parameters/. Some of these
36
parameters may be changed at runtime by the command
37
``echo -n ${value} > /sys/module/${modulename}/parameters/${parm}``.
39
Special handling
40
----------------
42
Hyphens (dashes) and underscores are equivalent in parameter names, so::
44
log_buf_len=1M print-fatal-signals=1
46
can also be entered as::
48
log-buf-len=1M print_fatal_signals=1
50
Double-quotes can be used to protect spaces in values, e.g.::
52
param="spaces in here"
54
cpu lists
55
~~~~~~~~~
57
Some kernel parameters take a list of CPUs as a value, e.g. isolcpus,
58
nohz_full, irqaffinity, rcu_nocbs. The format of this list is:
60
<cpu number>,...,<cpu number>
62
or
64
<cpu number>-<cpu number>
65
(must be a positive range in ascending order)
67
or a mixture
69
<cpu number>,...,<cpu number>-<cpu number>
71
Note that for the special case of a range one can split the range into equal
72
sized groups and for each group use some amount from the beginning of that
73
group:
75
<cpu number>-<cpu number>:<used size>/<group size>
77
For example one can add to the command line following parameter:
79
isolcpus=1,2,10-20,100-2000:2/25
81
where the final item represents CPUs 100,101,125,126,150,151,...
83
The value "N" can be used to represent the numerically last CPU on the system,
84
i.e "foo_cpus=16-N" would be equivalent to "16-31" on a 32 core system.
86
Keep in mind that "N" is dynamic, so if system changes cause the bitmap width
87
to change, such as less cores in the CPU list, then N and any ranges using N
88
will also change. Use the same on a small 4 core system, and "16-N" becomes
89
"16-3" and now the same boot input will be flagged as invalid (start > end).
91
The special case-tolerant group name "all" has a meaning of selecting all CPUs,
92
so that "nohz_full=all" is the equivalent of "nohz_full=0-N".
94
The semantics of "N" and "all" is supported on a level of bitmaps and holds for
95
all users of bitmap_parselist().
97
Metric suffixes
98
~~~~~~~~~~~~~~~
100
The [KMG] suffix is commonly described after a number of kernel
101
parameter values. 'K', 'M', 'G', 'T', 'P', and 'E' suffixes are allowed.
102
These letters represent the _binary_ multipliers 'Kilo', 'Mega', 'Giga',
103
'Tera', 'Peta', and 'Exa', equaling 2^10, 2^20, 2^30, 2^40, 2^50, and
104
2^60 bytes respectively. Such letter suffixes can also be entirely omitted.
106
Kernel Build Options
107
--------------------
109
The parameters listed below are only valid if certain kernel build options
110
were enabled and if respective hardware is present. This list should be kept
111
in alphabetical order. The text in square brackets at the beginning
112
of each description states the restrictions within which a parameter
113
is applicable::
115
ACPI ACPI support is enabled.
116
AGP AGP (Accelerated Graphics Port) is enabled.
117
ALSA ALSA sound support is enabled.
118
APIC APIC support is enabled.
119
APM Advanced Power Management support is enabled.
120
APPARMOR AppArmor support is enabled.
121
ARM ARM architecture is enabled.
122
ARM64 ARM64 architecture is enabled.
123
AX25 Appropriate AX.25 support is enabled.
124
CLK Common clock infrastructure is enabled.
125
CMA Contiguous Memory Area support is enabled.
126
DRM Direct Rendering Management support is enabled.
127
DYNAMIC_DEBUG Build in debug messages and enable them at runtime
128
EARLY Parameter processed too early to be embedded in initrd.
129
EDD BIOS Enhanced Disk Drive Services (EDD) is enabled
130
EFI EFI Partitioning (GPT) is enabled
131
EVM Extended Verification Module
132
FB The frame buffer device is enabled.
133
FTRACE Function tracing enabled.
134
GCOV GCOV profiling is enabled.
135
HIBERNATION HIBERNATION is enabled.
136
HW Appropriate hardware is enabled.
137
HYPER_V HYPERV support is enabled.
138
IMA Integrity measurement architecture is enabled.
139
IP_PNP IP DHCP, BOOTP, or RARP is enabled.
140
IPV6 IPv6 support is enabled.
141
ISAPNP ISA PnP code is enabled.
142
ISDN Appropriate ISDN support is enabled.
143
ISOL CPU Isolation is enabled.
144
JOY Appropriate joystick support is enabled.
145
KGDB Kernel debugger support is enabled.
146
KVM Kernel Virtual Machine support is enabled.
147
LIBATA Libata driver is enabled
148
LOONGARCH LoongArch architecture is enabled.
149
LOOP Loopback device support is enabled.
150
LP Printer support is enabled.
151
M68k M68k architecture is enabled.
152
These options have more detailed description inside of
153
Documentation/arch/m68k/kernel-options.rst.
154
MDA MDA console support is enabled.
155
MIPS MIPS architecture is enabled.
156
MOUSE Appropriate mouse support is enabled.
157
MSI Message Signaled Interrupts (PCI).
158
MTD MTD (Memory Technology Device) support is enabled.
159
NET Appropriate network support is enabled.
160
NFS Appropriate NFS support is enabled.
161
NUMA NUMA support is enabled.
162
OF Devicetree is enabled.
163
PARISC The PA-RISC architecture is enabled.
164
PCI PCI bus support is enabled.
165
PCIE PCI Express support is enabled.
166
PCMCIA The PCMCIA subsystem is enabled.
167
PNP Plug & Play support is enabled.
168
PPC PowerPC architecture is enabled.
169
PPT Parallel port support is enabled.
170
PS2 Appropriate PS/2 support is enabled.
171
PV_OPS A paravirtualized kernel is enabled.
172
RAM RAM disk support is enabled.
173
RDT Intel Resource Director Technology.
174
RISCV RISCV architecture is enabled.
175
S390 S390 architecture is enabled.
176
SCSI Appropriate SCSI support is enabled.
177
A lot of drivers have their options described inside
178
the Documentation/scsi/ sub-directory.
179
SDW SoundWire support is enabled.
180
SECURITY Different security models are enabled.
181
SELINUX SELinux support is enabled.
182
SERIAL Serial support is enabled.
183
SH SuperH architecture is enabled.
184
SMP The kernel is an SMP kernel.
185
SPARC Sparc architecture is enabled.
186
SUSPEND System suspend states are enabled.
187
SWSUSP Software suspend (hibernation) is enabled.
188
TPM TPM drivers are enabled.
189
UMS USB Mass Storage support is enabled.
190
USB USB support is enabled.
191
USBHID USB Human Interface Device support is enabled.
192
V4L Video For Linux support is enabled.
193
VGA The VGA console has been enabled.
194
VMMIO Driver for memory mapped virtio devices is enabled.
195
VT Virtual terminal support is enabled.
196
WDT Watchdog support is enabled.
197
X86-32 X86-32, aka i386 architecture is enabled.
198
X86-64 X86-64 architecture is enabled.
199
X86 Either 32-bit or 64-bit x86 (same as X86-32+X86-64)
200
X86_UV SGI UV support is enabled.
201
XEN Xen support is enabled
202
XTENSA xtensa architecture is enabled.
204
In addition, the following text indicates that the option::
206
BOOT Is a boot loader parameter.
207
BUGS= Relates to possible processor bugs on the said processor.
208
KNL Is a kernel start-up parameter.
210
Parameters denoted with BOOT are actually interpreted by the boot
211
loader, and have no meaning to the kernel directly.
212
Do not modify the syntax of boot loader parameters without extreme
213
need or coordination with <Documentation/arch/x86/boot.rst>.
215
There are also arch-specific kernel-parameters not documented here.
217
Note that ALL kernel parameters listed below are CASE SENSITIVE, and that
218
a trailing = on the name of any parameter states that the parameter will
219
be entered as an environment variable, whereas its absence indicates that
220
it will appear as a kernel argument readable via /proc/cmdline by programs
221
running once the system is up.
223
The number of kernel parameters is not limited, but the length of the
224
complete command line (parameters including spaces etc.) is limited to
225
a fixed number of characters. This limit depends on the architecture
226
and is between 256 and 4096 characters. It is defined in the file
227
./include/uapi/asm-generic/setup.h as COMMAND_LINE_SIZE.
229
.. include:: kernel-parameters.txt
230
:literal:
3. 한국어 전문 번역
영어 원문의 문단 순서와 의미를 유지한 전체 번역입니다. 코드, 함수명, symbol과 URL은 원문 표기를 유지합니다.
커널 명령줄 매개변수와 전달 규칙
1-38이 문서는 `__setup()`, `early_param()`, `core_param()`, `module_param()` 매크로로 구현된 커널 매개변수를 하나로 모은 목록입니다. 문장부호를 무시하고 숫자를 문자보다 앞에 두며 대소문자를 구분하지 않는 영문 사전 순으로 정렬하고, 알려진 설명을 덧붙였습니다.
커널은 명령줄에서 `--` 앞까지 매개변수를 해석합니다. 인식하지 못한 매개변수에 `.`이 없으면 init으로 넘깁니다. `=`이 있는 것은 init의 환경 변수로 들어가고, 나머지는 init의 명령줄 인수가 됩니다. `--` 뒤의 모든 항목도 init 인수로 전달됩니다.
모듈 매개변수는 커널 명령줄에서 모듈 이름을 접두사로 붙이거나 `modprobe`로 지정할 수 있습니다.
(kernel command line) usbcore.blinkenlights=1
(modprobe command line) modprobe usbcore blinkenlights=1커널에 내장한 모듈의 매개변수는 커널 명령줄에 지정해야 합니다. `modprobe`는 모듈을 적재할 때 `/proc/cmdline`을 살펴 모듈 매개변수를 수집하므로 loadable module에도 커널 명령줄을 사용할 수 있습니다.
이 문서가 항상 최신이거나 완전하지는 않을 수 있습니다. `modinfo -p ${modulename}`은 loadable module의 현재 매개변수 목록을 보여 줍니다. 적재된 모듈은 `/sys/module/${modulename}/parameters/`에도 매개변수를 공개하며, 변경 가능한 항목은 `echo -n ${value} > /sys/module/${modulename}/parameters/${parm}`으로 런타임에 바꿀 수 있습니다.
이름과 값의 특별 처리
39-53매개변수 이름에서 하이픈과 밑줄은 동일하게 취급됩니다. 따라서 다음 두 입력은 같습니다.
log_buf_len=1M print-fatal-signals=1 log-buf-len=1M print_fatal_signals=1값에 공백이 있으면 큰따옴표로 보호할 수 있습니다.
param="spaces in here"CPU 목록 문법
54-96`isolcpus`, `nohz_full`, `irqaffinity`, `rcu_nocbs` 같은 일부 매개변수는 CPU 목록을 값으로 받습니다.
| 형식 | 의미 |
|---|---|
| `<cpu number>,...,<cpu number>` | 쉼표로 구분한 개별 CPU 번호 목록입니다. |
| `<cpu number>-<cpu number>` | 오름차순의 양수 범위입니다. 시작 번호가 끝 번호보다 작거나 같아야 합니다. |
| `<cpu number>,...,<cpu number>-<cpu number>` | 개별 번호와 범위를 섞어 사용할 수 있습니다. |
| `<cpu number>-<cpu number>:<used size>/<group size>` | 범위를 같은 크기의 그룹으로 나누고 각 그룹의 앞부분에서 지정한 수만큼 선택합니다. |
원문 문법 예시는 다음과 같습니다.
<cpu number>,...,<cpu number> <cpu number>-<cpu number>
(must be a positive range in ascending order)<cpu number>,...,<cpu number>-<cpu number> <cpu number>-<cpu number>:<used size>/<group size>그룹 문법을 사용한 실제 예시는 다음과 같습니다.
isolcpus=1,2,10-20,100-2000:2/25마지막 항목은 CPU `100,101,125,126,150,151,...`을 뜻합니다. `N`은 시스템에서 숫자가 가장 큰 마지막 CPU를 나타냅니다. 예를 들어 32코어 시스템에서 `foo_cpus=16-N`은 `16-31`과 같습니다.
`N`은 동적입니다. CPU 목록의 코어 수가 줄어 bitmap 폭이 바뀌면 N과 N을 사용한 범위도 바뀝니다. 같은 입력을 4코어 시스템에서 사용하면 `16-N`이 `16-3`이 되어 시작이 끝보다 큰 잘못된 범위가 됩니다.
대소문자를 허용하는 특별 그룹 이름 `all`은 모든 CPU를 선택합니다. 따라서 `nohz_full=all`은 `nohz_full=0-N`과 같습니다. `N`과 `all`의 의미는 bitmap 수준에서 지원되며 `bitmap_parselist()`의 모든 사용처에 적용됩니다.
이진 단위 접미사
97-105커널 매개변수 값의 숫자 뒤에는 흔히 `[KMG]` 접미사를 붙입니다. 접미사는 생략할 수도 있으며 다음 문자는 십진 단위가 아니라 이진 배수를 뜻합니다.
| 접미사 | 이름 | 바이트 배수 |
|---|---|---|
| K | Kilo | 2^10 |
| M | Mega | 2^20 |
| G | Giga | 2^30 |
| T | Tera | 2^40 |
| P | Peta | 2^50 |
| E | Exa | 2^60 |
빌드 조건 태그 읽는 법
106-114아래 매개변수는 특정 커널 빌드 옵션이 켜져 있고 관련 하드웨어가 있을 때만 유효합니다. 목록은 알파벳 순서를 유지해야 합니다. 각 설명 앞의 대괄호 안 텍스트는 그 매개변수가 적용되는 조건을 나타냅니다.
커널 빌드 옵션과 아키텍처 태그
115-203| 태그 | 적용 조건 |
|---|---|
| ACPI | ACPI 지원이 활성화되어 있습니다. |
| AGP | AGP(Accelerated Graphics Port)가 활성화되어 있습니다. |
| ALSA | ALSA 사운드 지원이 활성화되어 있습니다. |
| APIC | APIC 지원이 활성화되어 있습니다. |
| APM | Advanced Power Management 지원이 활성화되어 있습니다. |
| APPARMOR | AppArmor 지원이 활성화되어 있습니다. |
| ARM | ARM 아키텍처가 활성화되어 있습니다. |
| ARM64 | ARM64 아키텍처가 활성화되어 있습니다. |
| AX25 | 해당 AX.25 지원이 활성화되어 있습니다. |
| CLK | 공통 clock infrastructure가 활성화되어 있습니다. |
| CMA | Contiguous Memory Area 지원이 활성화되어 있습니다. |
| DRM | Direct Rendering Management 지원이 활성화되어 있습니다. |
| DYNAMIC_DEBUG | 디버그 메시지가 빌드에 포함되고 런타임 활성화가 가능합니다. |
| EARLY | initrd에 넣기에는 너무 이른 시점에 처리되는 매개변수입니다. |
| EDD | BIOS Enhanced Disk Drive Services(EDD)가 활성화되어 있습니다. |
| EFI | EFI 파티셔닝(GPT)이 활성화되어 있습니다. |
| EVM | Extended Verification Module 관련 항목입니다. |
| FB | frame buffer 장치가 활성화되어 있습니다. |
| FTRACE | 함수 tracing이 활성화되어 있습니다. |
| GCOV | GCOV profiling이 활성화되어 있습니다. |
| HIBERNATION | HIBERNATION이 활성화되어 있습니다. |
| HW | 해당 하드웨어가 활성화되어 있습니다. |
| HYPER_V | HYPER-V 지원이 활성화되어 있습니다. |
| IMA | Integrity Measurement Architecture가 활성화되어 있습니다. |
| IP_PNP | IP DHCP, BOOTP 또는 RARP가 활성화되어 있습니다. |
| IPV6 | IPv6 지원이 활성화되어 있습니다. |
| ISAPNP | ISA PnP 코드가 활성화되어 있습니다. |
| ISDN | 해당 ISDN 지원이 활성화되어 있습니다. |
| ISOL | CPU Isolation이 활성화되어 있습니다. |
| JOY | 해당 joystick 지원이 활성화되어 있습니다. |
| KGDB | 커널 debugger 지원이 활성화되어 있습니다. |
| KVM | Kernel Virtual Machine 지원이 활성화되어 있습니다. |
| LIBATA | Libata 드라이버가 활성화되어 있습니다. |
| LOONGARCH | LoongArch 아키텍처가 활성화되어 있습니다. |
| LOOP | loopback 장치 지원이 활성화되어 있습니다. |
| LP | 프린터 지원이 활성화되어 있습니다. |
| M68k | M68k 아키텍처가 활성화되어 있습니다. 자세한 설명은 `Documentation/arch/m68k/kernel-options.rst`에 있습니다. |
| MDA | MDA 콘솔 지원이 활성화되어 있습니다. |
| MIPS | MIPS 아키텍처가 활성화되어 있습니다. |
| MOUSE | 해당 mouse 지원이 활성화되어 있습니다. |
| MSI | PCI Message Signaled Interrupts 관련 항목입니다. |
| MTD | MTD(Memory Technology Device) 지원이 활성화되어 있습니다. |
| NET | 해당 네트워크 지원이 활성화되어 있습니다. |
| NFS | 해당 NFS 지원이 활성화되어 있습니다. |
| NUMA | NUMA 지원이 활성화되어 있습니다. |
| OF | Devicetree가 활성화되어 있습니다. |
| PARISC | PA-RISC 아키텍처가 활성화되어 있습니다. |
| PCI | PCI 버스 지원이 활성화되어 있습니다. |
| PCIE | PCI Express 지원이 활성화되어 있습니다. |
| PCMCIA | PCMCIA 하위 시스템이 활성화되어 있습니다. |
| PNP | Plug & Play 지원이 활성화되어 있습니다. |
| PPC | PowerPC 아키텍처가 활성화되어 있습니다. |
| PPT | parallel port 지원이 활성화되어 있습니다. |
| PS2 | 해당 PS/2 지원이 활성화되어 있습니다. |
| PV_OPS | paravirtualized 커널이 활성화되어 있습니다. |
| RAM | RAM disk 지원이 활성화되어 있습니다. |
| RDT | Intel Resource Director Technology 관련 항목입니다. |
| RISCV | RISCV 아키텍처가 활성화되어 있습니다. |
| S390 | S390 아키텍처가 활성화되어 있습니다. |
| SCSI | 해당 SCSI 지원이 활성화되어 있습니다. 많은 드라이버 옵션은 `Documentation/scsi/` 하위 디렉터리에 설명되어 있습니다. |
| SDW | SoundWire 지원이 활성화되어 있습니다. |
| SECURITY | 여러 security model이 활성화되어 있습니다. |
| SELINUX | SELinux 지원이 활성화되어 있습니다. |
| SERIAL | serial 지원이 활성화되어 있습니다. |
| SH | SuperH 아키텍처가 활성화되어 있습니다. |
| SMP | 커널이 SMP 커널입니다. |
| SPARC | Sparc 아키텍처가 활성화되어 있습니다. |
| SUSPEND | 시스템 suspend state가 활성화되어 있습니다. |
| SWSUSP | software suspend(hibernation)가 활성화되어 있습니다. |
| TPM | TPM 드라이버가 활성화되어 있습니다. |
| UMS | USB Mass Storage 지원이 활성화되어 있습니다. |
| USB | USB 지원이 활성화되어 있습니다. |
| USBHID | USB Human Interface Device 지원이 활성화되어 있습니다. |
| V4L | Video For Linux 지원이 활성화되어 있습니다. |
| VGA | VGA 콘솔이 활성화되어 있습니다. |
| VMMIO | memory-mapped virtio 장치 드라이버가 활성화되어 있습니다. |
| VT | virtual terminal 지원이 활성화되어 있습니다. |
| WDT | watchdog 지원이 활성화되어 있습니다. |
| X86-32 | i386이라고도 하는 X86-32 아키텍처가 활성화되어 있습니다. |
| X86-64 | X86-64 아키텍처가 활성화되어 있습니다. |
| X86 | 32비트 또는 64비트 x86입니다. `X86-32+X86-64`와 같습니다. |
| X86_UV | SGI UV 지원이 활성화되어 있습니다. |
| XEN | Xen 지원이 활성화되어 있습니다. |
| XTENSA | Xtensa 아키텍처가 활성화되어 있습니다. |
추가 태그와 최종 제약
204-228| 표기 | 의미 |
|---|---|
| BOOT | 부트 로더 매개변수입니다. |
| BUGS= | 해당 프로세서에서 발생 가능한 processor bug와 관련됩니다. |
| KNL | 커널 시작 매개변수입니다. |
`BOOT`로 표시된 매개변수는 실제로 부트 로더가 해석하며 커널 자체에는 직접 의미가 없습니다. 꼭 필요한 경우가 아니거나 `Documentation/arch/x86/boot.rst`와 조율하지 않았다면 부트 로더 매개변수 문법을 바꾸지 마십시오.
여기에 문서화되지 않은 아키텍처별 커널 매개변수도 있습니다.
아래에 나열되는 모든 커널 매개변수는 대소문자를 구분합니다. 이름 끝의 `=`은 매개변수가 환경 변수로 들어감을 뜻합니다. `=`이 없으면 시스템 부팅 뒤 프로그램이 `/proc/cmdline`에서 읽을 수 있는 커널 인수가 됩니다.
커널 매개변수 개수에는 제한이 없지만 공백을 포함한 전체 명령줄 길이는 고정 문자 수로 제한됩니다. 아키텍처에 따라 256~4096자이며 `./include/uapi/asm-generic/setup.h`의 `COMMAND_LINE_SIZE`로 정의됩니다.
전체 매개변수 목록 포함
229-230실제 전체 매개변수 목록은 `kernel-parameters.txt`를 literal 형식으로 포함합니다.
.. include:: kernel-parameters.txt
:literal:
전달 규칙
kernel-parameters.rst:1-53커널, init과 모듈에 매개변수가 전달되는 방식과 이름·공백 처리 규칙을 설명합니다.