Debian Codegraph @

upstream/debian-unstable/man5/proc_meminfo.5

raw
1 .\" Copyright 1994-1995, Daniel Quinlan <[email protected]>
2 .\" Copyright 2002-2017, Michael Kerrisk <[email protected]>
3 .\" Copyright, the authors of the Linux man-pages project
4 .\"
5 .\" SPDX-License-Identifier: GPL-3.0-or-later
6 .\"
7 .TH proc_meminfo 5 2026-02-08 "Linux man-pages 6.18"
8 .SH NAME
9 /proc/meminfo \- memory usage
10 .SH DESCRIPTION
11 .TP
12 .I /proc/meminfo
13 This file reports statistics about memory usage on the system.
14 It is used by
15 .BR free (1)
16 to report the amount of free and used memory (both physical and swap)
17 on the system as well as the shared memory and buffers used by the
18 kernel.
19 Each line of the file consists of
20 a parameter name,
21 followed by a colon,
22 the value of the parameter,
23 and an option unit of measurement (e.g., "kB").
24 The list below describes the parameter names and
25 the format specifier required to read the field value.
26 Except as noted below,
27 all of the fields have been present since at least Linux 2.6.0.
28 Some fields are displayed
29 only if the kernel was configured with various options;
30 those dependencies are noted in the list.
31 .RS
32 .TP
33 .IR MemTotal " %lu"
34 Total usable RAM (i.e., physical RAM minus a few reserved
35 bits and the kernel binary code).
36 .TP
37 .IR MemFree " %lu"
38 The sum of
39 .IR LowFree + HighFree .
40 .TP
41 .IR MemAvailable " %lu (since Linux 3.14)"
42 An estimate of how much memory is available for starting new
43 applications, without swapping.
44 .TP
45 .IR Buffers " %lu"
46 Relatively temporary storage for raw disk blocks that
47 shouldn't get tremendously large (20 MB or so).
48 .TP
49 .IR Cached " %lu"
50 In-memory cache for files read from the disk (the page cache).
51 Doesn't include
52 .IR SwapCached .
53 .TP
54 .IR SwapCached " %lu"
55 Memory that once was swapped out, is swapped back in but
56 still also is in the swap file.
57 (If memory pressure is high, these pages
58 don't need to be swapped out again because they are already
59 in the swap file.
60 This saves I/O.)
61 .TP
62 .IR Active " %lu"
63 Memory that has been used more recently and usually not
64 reclaimed unless absolutely necessary.
65 .TP
66 .IR Inactive " %lu"
67 Memory which has been less recently used.
68 It is more eligible to be reclaimed for other purposes.
69 .TP
70 .IR Active(anon) " %lu (since Linux 2.6.28)"
71 [To be documented.]
72 .TP
73 .IR Inactive(anon) " %lu (since Linux 2.6.28)"
74 [To be documented.]
75 .TP
76 .IR Active(file) " %lu (since Linux 2.6.28)"
77 [To be documented.]
78 .TP
79 .IR Inactive(file) " %lu (since Linux 2.6.28)"
80 [To be documented.]
81 .TP
82 .IR Unevictable " %lu (since Linux 2.6.28)"
83 (From Linux 2.6.28 to Linux 2.6.30,
84 .B CONFIG_UNEVICTABLE_LRU
85 was required.)
86 [To be documented.]
87 .TP
88 .IR Mlocked " %lu (since Linux 2.6.28)"
89 (From Linux 2.6.28 to Linux 2.6.30,
90 .B CONFIG_UNEVICTABLE_LRU
91 was required.)
92 [To be documented.]
93 .TP
94 .IR HighTotal " %lu"
95 (Starting with Linux 2.6.19,
96 .B CONFIG_HIGHMEM
97 is required.)
98 Total amount of highmem.
99 Highmem is all memory above \[ti]860 MB of physical memory.
100 Highmem areas are for use by user-space programs,
101 or for the page cache.
102 The kernel must use tricks to access
103 this memory, making it slower to access than lowmem.
104 .TP
105 .IR HighFree " %lu"
106 (Starting with Linux 2.6.19,
107 .B CONFIG_HIGHMEM
108 is required.)
109 Amount of free highmem.
110 .TP
111 .IR LowTotal " %lu"
112 (Starting with Linux 2.6.19,
113 .B CONFIG_HIGHMEM
114 is required.)
115 Total amount of lowmem.
116 Lowmem is memory which can be used for everything that
117 highmem can be used for, but it is also available for the
118 kernel's use for its own data structures.
119 Among many other things,
120 it is where everything from
121 .I Slab
122 is allocated.
123 Bad things happen when you're out of lowmem.
124 .TP
125 .IR LowFree " %lu"
126 (Starting with Linux 2.6.19,
127 .B CONFIG_HIGHMEM
128 is required.)
129 Amount of free lowmem.
130 .TP
131 .IR MmapCopy " %lu (since Linux 2.6.29)"
132 .RB ( CONFIG_MMU
133 is required.)
134 [To be documented.]
135 .TP
136 .IR SwapTotal " %lu"
137 Total amount of swap space available.
138 .TP
139 .IR SwapFree " %lu"
140 Amount of swap space that is currently unused.
141 .TP
142 .IR Dirty " %lu"
143 Memory which is waiting to get written back to the disk.
144 .TP
145 .IR Writeback " %lu"
146 Memory which is actively being written back to the disk.
147 .TP
148 .IR AnonPages " %lu (since Linux 2.6.18)"
149 Non-file backed pages mapped into user-space page tables.
150 .TP
151 .IR Mapped " %lu"
152 Files which have been mapped into memory (with
153 .BR mmap (2)),
154 such as libraries.
155 .TP
156 .IR Shmem " %lu (since Linux 2.6.32)"
157 Amount of memory consumed in
158 .BR tmpfs (5)
159 filesystems,
160 System V,
161 and POSIX shared memory,
162 as well as shared anonymous mappings
163 .RI ( MAP_SHARED|MAP_ANONYMOUS ).
164 .TP
165 .IR KReclaimable " %lu (since Linux 4.20)"
166 Kernel allocations that the kernel will attempt to reclaim
167 under memory pressure.
168 Includes
169 .I SReclaimable
170 (below), and other direct allocations with a shrinker.
171 .TP
172 .IR Slab " %lu"
173 In-kernel data structures cache.
174 (See
175 .BR slabinfo (5).)
176 .TP
177 .IR SReclaimable " %lu (since Linux 2.6.19)"
178 Part of
179 .IR Slab ,
180 that might be reclaimed, such as caches.
181 .TP
182 .IR SUnreclaim " %lu (since Linux 2.6.19)"
183 Part of
184 .IR Slab ,
185 that cannot be reclaimed on memory pressure.
186 .TP
187 .IR KernelStack " %lu (since Linux 2.6.32)"
188 Amount of memory allocated to kernel stacks.
189 .TP
190 .IR PageTables " %lu (since Linux 2.6.18)"
191 Amount of memory dedicated to the lowest level of page tables.
192 .TP
193 .IR Quicklists " %lu (since Linux 2.6.27)"
194 .RB ( CONFIG_QUICKLIST
195 is required.)
196 [To be documented.]
197 .TP
198 .IR NFS_Unstable " %lu (since Linux 2.6.18)"
199 NFS pages sent to the server, but not yet committed to stable storage.
200 .TP
201 .IR Bounce " %lu (since Linux 2.6.18)"
202 Memory used for block device "bounce buffers".
203 .TP
204 .IR WritebackTmp " %lu (since Linux 2.6.26)"
205 Memory used by FUSE for temporary writeback buffers.
206 .TP
207 .IR CommitLimit " %lu (since Linux 2.6.10)"
208 This is the total amount of memory currently available to
209 be allocated on the system, expressed in kilobytes.
210 This limit is adhered to
211 only if strict overcommit accounting is enabled (mode 2 in
212 .IR /proc/sys/vm/overcommit_memory ).
213 The limit is calculated according to the formula described under
214 .IR /proc/sys/vm/overcommit_memory .
215 For further details, see the kernel source file
216 .IR Documentation/vm/overcommit\-accounting.rst .
217 .TP
218 .IR Committed_AS " %lu"
219 The amount of memory presently allocated on the system.
220 The committed memory is a sum of all of the memory which
221 has been allocated by processes, even if it has not been
222 "used" by them as of yet.
223 A process which allocates 1 GB of memory (using
224 .BR malloc (3)
225 or similar), but touches only 300 MB of that memory will show up
226 as using only 300 MB of memory even if it has the address space
227 allocated for the entire 1 GB.
228 .IP
229 This 1 GB is memory which has been "committed" to by the VM
230 and can be used at any time by the allocating application.
231 With strict overcommit enabled on the system (mode 2 in
232 .IR /proc/sys/vm/overcommit_memory ),
233 allocations which would exceed the
234 .I CommitLimit
235 will not be permitted.
236 This is useful if one needs to guarantee that processes will not
237 fail due to lack of memory once that memory has been successfully allocated.
238 .TP
239 .IR VmallocTotal " %lu"
240 Total size of vmalloc memory area.
241 .TP
242 .IR VmallocUsed " %lu"
243 Amount of vmalloc area which is used.
244 Since Linux 4.4,
245 .\" commit a5ad88ce8c7fae7ddc72ee49a11a75aa837788e0
246 this field is no longer calculated, and is hard coded as 0.
247 See
248 .IR /proc/vmallocinfo .
249 .TP
250 .IR VmallocChunk " %lu"
251 Largest contiguous block of vmalloc area which is free.
252 Since Linux 4.4,
253 .\" commit a5ad88ce8c7fae7ddc72ee49a11a75aa837788e0
254 this field is no longer calculated and is hard coded as 0.
255 See
256 .IR /proc/vmallocinfo .
257 .TP
258 .IR HardwareCorrupted " %lu (since Linux 2.6.32)"
259 .RB ( CONFIG_MEMORY_FAILURE
260 is required.)
261 [To be documented.]
262 .TP
263 .IR LazyFree " %lu (since Linux 4.12)"
264 Shows the amount of memory marked by
265 .BR madvise (2)
266 .BR MADV_FREE .
267 .TP
268 .IR AnonHugePages " %lu (since Linux 2.6.38)"
269 .RB ( CONFIG_TRANSPARENT_HUGEPAGE
270 is required.)
271 Non-file backed huge pages mapped into user-space page tables.
272 .TP
273 .IR ShmemHugePages " %lu (since Linux 4.8)"
274 .RB ( CONFIG_TRANSPARENT_HUGEPAGE
275 is required.)
276 Memory used by shared memory (shmem) and
277 .BR tmpfs (5)
278 allocated with huge pages.
279 .TP
280 .IR ShmemPmdMapped " %lu (since Linux 4.8)"
281 .RB ( CONFIG_TRANSPARENT_HUGEPAGE
282 is required.)
283 Shared memory mapped into user space with huge pages.
284 .TP
285 .IR CmaTotal " %lu (since Linux 3.1)"
286 Total CMA (Contiguous Memory Allocator) pages.
287 .RB ( CONFIG_CMA
288 is required.)
289 .TP
290 .IR CmaFree " %lu (since Linux 3.1)"
291 Free CMA (Contiguous Memory Allocator) pages.
292 .RB ( CONFIG_CMA
293 is required.)
294 .TP
295 .IR HugePages_Total " %lu"
296 .RB ( CONFIG_HUGETLB_PAGE
297 is required.)
298 The size of the pool of huge pages.
299 .TP
300 .IR HugePages_Free " %lu"
301 .RB ( CONFIG_HUGETLB_PAGE
302 is required.)
303 The number of huge pages in the pool that are not yet allocated.
304 .TP
305 .IR HugePages_Rsvd " %lu (since Linux 2.6.17)"
306 .RB ( CONFIG_HUGETLB_PAGE
307 is required.)
308 This is the number of huge pages for
309 which a commitment to allocate from the pool has been made,
310 but no allocation has yet been made.
311 These reserved huge pages
312 guarantee that an application will be able to allocate a
313 huge page from the pool of huge pages at fault time.
314 .TP
315 .IR HugePages_Surp " %lu (since Linux 2.6.24)"
316 .RB ( CONFIG_HUGETLB_PAGE
317 is required.)
318 This is the number of huge pages in
319 the pool above the value in
320 .IR /proc/sys/vm/nr_hugepages .
321 The maximum number of surplus huge pages is controlled by
322 .IR /proc/sys/vm/nr_overcommit_hugepages .
323 .TP
324 .IR Hugepagesize " %lu"
325 .RB ( CONFIG_HUGETLB_PAGE
326 is required.)
327 The size of huge pages.
328 .TP
329 .IR DirectMap4k " %lu (since Linux 2.6.27)"
330 Number of bytes of RAM linearly mapped by kernel in 4 kB pages.
331 (x86.)
332 .TP
333 .IR DirectMap4M " %lu (since Linux 2.6.27)"
334 Number of bytes of RAM linearly mapped by kernel in 4 MB pages.
335 (x86 with
336 .B CONFIG_X86_64
337 or
338 .B CONFIG_X86_PAE
339 enabled.)
340 .TP
341 .IR DirectMap2M " %lu (since Linux 2.6.27)"
342 Number of bytes of RAM linearly mapped by kernel in 2 MB pages.
343 (x86 with neither
344 .B CONFIG_X86_64
345 nor
346 .B CONFIG_X86_PAE
347 enabled.)
348 .TP
349 .IR DirectMap1G " %lu (since Linux 2.6.27)"
350 (x86 with
351 .B CONFIG_X86_64
352 and
353 .B CONFIG_X86_DIRECT_GBPAGES
354 enabled.)
355 .RE
356 .SH SEE ALSO
357 .BR proc (5)