docs/admin-guide: introduce basic index for mm documentation
authorMike Rapoport <rppt@linux.vnet.ibm.com>
Wed, 18 Apr 2018 08:07:48 +0000 (11:07 +0300)
committerJonathan Corbet <corbet@lwn.net>
Fri, 27 Apr 2018 23:02:44 +0000 (17:02 -0600)
Signed-off-by: Mike Rapoport <rppt@linux.vnet.ibm.com>
Signed-off-by: Jonathan Corbet <corbet@lwn.net>
Documentation/admin-guide/index.rst
Documentation/admin-guide/mm/index.rst [new file with mode: 0644]

index 5bb9161..cac906f 100644 (file)
@@ -63,6 +63,7 @@ configure specific aspects of kernel behavior to your liking.
    pm/index
    thunderbolt
    LSM/index
+   mm/index
 
 .. only::  subproject and html
 
diff --git a/Documentation/admin-guide/mm/index.rst b/Documentation/admin-guide/mm/index.rst
new file mode 100644 (file)
index 0000000..c47c16e
--- /dev/null
@@ -0,0 +1,19 @@
+=================
+Memory Management
+=================
+
+Linux memory management subsystem is responsible, as the name implies,
+for managing the memory in the system. This includes implemnetation of
+virtual memory and demand paging, memory allocation both for kernel
+internal structures and user space programms, mapping of files into
+processes address space and many other cool things.
+
+Linux memory management is a complex system with many configurable
+settings. Most of these settings are available via ``/proc``
+filesystem and can be quired and adjusted using ``sysctl``. These APIs
+are described in Documentation/sysctl/vm.txt and in `man 5 proc`_.
+
+.. _man 5 proc: http://man7.org/linux/man-pages/man5/proc.5.html
+
+Here we document in detail how to interact with various mechanisms in
+the Linux memory management.