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

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.org


Signed-off-by: default avatarJonathan Corbet <corbet@lwn.net>
parent a070991f

Documentation/admin-guide/sysctl/abi.rst

+18 −53
Original line number Diff line number Diff line
@@ -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.

CRA Git | Maintained and supported by SUSTech CRA and CCSE