diff options
author | Stephen Kitt <steve@sk2.org> | 2020-09-11 22:01:52 +0300 |
---|---|---|
committer | Jonathan Corbet <corbet@lwn.net> | 2020-09-16 21:38:31 +0300 |
commit | 9f35cf8bd7e3347b0679c3f9b5e0bc5493925a1f (patch) | |
tree | 514601f7dba863526489d4392ee488fe6b7e84a0 | |
parent | a070991fe9d1b6d97eb3cf24a2a6ed5f8e7c0169 (diff) | |
download | linux-9f35cf8bd7e3347b0679c3f9b5e0bc5493925a1f.tar.xz |
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: Stephen Kitt <steve@sk2.org>
Link: https://lore.kernel.org/r/20200911190152.29730-1-steve@sk2.org
Signed-off-by: Jonathan Corbet <corbet@lwn.net>
-rw-r--r-- | Documentation/admin-guide/sysctl/abi.rst | 71 |
1 files changed, 18 insertions, 53 deletions
diff --git a/Documentation/admin-guide/sysctl/abi.rst b/Documentation/admin-guide/sysctl/abi.rst index 599bcde7f0b7..d88b48db8bf9 100644 --- a/Documentation/admin-guide/sysctl/abi.rst +++ b/Documentation/admin-guide/sysctl/abi.rst @@ -2,66 +2,31 @@ 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. -When a process is executed, it's linked to an exec_domain whose -personality is defined using values available from /proc/sys/abi. -You can find further details about abi in include/linux/personality.h. +The files in ``/proc/sys/abi`` can be used to see and modify +ABI-related settings. -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 -- defhandler_elf -- defhandler_lcall7 -- defhandler_libcso -- fake_utsname -- trace +.. contents:: :local: -defhandler_coff ---------------- +vsyscall32 (x86) +================ -defined value: - PER_SCOSVR3:: +Determines whether the kernels maps a vDSO page into 32-bit processes; +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 - -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 +This controls the same setting as the ``vdso32`` kernel boot +parameter. |