Commit 9f35cf8b authored by Stephen Kitt's avatar Stephen Kitt Committed by Jonathan Corbet

docs: rewrite admin-guide/sysctl/abi.rst

Following the structure used in sysctl/kernel.rst, this updates
abi.rst to use ReStructured Text more fully and updates the entries to
match current kernels:

  * the list of files is now the table of contents;
  * links are used to point to other documentation and other sections;
  * all the existing entries are no longer present, so this removes
    them;
  * document vsyscall32.

Mentions of the kernel version are dropped. Since the document is
entirely rewritten, I've replaced the copyright statement.
Signed-off-by: default avatarStephen Kitt <steve@sk2.org>
Link: https://lore.kernel.org/r/20200911190152.29730-1-steve@sk2.orgSigned-off-by: default avatarJonathan Corbet <corbet@lwn.net>
parent a070991f
...@@ -2,66 +2,31 @@ ...@@ -2,66 +2,31 @@
Documentation for /proc/sys/abi/ Documentation for /proc/sys/abi/
================================ ================================
kernel version 2.6.0.test2 .. See scripts/check-sysctl-docs to keep this up to date:
.. scripts/check-sysctl-docs -vtable="abi" \
.. Documentation/admin-guide/sysctl/abi.rst \
.. $(git grep -l register_sysctl_)
Copyright (c) 2003, Fabian Frederick <ffrederick@users.sourceforge.net> Copyright (c) 2020, Stephen Kitt
For general info: index.rst. For general info, see :doc:`index`.
------------------------------------------------------------------------------ ------------------------------------------------------------------------------
This path is binary emulation relevant aka personality types aka abi. The files in ``/proc/sys/abi`` can be used to see and modify
When a process is executed, it's linked to an exec_domain whose ABI-related settings.
personality is defined using values available from /proc/sys/abi.
You can find further details about abi in include/linux/personality.h.
Here are the files featuring in 2.6 kernel: Currently, these files might (depending on your configuration)
show up in ``/proc/sys/kernel``:
- defhandler_coff .. contents:: :local:
- defhandler_elf
- defhandler_lcall7
- defhandler_libcso
- fake_utsname
- trace
defhandler_coff vsyscall32 (x86)
--------------- ================
defined value: Determines whether the kernels maps a vDSO page into 32-bit processes;
PER_SCOSVR3:: can be set to 1 to enable, or 0 to disable. Defaults to enabled if
``CONFIG_COMPAT_VDSO`` is set, disabled otherwide.
0x0003 | STICKY_TIMEOUTS | WHOLE_SECONDS | SHORT_INODE This controls the same setting as the ``vdso32`` kernel boot
parameter.
defhandler_elf
--------------
defined value:
PER_LINUX::
0
defhandler_lcall7
-----------------
defined value :
PER_SVR4::
0x0001 | STICKY_TIMEOUTS | MMAP_PAGE_ZERO,
defhandler_libsco
-----------------
defined value:
PER_SVR4::
0x0001 | STICKY_TIMEOUTS | MMAP_PAGE_ZERO,
fake_utsname
------------
Unused
trace
-----
Unused
Markdown is supported
0%
or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment