This documents ignore-unaligned-usertrap, unaligned-dump-stack, and
unaligned-trap, based on arch/arc/kernel/unaligned.c,
arch/ia64/kernel/unaligned.c, and arch/parisc/kernel/unaligned.c.
While we’re at it, integrate unaligned-memory-access.txt into the docs
tree.
Signed-off-by: Stephen Kitt <[email protected]>
---
Documentation/admin-guide/sysctl/kernel.rst | 51 +++++++++++++++++++
Documentation/index.rst | 1 +
...access.txt => unaligned-memory-access.rst} | 0
3 files changed, 52 insertions(+)
rename Documentation/{unaligned-memory-access.txt => unaligned-memory-access.rst} (100%)
diff --git a/Documentation/admin-guide/sysctl/kernel.rst b/Documentation/admin-guide/sysctl/kernel.rst
index eb6bc9cc0318..4bb4d55f20ff 100644
--- a/Documentation/admin-guide/sysctl/kernel.rst
+++ b/Documentation/admin-guide/sysctl/kernel.rst
@@ -402,6 +402,25 @@ Controls whether the panic kmsg data should be reported to Hyper-V.
= =========================================================
+ignore-unaligned-usertrap
+=========================
+
+On architectures where unaligned accesses cause traps, and where this
+feature is supported (``CONFIG_SYSCTL_ARCH_UNALIGN_NO_WARN``;
+currently, ``arc`` and ``ia64``), controls whether all unaligned traps
+are logged.
+
+= =============================================================
+0 Log all unaligned accesses.
+1 Only warn the first time a process traps. This is the default
+ setting.
+= =============================================================
+
+See also `unaligned-trap`_ and `unaligned-dump-stack`_. On ``ia64``,
+this allows system administrators to override the
+``IA64_THREAD_UAC_NOPRINT`` ``prctl`` and avoid logs being flooded.
+
+
kexec_load_disabled
===================
@@ -1252,6 +1271,38 @@ See :doc:`/admin-guide/kernel-parameters` and
:doc:`/trace/boottime-trace`.
+.. _unaligned-dump-stack:
+
+unaligned-dump-stack (ia64)
+===========================
+
+When logging unaligned accesses, controls whether the stack is
+dumped.
+
+= ===================================================
+0 Do not dump the stack. This is the default setting.
+1 Dump the stack.
+= ===================================================
+
+See also `ignore-unaligned-usertrap`_.
+
+
+unaligned-trap
+==============
+
+On architectures where unaligned accesses cause traps, and where this
+feature is supported (``CONFIG_SYSCTL_ARCH_UNALIGN_ALLOW``; currently,
+``arc`` and ``parisc``), controls whether unaligned traps are caught
+and emulated (instead of failing).
+
+= ========================================================
+0 Do not emulate unaligned accesses.
+1 Emulate unaligned accesses. This is the default setting.
+= ========================================================
+
+See also `ignore-unaligned-usertrap`_.
+
+
unknown_nmi_panic
=================
diff --git a/Documentation/index.rst b/Documentation/index.rst
index 9599c0f3eea8..17c38d899572 100644
--- a/Documentation/index.rst
+++ b/Documentation/index.rst
@@ -143,6 +143,7 @@ Architecture-agnostic documentation
:maxdepth: 2
asm-annotations
+ unaligned-memory-access
Architecture-specific documentation
-----------------------------------
diff --git a/Documentation/unaligned-memory-access.txt b/Documentation/unaligned-memory-access.rst
similarity index 100%
rename from Documentation/unaligned-memory-access.txt
rename to Documentation/unaligned-memory-access.rst
base-commit: 56b62540782bfde459acc8eb15b949eaf151c881
--
2.20.1
On Fri, 15 May 2020 18:04:06 +0200
Stephen Kitt <[email protected]> wrote:
> diff --git a/Documentation/index.rst b/Documentation/index.rst
> index 9599c0f3eea8..17c38d899572 100644
> --- a/Documentation/index.rst
> +++ b/Documentation/index.rst
> @@ -143,6 +143,7 @@ Architecture-agnostic documentation
> :maxdepth: 2
>
> asm-annotations
> + unaligned-memory-access
>
> Architecture-specific documentation
> -----------------------------------
> diff --git a/Documentation/unaligned-memory-access.txt b/Documentation/unaligned-memory-access.rst
> similarity index 100%
> rename from Documentation/unaligned-memory-access.txt
> rename to Documentation/unaligned-memory-access.rst
Adding this to the toctree is great, but I'd just as soon not leave it in
the top-level directory while we do that. Since you're renaming it
anyway, can you move it into process/? It's not a perfect fit, but that's
where that type of material has been going so far.
Thanks,
jon
On Fri, 15 May 2020 11:27:35 -0600, Jonathan Corbet <[email protected]> wrote:
> On Fri, 15 May 2020 18:04:06 +0200
> Stephen Kitt <[email protected]> wrote:
>
> > diff --git a/Documentation/index.rst b/Documentation/index.rst
> > index 9599c0f3eea8..17c38d899572 100644
> > --- a/Documentation/index.rst
> > +++ b/Documentation/index.rst
> > @@ -143,6 +143,7 @@ Architecture-agnostic documentation
> > :maxdepth: 2
> >
> > asm-annotations
> > + unaligned-memory-access
> >
> > Architecture-specific documentation
> > -----------------------------------
> > diff --git a/Documentation/unaligned-memory-access.txt
> > b/Documentation/unaligned-memory-access.rst similarity index 100%
> > rename from Documentation/unaligned-memory-access.txt
> > rename to Documentation/unaligned-memory-access.rst
>
> Adding this to the toctree is great, but I'd just as soon not leave it in
> the top-level directory while we do that. Since you're renaming it
> anyway, can you move it into process/? It's not a perfect fit, but that's
> where that type of material has been going so far.
I can indeed. Should it still be listed in the main toctree, or in the
process toctree?
Regards,
Stephen
On Fri, 15 May 2020 20:36:01 +0200, Stephen Kitt <[email protected]> wrote:
> On Fri, 15 May 2020 11:27:35 -0600, Jonathan Corbet <[email protected]> wrote:
> > On Fri, 15 May 2020 18:04:06 +0200
> > Stephen Kitt <[email protected]> wrote:
> >
> > > diff --git a/Documentation/index.rst b/Documentation/index.rst
> > > index 9599c0f3eea8..17c38d899572 100644
> > > --- a/Documentation/index.rst
> > > +++ b/Documentation/index.rst
> > > @@ -143,6 +143,7 @@ Architecture-agnostic documentation
> > > :maxdepth: 2
> > >
> > > asm-annotations
> > > + unaligned-memory-access
> > >
> > > Architecture-specific documentation
> > > -----------------------------------
> > > diff --git a/Documentation/unaligned-memory-access.txt
> > > b/Documentation/unaligned-memory-access.rst similarity index 100%
> > > rename from Documentation/unaligned-memory-access.txt
> > > rename to Documentation/unaligned-memory-access.rst
> >
> > Adding this to the toctree is great, but I'd just as soon not leave it in
> > the top-level directory while we do that. Since you're renaming it
> > anyway, can you move it into process/? It's not a perfect fit, but that's
> > where that type of material has been going so far.
>
> I can indeed. Should it still be listed in the main toctree, or in the
> process toctree?
Never mind, I found the answer, “some overall technical guides that have been
put here for now for lack of a better place” ;-).
Regards,
Stephen