[PATCH] Make high and batch sizes of per_cpu_pagelists configurable
[linux-2.6.git] / Documentation / sysctl / vm.txt
1 Documentation for /proc/sys/vm/*        kernel version 2.2.10
2         (c) 1998, 1999,  Rik van Riel <riel@nl.linux.org>
3
4 For general info and legal blurb, please look in README.
5
6 ==============================================================
7
8 This file contains the documentation for the sysctl files in
9 /proc/sys/vm and is valid for Linux kernel version 2.2.
10
11 The files in this directory can be used to tune the operation
12 of the virtual memory (VM) subsystem of the Linux kernel and
13 the writeout of dirty data to disk.
14
15 Default values and initialization routines for most of these
16 files can be found in mm/swap.c.
17
18 Currently, these files are in /proc/sys/vm:
19 - overcommit_memory
20 - page-cluster
21 - dirty_ratio
22 - dirty_background_ratio
23 - dirty_expire_centisecs
24 - dirty_writeback_centisecs
25 - max_map_count
26 - min_free_kbytes
27 - laptop_mode
28 - block_dump
29 - drop-caches
30
31 ==============================================================
32
33 dirty_ratio, dirty_background_ratio, dirty_expire_centisecs,
34 dirty_writeback_centisecs, vfs_cache_pressure, laptop_mode,
35 block_dump, swap_token_timeout, drop-caches:
36
37 See Documentation/filesystems/proc.txt
38
39 ==============================================================
40
41 overcommit_memory:
42
43 This value contains a flag that enables memory overcommitment.
44
45 When this flag is 0, the kernel attempts to estimate the amount
46 of free memory left when userspace requests more memory.
47
48 When this flag is 1, the kernel pretends there is always enough
49 memory until it actually runs out.
50
51 When this flag is 2, the kernel uses a "never overcommit"
52 policy that attempts to prevent any overcommit of memory.  
53
54 This feature can be very useful because there are a lot of
55 programs that malloc() huge amounts of memory "just-in-case"
56 and don't use much of it.
57
58 The default value is 0.
59
60 See Documentation/vm/overcommit-accounting and
61 security/commoncap.c::cap_vm_enough_memory() for more information.
62
63 ==============================================================
64
65 overcommit_ratio:
66
67 When overcommit_memory is set to 2, the committed address
68 space is not permitted to exceed swap plus this percentage
69 of physical RAM.  See above.
70
71 ==============================================================
72
73 page-cluster:
74
75 The Linux VM subsystem avoids excessive disk seeks by reading
76 multiple pages on a page fault. The number of pages it reads
77 is dependent on the amount of memory in your machine.
78
79 The number of pages the kernel reads in at once is equal to
80 2 ^ page-cluster. Values above 2 ^ 5 don't make much sense
81 for swap because we only cluster swap data in 32-page groups.
82
83 ==============================================================
84
85 max_map_count:
86
87 This file contains the maximum number of memory map areas a process
88 may have. Memory map areas are used as a side-effect of calling
89 malloc, directly by mmap and mprotect, and also when loading shared
90 libraries.
91
92 While most applications need less than a thousand maps, certain
93 programs, particularly malloc debuggers, may consume lots of them,
94 e.g., up to one or two maps per allocation.
95
96 The default value is 65536.
97
98 ==============================================================
99
100 min_free_kbytes:
101
102 This is used to force the Linux VM to keep a minimum number 
103 of kilobytes free.  The VM uses this number to compute a pages_min
104 value for each lowmem zone in the system.  Each lowmem zone gets 
105 a number of reserved free pages based proportionally on its size.
106
107 ==============================================================
108
109 percpu_pagelist_fraction
110
111 This is the fraction of pages at most (high mark pcp->high) in each zone that
112 are allocated for each per cpu page list.  The min value for this is 8.  It
113 means that we don't allow more than 1/8th of pages in each zone to be
114 allocated in any single per_cpu_pagelist.  This entry only changes the value
115 of hot per cpu pagelists.  User can specify a number like 100 to allocate
116 1/100th of each zone to each per cpu page list.
117
118 The batch value of each per cpu pagelist is also updated as a result.  It is
119 set to pcp->high/4.  The upper limit of batch is (PAGE_SHIFT * 8)
120
121 The initial value is zero.  Kernel does not use this value at boot time to set
122 the high water marks for each per cpu page list.