* [PATCH 0/3] Documentation/admin-guide: kernel-parameters: parameter cleanups
@ 2020-09-10 3:26 Randy Dunlap
2020-09-10 3:26 ` [PATCH 1/3] Documentation/admin-guide: kernel-parameters: update CMA entries Randy Dunlap
` (2 more replies)
0 siblings, 3 replies; 5+ messages in thread
From: Randy Dunlap @ 2020-09-10 3:26 UTC (permalink / raw)
To: linux-kernel; +Cc: Randy Dunlap, Jonathan Corbet, linux-doc
Cc: Jonathan Corbet <corbet@lwn.net>
Cc: linux-doc@vger.kernel.org
[PATCH 1/3] Documentation/admin-guide: kernel-parameters: update CMA entries
[PATCH 2/3] Documentation/admin-guide: kernel-parameters: hyphenate comma-separated
[PATCH 3/3] Documentation/admin-guide: kernel-parameters: add early_param() to list of types of boot parameters
Documentation/admin-guide/kernel-parameters.rst | 4 +-
Documentation/admin-guide/kernel-parameters.txt | 22 +++++++-------
2 files changed, 13 insertions(+), 13 deletions(-)
^ permalink raw reply [flat|nested] 5+ messages in thread
* [PATCH 1/3] Documentation/admin-guide: kernel-parameters: update CMA entries
2020-09-10 3:26 [PATCH 0/3] Documentation/admin-guide: kernel-parameters: parameter cleanups Randy Dunlap
@ 2020-09-10 3:26 ` Randy Dunlap
2020-09-10 17:04 ` Jonathan Corbet
2020-09-10 3:26 ` [PATCH 2/3] Documentation/admin-guide: kernel-parameters: hyphenate comma-separated Randy Dunlap
2020-09-10 3:26 ` [PATCH 3/3] Documentation/admin-guide: kernel-parameters: add early_param() to list of types of boot parameters Randy Dunlap
2 siblings, 1 reply; 5+ messages in thread
From: Randy Dunlap @ 2020-09-10 3:26 UTC (permalink / raw)
To: linux-kernel; +Cc: Randy Dunlap, Jonathan Corbet, linux-doc
Add qualifying build option legend [CMA] to kernel boot options
that requirce CMA support to be enabled for them to be usable.
Also capitalize 'CMA' when it is used as an acronym.
Signed-off-by: Randy Dunlap <rdunlap@infradead.org>
Cc: Jonathan Corbet <corbet@lwn.net>
Cc: linux-doc@vger.kernel.org
---
Documentation/admin-guide/kernel-parameters.txt | 10 +++++-----
1 file changed, 5 insertions(+), 5 deletions(-)
--- linux-next-20200909.orig/Documentation/admin-guide/kernel-parameters.txt
+++ linux-next-20200909/Documentation/admin-guide/kernel-parameters.txt
@@ -591,7 +591,7 @@
some critical bits.
cma=nn[MG]@[start[MG][-end[MG]]]
- [ARM,X86,KNL]
+ [ARM,X86,KNL,CMA]
Sets the size of kernel global memory area for
contiguous memory allocations and optionally the
placement constraint by the physical address range of
@@ -600,7 +600,7 @@
include/linux/dma-contiguous.h
cma_pernuma=nn[MG]
- [ARM64,KNL]
+ [ARM64,KNL,CMA]
Sets the size of kernel per-numa memory area for
contiguous memory allocations. A value of 0 disables
per-numa CMA altogether. And If this option is not
@@ -1524,12 +1524,12 @@
hpet_mmap= [X86, HPET_MMAP] Allow userspace to mmap HPET
registers. Default set by CONFIG_HPET_MMAP_DEFAULT.
- hugetlb_cma= [HW] The size of a cma area used for allocation
+ hugetlb_cma= [HW,CMA] The size of a CMA area used for allocation
of gigantic hugepages.
Format: nn[KMGTPE]
- Reserve a cma area of given size and allocate gigantic
- hugepages using the cma allocator. If enabled, the
+ Reserve a CMA area of given size and allocate gigantic
+ hugepages using the CMA allocator. If enabled, the
boot-time allocation of gigantic hugepages is skipped.
hugepages= [HW] Number of HugeTLB pages to allocate at boot.
^ permalink raw reply [flat|nested] 5+ messages in thread
* [PATCH 2/3] Documentation/admin-guide: kernel-parameters: hyphenate comma-separated
2020-09-10 3:26 [PATCH 0/3] Documentation/admin-guide: kernel-parameters: parameter cleanups Randy Dunlap
2020-09-10 3:26 ` [PATCH 1/3] Documentation/admin-guide: kernel-parameters: update CMA entries Randy Dunlap
@ 2020-09-10 3:26 ` Randy Dunlap
2020-09-10 3:26 ` [PATCH 3/3] Documentation/admin-guide: kernel-parameters: add early_param() to list of types of boot parameters Randy Dunlap
2 siblings, 0 replies; 5+ messages in thread
From: Randy Dunlap @ 2020-09-10 3:26 UTC (permalink / raw)
To: linux-kernel; +Cc: Randy Dunlap, Jonathan Corbet, linux-doc
When "comma separated" is used as a compound adjective, it should be
hyphenated.
Signed-off-by: Randy Dunlap <rdunlap@infradead.org>
Cc: Jonathan Corbet <corbet@lwn.net>
Cc: linux-doc@vger.kernel.org
---
Documentation/admin-guide/kernel-parameters.txt | 12 ++++++------
1 file changed, 6 insertions(+), 6 deletions(-)
--- linux-next-20200909.orig/Documentation/admin-guide/kernel-parameters.txt
+++ linux-next-20200909/Documentation/admin-guide/kernel-parameters.txt
@@ -1385,7 +1385,7 @@
ftrace_filter=[function-list]
[FTRACE] Limit the functions traced by the function
- tracer at boot up. function-list is a comma separated
+ tracer at boot up. function-list is a comma-separated
list of functions. This list can be changed at run
time by the set_ftrace_filter file in the debugfs
tracing directory.
@@ -1399,13 +1399,13 @@
ftrace_graph_filter=[function-list]
[FTRACE] Limit the top level callers functions traced
by the function graph tracer at boot up.
- function-list is a comma separated list of functions
+ function-list is a comma-separated list of functions
that can be changed at run time by the
set_graph_function file in the debugfs tracing directory.
ftrace_graph_notrace=[function-list]
[FTRACE] Do not trace from the functions specified in
- function-list. This list is a comma separated list of
+ function-list. This list is a comma-separated list of
functions that can be changed at run time by the
set_graph_notrace file in the debugfs tracing directory.
@@ -2407,7 +2407,7 @@
when set.
Format: <int>
- libata.force= [LIBATA] Force configurations. The format is comma
+ libata.force= [LIBATA] Force configurations. The format is comma-
separated list of "[ID:]VAL" where ID is
PORT[.DEVICE]. PORT and DEVICE are decimal numbers
matching port, link or device. Basically, it matches
@@ -5123,7 +5123,7 @@
stacktrace_filter=[function-list]
[FTRACE] Limit the functions that the stack tracer
- will trace at boot up. function-list is a comma separated
+ will trace at boot up. function-list is a comma-separated
list of functions. This list can be changed at run
time by the stack_trace_filter file in the debugfs
tracing directory. Note, this enables stack tracing
@@ -5326,7 +5326,7 @@
trace_event=[event-list]
[FTRACE] Set and start specified trace events in order
to facilitate early boot debugging. The event-list is a
- comma separated list of trace events to enable. See
+ comma-separated list of trace events to enable. See
also Documentation/trace/events.rst
trace_options=[option-list]
^ permalink raw reply [flat|nested] 5+ messages in thread
* [PATCH 3/3] Documentation/admin-guide: kernel-parameters: add early_param() to list of types of boot parameters
2020-09-10 3:26 [PATCH 0/3] Documentation/admin-guide: kernel-parameters: parameter cleanups Randy Dunlap
2020-09-10 3:26 ` [PATCH 1/3] Documentation/admin-guide: kernel-parameters: update CMA entries Randy Dunlap
2020-09-10 3:26 ` [PATCH 2/3] Documentation/admin-guide: kernel-parameters: hyphenate comma-separated Randy Dunlap
@ 2020-09-10 3:26 ` Randy Dunlap
2 siblings, 0 replies; 5+ messages in thread
From: Randy Dunlap @ 2020-09-10 3:26 UTC (permalink / raw)
To: linux-kernel; +Cc: Randy Dunlap, Jonathan Corbet, linux-doc
early_param() is missing from the list of types of kernel command line
parameters that are listed in kernel-parameters.txt, so add it
(so that I can find parameters more easily).
Signed-off-by: Randy Dunlap <rdunlap@infradead.org>
Cc: Jonathan Corbet <corbet@lwn.net>
Cc: linux-doc@vger.kernel.org
---
Documentation/admin-guide/kernel-parameters.rst | 4 ++--
1 file changed, 2 insertions(+), 2 deletions(-)
--- linux-next-20200909.orig/Documentation/admin-guide/kernel-parameters.rst
+++ linux-next-20200909/Documentation/admin-guide/kernel-parameters.rst
@@ -3,8 +3,8 @@
The kernel's command-line parameters
====================================
-The following is a consolidated list of the kernel parameters as
-implemented by the __setup(), core_param() and module_param() macros
+The following is a consolidated list of the kernel parameters as implemented
+by the __setup(), early_param(), core_param() and module_param() macros
and sorted into English Dictionary order (defined as ignoring all
punctuation and sorting digits before letters in a case insensitive
manner), and with descriptions where known.
^ permalink raw reply [flat|nested] 5+ messages in thread
* Re: [PATCH 1/3] Documentation/admin-guide: kernel-parameters: update CMA entries
2020-09-10 3:26 ` [PATCH 1/3] Documentation/admin-guide: kernel-parameters: update CMA entries Randy Dunlap
@ 2020-09-10 17:04 ` Jonathan Corbet
0 siblings, 0 replies; 5+ messages in thread
From: Jonathan Corbet @ 2020-09-10 17:04 UTC (permalink / raw)
To: Randy Dunlap; +Cc: linux-kernel, linux-doc
On Wed, 9 Sep 2020 20:26:04 -0700
Randy Dunlap <rdunlap@infradead.org> wrote:
> Add qualifying build option legend [CMA] to kernel boot options
> that requirce CMA support to be enabled for them to be usable.
>
> Also capitalize 'CMA' when it is used as an acronym.
>
> Signed-off-by: Randy Dunlap <rdunlap@infradead.org>
> Cc: Jonathan Corbet <corbet@lwn.net>
> Cc: linux-doc@vger.kernel.org
This doesn't apply to docs-next; it seems you're fixing 5.10 stuff in
linux-next that went through Christoph's tree? So this patch will need to
go to him.
Thanks,
jon
^ permalink raw reply [flat|nested] 5+ messages in thread
end of thread, other threads:[~2020-09-10 17:04 UTC | newest]
Thread overview: 5+ messages (download: mbox.gz / follow: Atom feed)
-- links below jump to the message on this page --
2020-09-10 3:26 [PATCH 0/3] Documentation/admin-guide: kernel-parameters: parameter cleanups Randy Dunlap
2020-09-10 3:26 ` [PATCH 1/3] Documentation/admin-guide: kernel-parameters: update CMA entries Randy Dunlap
2020-09-10 17:04 ` Jonathan Corbet
2020-09-10 3:26 ` [PATCH 2/3] Documentation/admin-guide: kernel-parameters: hyphenate comma-separated Randy Dunlap
2020-09-10 3:26 ` [PATCH 3/3] Documentation/admin-guide: kernel-parameters: add early_param() to list of types of boot parameters Randy Dunlap
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for NNTP newsgroup(s).