Merge branch 'proc-linus' of git://git.kernel.org/pub/scm/linux/kernel/git/adobriyan...
[safe/jmp/linux-2.6] / Documentation / filesystems / proc.txt
1 ------------------------------------------------------------------------------
2                        T H E  /proc   F I L E S Y S T E M
3 ------------------------------------------------------------------------------
4 /proc/sys         Terrehon Bowden <terrehon@pacbell.net>        October 7 1999
5                   Bodo Bauer <bb@ricochet.net>
6
7 2.4.x update      Jorge Nerin <comandante@zaralinux.com>      November 14 2000
8 ------------------------------------------------------------------------------
9 Version 1.3                                              Kernel version 2.2.12
10                                               Kernel version 2.4.0-test11-pre4
11 ------------------------------------------------------------------------------
12
13 Table of Contents
14 -----------------
15
16   0     Preface
17   0.1   Introduction/Credits
18   0.2   Legal Stuff
19
20   1     Collecting System Information
21   1.1   Process-Specific Subdirectories
22   1.2   Kernel data
23   1.3   IDE devices in /proc/ide
24   1.4   Networking info in /proc/net
25   1.5   SCSI info
26   1.6   Parallel port info in /proc/parport
27   1.7   TTY info in /proc/tty
28   1.8   Miscellaneous kernel statistics in /proc/stat
29
30   2     Modifying System Parameters
31   2.1   /proc/sys/fs - File system data
32   2.2   /proc/sys/fs/binfmt_misc - Miscellaneous binary formats
33   2.3   /proc/sys/kernel - general kernel parameters
34   2.4   /proc/sys/vm - The virtual memory subsystem
35   2.5   /proc/sys/dev - Device specific parameters
36   2.6   /proc/sys/sunrpc - Remote procedure calls
37   2.7   /proc/sys/net - Networking stuff
38   2.8   /proc/sys/net/ipv4 - IPV4 settings
39   2.9   Appletalk
40   2.10  IPX
41   2.11  /proc/sys/fs/mqueue - POSIX message queues filesystem
42   2.12  /proc/<pid>/oom_adj - Adjust the oom-killer score
43   2.13  /proc/<pid>/oom_score - Display current oom-killer score
44   2.14  /proc/<pid>/io - Display the IO accounting fields
45   2.15  /proc/<pid>/coredump_filter - Core dump filtering settings
46   2.16  /proc/<pid>/mountinfo - Information about mounts
47   2.17  /proc/sys/fs/epoll - Configuration options for the epoll interface
48
49 ------------------------------------------------------------------------------
50 Preface
51 ------------------------------------------------------------------------------
52
53 0.1 Introduction/Credits
54 ------------------------
55
56 This documentation is  part of a soon (or  so we hope) to be  released book on
57 the SuSE  Linux distribution. As  there is  no complete documentation  for the
58 /proc file system and we've used  many freely available sources to write these
59 chapters, it  seems only fair  to give the work  back to the  Linux community.
60 This work is  based on the 2.2.*  kernel version and the  upcoming 2.4.*. I'm
61 afraid it's still far from complete, but we  hope it will be useful. As far as
62 we know, it is the first 'all-in-one' document about the /proc file system. It
63 is focused  on the Intel  x86 hardware,  so if you  are looking for  PPC, ARM,
64 SPARC, AXP, etc., features, you probably  won't find what you are looking for.
65 It also only covers IPv4 networking, not IPv6 nor other protocols - sorry. But
66 additions and patches  are welcome and will  be added to this  document if you
67 mail them to Bodo.
68
69 We'd like  to  thank Alan Cox, Rik van Riel, and Alexey Kuznetsov and a lot of
70 other people for help compiling this documentation. We'd also like to extend a
71 special thank  you to Andi Kleen for documentation, which we relied on heavily
72 to create  this  document,  as well as the additional information he provided.
73 Thanks to  everybody  else  who contributed source or docs to the Linux kernel
74 and helped create a great piece of software... :)
75
76 If you  have  any comments, corrections or additions, please don't hesitate to
77 contact Bodo  Bauer  at  bb@ricochet.net.  We'll  be happy to add them to this
78 document.
79
80 The   latest   version    of   this   document   is    available   online   at
81 http://skaro.nightcrawler.com/~bb/Docs/Proc as HTML version.
82
83 If  the above  direction does  not works  for you,  ypu could  try the  kernel
84 mailing  list  at  linux-kernel@vger.kernel.org  and/or try  to  reach  me  at
85 comandante@zaralinux.com.
86
87 0.2 Legal Stuff
88 ---------------
89
90 We don't  guarantee  the  correctness  of this document, and if you come to us
91 complaining about  how  you  screwed  up  your  system  because  of  incorrect
92 documentation, we won't feel responsible...
93
94 ------------------------------------------------------------------------------
95 CHAPTER 1: COLLECTING SYSTEM INFORMATION
96 ------------------------------------------------------------------------------
97
98 ------------------------------------------------------------------------------
99 In This Chapter
100 ------------------------------------------------------------------------------
101 * Investigating  the  properties  of  the  pseudo  file  system  /proc and its
102   ability to provide information on the running Linux system
103 * Examining /proc's structure
104 * Uncovering  various  information  about the kernel and the processes running
105   on the system
106 ------------------------------------------------------------------------------
107
108
109 The proc  file  system acts as an interface to internal data structures in the
110 kernel. It  can  be  used to obtain information about the system and to change
111 certain kernel parameters at runtime (sysctl).
112
113 First, we'll  take  a  look  at the read-only parts of /proc. In Chapter 2, we
114 show you how you can use /proc/sys to change settings.
115
116 1.1 Process-Specific Subdirectories
117 -----------------------------------
118
119 The directory  /proc  contains  (among other things) one subdirectory for each
120 process running on the system, which is named after the process ID (PID).
121
122 The link  self  points  to  the  process reading the file system. Each process
123 subdirectory has the entries listed in Table 1-1.
124
125
126 Table 1-1: Process specific entries in /proc 
127 ..............................................................................
128  File           Content
129  clear_refs     Clears page referenced bits shown in smaps output
130  cmdline        Command line arguments
131  cpu            Current and last cpu in which it was executed   (2.4)(smp)
132  cwd            Link to the current working directory
133  environ        Values of environment variables
134  exe            Link to the executable of this process
135  fd             Directory, which contains all file descriptors
136  maps           Memory maps to executables and library files    (2.4)
137  mem            Memory held by this process
138  root           Link to the root directory of this process
139  stat           Process status
140  statm          Process memory status information
141  status         Process status in human readable form
142  wchan          If CONFIG_KALLSYMS is set, a pre-decoded wchan
143  stack          Report full stack trace, enable via CONFIG_STACKTRACE
144  smaps          Extension based on maps, the rss size for each mapped file
145 ..............................................................................
146
147 For example, to get the status information of a process, all you have to do is
148 read the file /proc/PID/status:
149
150   >cat /proc/self/status 
151   Name:   cat 
152   State:  R (running) 
153   Pid:    5452 
154   PPid:   743 
155   TracerPid:      0                                             (2.4)
156   Uid:    501     501     501     501 
157   Gid:    100     100     100     100 
158   Groups: 100 14 16 
159   VmSize:     1112 kB 
160   VmLck:         0 kB 
161   VmRSS:       348 kB 
162   VmData:       24 kB 
163   VmStk:        12 kB 
164   VmExe:         8 kB 
165   VmLib:      1044 kB 
166   SigPnd: 0000000000000000 
167   SigBlk: 0000000000000000 
168   SigIgn: 0000000000000000 
169   SigCgt: 0000000000000000 
170   CapInh: 00000000fffffeff 
171   CapPrm: 0000000000000000 
172   CapEff: 0000000000000000 
173
174
175 This shows you nearly the same information you would get if you viewed it with
176 the ps  command.  In  fact,  ps  uses  the  proc  file  system  to  obtain its
177 information. The  statm  file  contains  more  detailed  information about the
178 process memory usage. Its seven fields are explained in Table 1-2.  The stat
179 file contains details information about the process itself.  Its fields are
180 explained in Table 1-3.
181
182
183 Table 1-2: Contents of the statm files (as of 2.6.8-rc3)
184 ..............................................................................
185  Field    Content
186  size     total program size (pages)            (same as VmSize in status)
187  resident size of memory portions (pages)       (same as VmRSS in status)
188  shared   number of pages that are shared       (i.e. backed by a file)
189  trs      number of pages that are 'code'       (not including libs; broken,
190                                                         includes data segment)
191  lrs      number of pages of library            (always 0 on 2.6)
192  drs      number of pages of data/stack         (including libs; broken,
193                                                         includes library text)
194  dt       number of dirty pages                 (always 0 on 2.6)
195 ..............................................................................
196
197
198 Table 1-3: Contents of the stat files (as of 2.6.22-rc3)
199 ..............................................................................
200  Field          Content
201   pid           process id
202   tcomm         filename of the executable
203   state         state (R is running, S is sleeping, D is sleeping in an
204                 uninterruptible wait, Z is zombie, T is traced or stopped)
205   ppid          process id of the parent process
206   pgrp          pgrp of the process
207   sid           session id
208   tty_nr        tty the process uses
209   tty_pgrp      pgrp of the tty
210   flags         task flags
211   min_flt       number of minor faults
212   cmin_flt      number of minor faults with child's
213   maj_flt       number of major faults
214   cmaj_flt      number of major faults with child's
215   utime         user mode jiffies
216   stime         kernel mode jiffies
217   cutime        user mode jiffies with child's
218   cstime        kernel mode jiffies with child's
219   priority      priority level
220   nice          nice level
221   num_threads   number of threads
222   it_real_value (obsolete, always 0)
223   start_time    time the process started after system boot
224   vsize         virtual memory size
225   rss           resident set memory size
226   rsslim        current limit in bytes on the rss
227   start_code    address above which program text can run
228   end_code      address below which program text can run
229   start_stack   address of the start of the stack
230   esp           current value of ESP
231   eip           current value of EIP
232   pending       bitmap of pending signals (obsolete)
233   blocked       bitmap of blocked signals (obsolete)
234   sigign        bitmap of ignored signals (obsolete)
235   sigcatch      bitmap of catched signals (obsolete)
236   wchan         address where process went to sleep
237   0             (place holder)
238   0             (place holder)
239   exit_signal   signal to send to parent thread on exit
240   task_cpu      which CPU the task is scheduled on
241   rt_priority   realtime priority
242   policy        scheduling policy (man sched_setscheduler)
243   blkio_ticks   time spent waiting for block IO
244 ..............................................................................
245
246
247 1.2 Kernel data
248 ---------------
249
250 Similar to  the  process entries, the kernel data files give information about
251 the running kernel. The files used to obtain this information are contained in
252 /proc and  are  listed  in Table 1-4. Not all of these will be present in your
253 system. It  depends  on the kernel configuration and the loaded modules, which
254 files are there, and which are missing.
255
256 Table 1-4: Kernel info in /proc
257 ..............................................................................
258  File        Content                                           
259  apm         Advanced power management info                    
260  buddyinfo   Kernel memory allocator information (see text)     (2.5)
261  bus         Directory containing bus specific information     
262  cmdline     Kernel command line                               
263  cpuinfo     Info about the CPU                                
264  devices     Available devices (block and character)           
265  dma         Used DMS channels                                 
266  filesystems Supported filesystems                             
267  driver      Various drivers grouped here, currently rtc (2.4)
268  execdomains Execdomains, related to security                   (2.4)
269  fb          Frame Buffer devices                               (2.4)
270  fs          File system parameters, currently nfs/exports      (2.4)
271  ide         Directory containing info about the IDE subsystem 
272  interrupts  Interrupt usage                                   
273  iomem       Memory map                                         (2.4)
274  ioports     I/O port usage                                    
275  irq         Masks for irq to cpu affinity                      (2.4)(smp?)
276  isapnp      ISA PnP (Plug&Play) Info                           (2.4)
277  kcore       Kernel core image (can be ELF or A.OUT(deprecated in 2.4))   
278  kmsg        Kernel messages                                   
279  ksyms       Kernel symbol table                               
280  loadavg     Load average of last 1, 5 & 15 minutes                
281  locks       Kernel locks                                      
282  meminfo     Memory info                                       
283  misc        Miscellaneous                                     
284  modules     List of loaded modules                            
285  mounts      Mounted filesystems                               
286  net         Networking info (see text)                        
287  partitions  Table of partitions known to the system           
288  pci         Deprecated info of PCI bus (new way -> /proc/bus/pci/,
289              decoupled by lspci                                 (2.4)
290  rtc         Real time clock                                   
291  scsi        SCSI info (see text)                              
292  slabinfo    Slab pool info                                    
293  stat        Overall statistics                                
294  swaps       Swap space utilization                            
295  sys         See chapter 2                                     
296  sysvipc     Info of SysVIPC Resources (msg, sem, shm)          (2.4)
297  tty         Info of tty drivers
298  uptime      System uptime                                     
299  version     Kernel version                                    
300  video       bttv info of video resources                       (2.4)
301  vmallocinfo Show vmalloced areas
302 ..............................................................................
303
304 You can,  for  example,  check  which interrupts are currently in use and what
305 they are used for by looking in the file /proc/interrupts:
306
307   > cat /proc/interrupts 
308              CPU0        
309     0:    8728810          XT-PIC  timer 
310     1:        895          XT-PIC  keyboard 
311     2:          0          XT-PIC  cascade 
312     3:     531695          XT-PIC  aha152x 
313     4:    2014133          XT-PIC  serial 
314     5:      44401          XT-PIC  pcnet_cs 
315     8:          2          XT-PIC  rtc 
316    11:          8          XT-PIC  i82365 
317    12:     182918          XT-PIC  PS/2 Mouse 
318    13:          1          XT-PIC  fpu 
319    14:    1232265          XT-PIC  ide0 
320    15:          7          XT-PIC  ide1 
321   NMI:          0 
322
323 In 2.4.* a couple of lines where added to this file LOC & ERR (this time is the
324 output of a SMP machine):
325
326   > cat /proc/interrupts 
327
328              CPU0       CPU1       
329     0:    1243498    1214548    IO-APIC-edge  timer
330     1:       8949       8958    IO-APIC-edge  keyboard
331     2:          0          0          XT-PIC  cascade
332     5:      11286      10161    IO-APIC-edge  soundblaster
333     8:          1          0    IO-APIC-edge  rtc
334     9:      27422      27407    IO-APIC-edge  3c503
335    12:     113645     113873    IO-APIC-edge  PS/2 Mouse
336    13:          0          0          XT-PIC  fpu
337    14:      22491      24012    IO-APIC-edge  ide0
338    15:       2183       2415    IO-APIC-edge  ide1
339    17:      30564      30414   IO-APIC-level  eth0
340    18:        177        164   IO-APIC-level  bttv
341   NMI:    2457961    2457959 
342   LOC:    2457882    2457881 
343   ERR:       2155
344
345 NMI is incremented in this case because every timer interrupt generates a NMI
346 (Non Maskable Interrupt) which is used by the NMI Watchdog to detect lockups.
347
348 LOC is the local interrupt counter of the internal APIC of every CPU.
349
350 ERR is incremented in the case of errors in the IO-APIC bus (the bus that
351 connects the CPUs in a SMP system. This means that an error has been detected,
352 the IO-APIC automatically retry the transmission, so it should not be a big
353 problem, but you should read the SMP-FAQ.
354
355 In 2.6.2* /proc/interrupts was expanded again.  This time the goal was for
356 /proc/interrupts to display every IRQ vector in use by the system, not
357 just those considered 'most important'.  The new vectors are:
358
359   THR -- interrupt raised when a machine check threshold counter
360   (typically counting ECC corrected errors of memory or cache) exceeds
361   a configurable threshold.  Only available on some systems.
362
363   TRM -- a thermal event interrupt occurs when a temperature threshold
364   has been exceeded for the CPU.  This interrupt may also be generated
365   when the temperature drops back to normal.
366
367   SPU -- a spurious interrupt is some interrupt that was raised then lowered
368   by some IO device before it could be fully processed by the APIC.  Hence
369   the APIC sees the interrupt but does not know what device it came from.
370   For this case the APIC will generate the interrupt with a IRQ vector
371   of 0xff. This might also be generated by chipset bugs.
372
373   RES, CAL, TLB -- rescheduling, call and TLB flush interrupts are
374   sent from one CPU to another per the needs of the OS.  Typically,
375   their statistics are used by kernel developers and interested users to
376   determine the occurance of interrupt of the given type.
377
378 The above IRQ vectors are displayed only when relevent.  For example,
379 the threshold vector does not exist on x86_64 platforms.  Others are
380 suppressed when the system is a uniprocessor.  As of this writing, only
381 i386 and x86_64 platforms support the new IRQ vector displays.
382
383 Of some interest is the introduction of the /proc/irq directory to 2.4.
384 It could be used to set IRQ to CPU affinity, this means that you can "hook" an
385 IRQ to only one CPU, or to exclude a CPU of handling IRQs. The contents of the
386 irq subdir is one subdir for each IRQ, and two files; default_smp_affinity and
387 prof_cpu_mask.
388
389 For example 
390   > ls /proc/irq/
391   0  10  12  14  16  18  2  4  6  8  prof_cpu_mask
392   1  11  13  15  17  19  3  5  7  9  default_smp_affinity
393   > ls /proc/irq/0/
394   smp_affinity
395
396 smp_affinity is a bitmask, in which you can specify which CPUs can handle the
397 IRQ, you can set it by doing:
398
399   > echo 1 > /proc/irq/10/smp_affinity
400
401 This means that only the first CPU will handle the IRQ, but you can also echo
402 5 which means that only the first and fourth CPU can handle the IRQ.
403
404 The contents of each smp_affinity file is the same by default:
405
406   > cat /proc/irq/0/smp_affinity
407   ffffffff
408
409 The default_smp_affinity mask applies to all non-active IRQs, which are the
410 IRQs which have not yet been allocated/activated, and hence which lack a
411 /proc/irq/[0-9]* directory.
412
413 prof_cpu_mask specifies which CPUs are to be profiled by the system wide
414 profiler. Default value is ffffffff (all cpus).
415
416 The way IRQs are routed is handled by the IO-APIC, and it's Round Robin
417 between all the CPUs which are allowed to handle it. As usual the kernel has
418 more info than you and does a better job than you, so the defaults are the
419 best choice for almost everyone.
420
421 There are  three  more  important subdirectories in /proc: net, scsi, and sys.
422 The general  rule  is  that  the  contents,  or  even  the  existence of these
423 directories, depend  on your kernel configuration. If SCSI is not enabled, the
424 directory scsi  may  not  exist. The same is true with the net, which is there
425 only when networking support is present in the running kernel.
426
427 The slabinfo  file  gives  information  about  memory usage at the slab level.
428 Linux uses  slab  pools for memory management above page level in version 2.2.
429 Commonly used  objects  have  their  own  slab  pool (such as network buffers,
430 directory cache, and so on).
431
432 ..............................................................................
433
434 > cat /proc/buddyinfo
435
436 Node 0, zone      DMA      0      4      5      4      4      3 ...
437 Node 0, zone   Normal      1      0      0      1    101      8 ...
438 Node 0, zone  HighMem      2      0      0      1      1      0 ...
439
440 Memory fragmentation is a problem under some workloads, and buddyinfo is a 
441 useful tool for helping diagnose these problems.  Buddyinfo will give you a 
442 clue as to how big an area you can safely allocate, or why a previous
443 allocation failed.
444
445 Each column represents the number of pages of a certain order which are 
446 available.  In this case, there are 0 chunks of 2^0*PAGE_SIZE available in 
447 ZONE_DMA, 4 chunks of 2^1*PAGE_SIZE in ZONE_DMA, 101 chunks of 2^4*PAGE_SIZE 
448 available in ZONE_NORMAL, etc... 
449
450 ..............................................................................
451
452 meminfo:
453
454 Provides information about distribution and utilization of memory.  This
455 varies by architecture and compile options.  The following is from a
456 16GB PIII, which has highmem enabled.  You may not have all of these fields.
457
458 > cat /proc/meminfo
459
460
461 MemTotal:     16344972 kB
462 MemFree:      13634064 kB
463 Buffers:          3656 kB
464 Cached:        1195708 kB
465 SwapCached:          0 kB
466 Active:         891636 kB
467 Inactive:      1077224 kB
468 HighTotal:    15597528 kB
469 HighFree:     13629632 kB
470 LowTotal:       747444 kB
471 LowFree:          4432 kB
472 SwapTotal:           0 kB
473 SwapFree:            0 kB
474 Dirty:             968 kB
475 Writeback:           0 kB
476 AnonPages:      861800 kB
477 Mapped:         280372 kB
478 Slab:           284364 kB
479 SReclaimable:   159856 kB
480 SUnreclaim:     124508 kB
481 PageTables:      24448 kB
482 NFS_Unstable:        0 kB
483 Bounce:              0 kB
484 WritebackTmp:        0 kB
485 CommitLimit:   7669796 kB
486 Committed_AS:   100056 kB
487 VmallocTotal:   112216 kB
488 VmallocUsed:       428 kB
489 VmallocChunk:   111088 kB
490
491     MemTotal: Total usable ram (i.e. physical ram minus a few reserved
492               bits and the kernel binary code)
493      MemFree: The sum of LowFree+HighFree
494      Buffers: Relatively temporary storage for raw disk blocks
495               shouldn't get tremendously large (20MB or so)
496       Cached: in-memory cache for files read from the disk (the
497               pagecache).  Doesn't include SwapCached
498   SwapCached: Memory that once was swapped out, is swapped back in but
499               still also is in the swapfile (if memory is needed it
500               doesn't need to be swapped out AGAIN because it is already
501               in the swapfile. This saves I/O)
502       Active: Memory that has been used more recently and usually not
503               reclaimed unless absolutely necessary.
504     Inactive: Memory which has been less recently used.  It is more
505               eligible to be reclaimed for other purposes
506    HighTotal:
507     HighFree: Highmem is all memory above ~860MB of physical memory
508               Highmem areas are for use by userspace programs, or
509               for the pagecache.  The kernel must use tricks to access
510               this memory, making it slower to access than lowmem.
511     LowTotal:
512      LowFree: Lowmem is memory which can be used for everything that
513               highmem can be used for, but it is also available for the
514               kernel's use for its own data structures.  Among many
515               other things, it is where everything from the Slab is
516               allocated.  Bad things happen when you're out of lowmem.
517    SwapTotal: total amount of swap space available
518     SwapFree: Memory which has been evicted from RAM, and is temporarily
519               on the disk
520        Dirty: Memory which is waiting to get written back to the disk
521    Writeback: Memory which is actively being written back to the disk
522    AnonPages: Non-file backed pages mapped into userspace page tables
523       Mapped: files which have been mmaped, such as libraries
524         Slab: in-kernel data structures cache
525 SReclaimable: Part of Slab, that might be reclaimed, such as caches
526   SUnreclaim: Part of Slab, that cannot be reclaimed on memory pressure
527   PageTables: amount of memory dedicated to the lowest level of page
528               tables.
529 NFS_Unstable: NFS pages sent to the server, but not yet committed to stable
530               storage
531       Bounce: Memory used for block device "bounce buffers"
532 WritebackTmp: Memory used by FUSE for temporary writeback buffers
533  CommitLimit: Based on the overcommit ratio ('vm.overcommit_ratio'),
534               this is the total amount of  memory currently available to
535               be allocated on the system. This limit is only adhered to
536               if strict overcommit accounting is enabled (mode 2 in
537               'vm.overcommit_memory').
538               The CommitLimit is calculated with the following formula:
539               CommitLimit = ('vm.overcommit_ratio' * Physical RAM) + Swap
540               For example, on a system with 1G of physical RAM and 7G
541               of swap with a `vm.overcommit_ratio` of 30 it would
542               yield a CommitLimit of 7.3G.
543               For more details, see the memory overcommit documentation
544               in vm/overcommit-accounting.
545 Committed_AS: The amount of memory presently allocated on the system.
546               The committed memory is a sum of all of the memory which
547               has been allocated by processes, even if it has not been
548               "used" by them as of yet. A process which malloc()'s 1G
549               of memory, but only touches 300M of it will only show up
550               as using 300M of memory even if it has the address space
551               allocated for the entire 1G. This 1G is memory which has
552               been "committed" to by the VM and can be used at any time
553               by the allocating application. With strict overcommit
554               enabled on the system (mode 2 in 'vm.overcommit_memory'),
555               allocations which would exceed the CommitLimit (detailed
556               above) will not be permitted. This is useful if one needs
557               to guarantee that processes will not fail due to lack of
558               memory once that memory has been successfully allocated.
559 VmallocTotal: total size of vmalloc memory area
560  VmallocUsed: amount of vmalloc area which is used
561 VmallocChunk: largest contigious block of vmalloc area which is free
562
563 ..............................................................................
564
565 vmallocinfo:
566
567 Provides information about vmalloced/vmaped areas. One line per area,
568 containing the virtual address range of the area, size in bytes,
569 caller information of the creator, and optional information depending
570 on the kind of area :
571
572  pages=nr    number of pages
573  phys=addr   if a physical address was specified
574  ioremap     I/O mapping (ioremap() and friends)
575  vmalloc     vmalloc() area
576  vmap        vmap()ed pages
577  user        VM_USERMAP area
578  vpages      buffer for pages pointers was vmalloced (huge area)
579  N<node>=nr  (Only on NUMA kernels)
580              Number of pages allocated on memory node <node>
581
582 > cat /proc/vmallocinfo
583 0xffffc20000000000-0xffffc20000201000 2101248 alloc_large_system_hash+0x204 ...
584   /0x2c0 pages=512 vmalloc N0=128 N1=128 N2=128 N3=128
585 0xffffc20000201000-0xffffc20000302000 1052672 alloc_large_system_hash+0x204 ...
586   /0x2c0 pages=256 vmalloc N0=64 N1=64 N2=64 N3=64
587 0xffffc20000302000-0xffffc20000304000    8192 acpi_tb_verify_table+0x21/0x4f...
588   phys=7fee8000 ioremap
589 0xffffc20000304000-0xffffc20000307000   12288 acpi_tb_verify_table+0x21/0x4f...
590   phys=7fee7000 ioremap
591 0xffffc2000031d000-0xffffc2000031f000    8192 init_vdso_vars+0x112/0x210
592 0xffffc2000031f000-0xffffc2000032b000   49152 cramfs_uncompress_init+0x2e ...
593   /0x80 pages=11 vmalloc N0=3 N1=3 N2=2 N3=3
594 0xffffc2000033a000-0xffffc2000033d000   12288 sys_swapon+0x640/0xac0      ...
595   pages=2 vmalloc N1=2
596 0xffffc20000347000-0xffffc2000034c000   20480 xt_alloc_table_info+0xfe ...
597   /0x130 [x_tables] pages=4 vmalloc N0=4
598 0xffffffffa0000000-0xffffffffa000f000   61440 sys_init_module+0xc27/0x1d00 ...
599    pages=14 vmalloc N2=14
600 0xffffffffa000f000-0xffffffffa0014000   20480 sys_init_module+0xc27/0x1d00 ...
601    pages=4 vmalloc N1=4
602 0xffffffffa0014000-0xffffffffa0017000   12288 sys_init_module+0xc27/0x1d00 ...
603    pages=2 vmalloc N1=2
604 0xffffffffa0017000-0xffffffffa0022000   45056 sys_init_module+0xc27/0x1d00 ...
605    pages=10 vmalloc N0=10
606
607 1.3 IDE devices in /proc/ide
608 ----------------------------
609
610 The subdirectory /proc/ide contains information about all IDE devices of which
611 the kernel  is  aware.  There is one subdirectory for each IDE controller, the
612 file drivers  and a link for each IDE device, pointing to the device directory
613 in the controller specific subtree.
614
615 The file  drivers  contains general information about the drivers used for the
616 IDE devices:
617
618   > cat /proc/ide/drivers
619   ide-cdrom version 4.53
620   ide-disk version 1.08
621
622 More detailed  information  can  be  found  in  the  controller  specific
623 subdirectories. These  are  named  ide0,  ide1  and  so  on.  Each  of  these
624 directories contains the files shown in table 1-5.
625
626
627 Table 1-5: IDE controller info in  /proc/ide/ide?
628 ..............................................................................
629  File    Content                                 
630  channel IDE channel (0 or 1)                    
631  config  Configuration (only for PCI/IDE bridge) 
632  mate    Mate name                               
633  model   Type/Chipset of IDE controller          
634 ..............................................................................
635
636 Each device  connected  to  a  controller  has  a separate subdirectory in the
637 controllers directory.  The  files  listed in table 1-6 are contained in these
638 directories.
639
640
641 Table 1-6: IDE device information
642 ..............................................................................
643  File             Content                                    
644  cache            The cache                                  
645  capacity         Capacity of the medium (in 512Byte blocks) 
646  driver           driver and version                         
647  geometry         physical and logical geometry              
648  identify         device identify block                      
649  media            media type                                 
650  model            device identifier                          
651  settings         device setup                               
652  smart_thresholds IDE disk management thresholds             
653  smart_values     IDE disk management values                 
654 ..............................................................................
655
656 The most  interesting  file is settings. This file contains a nice overview of
657 the drive parameters:
658
659   # cat /proc/ide/ide0/hda/settings 
660   name                    value           min             max             mode 
661   ----                    -----           ---             ---             ---- 
662   bios_cyl                526             0               65535           rw 
663   bios_head               255             0               255             rw 
664   bios_sect               63              0               63              rw 
665   breada_readahead        4               0               127             rw 
666   bswap                   0               0               1               r 
667   file_readahead          72              0               2097151         rw 
668   io_32bit                0               0               3               rw 
669   keepsettings            0               0               1               rw 
670   max_kb_per_request      122             1               127             rw 
671   multcount               0               0               8               rw 
672   nice1                   1               0               1               rw 
673   nowerr                  0               0               1               rw 
674   pio_mode                write-only      0               255             w 
675   slow                    0               0               1               rw 
676   unmaskirq               0               0               1               rw 
677   using_dma               0               0               1               rw 
678
679
680 1.4 Networking info in /proc/net
681 --------------------------------
682
683 The subdirectory  /proc/net  follows  the  usual  pattern. Table 1-6 shows the
684 additional values  you  get  for  IP  version 6 if you configure the kernel to
685 support this. Table 1-7 lists the files and their meaning.
686
687
688 Table 1-6: IPv6 info in /proc/net 
689 ..............................................................................
690  File       Content                                               
691  udp6       UDP sockets (IPv6)                                    
692  tcp6       TCP sockets (IPv6)                                    
693  raw6       Raw device statistics (IPv6)                          
694  igmp6      IP multicast addresses, which this host joined (IPv6) 
695  if_inet6   List of IPv6 interface addresses                      
696  ipv6_route Kernel routing table for IPv6                         
697  rt6_stats  Global IPv6 routing tables statistics                 
698  sockstat6  Socket statistics (IPv6)                              
699  snmp6      Snmp data (IPv6)                                      
700 ..............................................................................
701
702
703 Table 1-7: Network info in /proc/net 
704 ..............................................................................
705  File          Content                                                         
706  arp           Kernel  ARP table                                               
707  dev           network devices with statistics                                 
708  dev_mcast     the Layer2 multicast groups a device is listening too
709                (interface index, label, number of references, number of bound
710                addresses). 
711  dev_stat      network device status                                           
712  ip_fwchains   Firewall chain linkage                                          
713  ip_fwnames    Firewall chain names                                            
714  ip_masq       Directory containing the masquerading tables                    
715  ip_masquerade Major masquerading table                                        
716  netstat       Network statistics                                              
717  raw           raw device statistics                                           
718  route         Kernel routing table                                            
719  rpc           Directory containing rpc info                                   
720  rt_cache      Routing cache                                                   
721  snmp          SNMP data                                                       
722  sockstat      Socket statistics                                               
723  tcp           TCP  sockets                                                    
724  tr_rif        Token ring RIF routing table                                    
725  udp           UDP sockets                                                     
726  unix          UNIX domain sockets                                             
727  wireless      Wireless interface data (Wavelan etc)                           
728  igmp          IP multicast addresses, which this host joined                  
729  psched        Global packet scheduler parameters.                             
730  netlink       List of PF_NETLINK sockets                                      
731  ip_mr_vifs    List of multicast virtual interfaces                            
732  ip_mr_cache   List of multicast routing cache                                 
733 ..............................................................................
734
735 You can  use  this  information  to see which network devices are available in
736 your system and how much traffic was routed over those devices:
737
738   > cat /proc/net/dev 
739   Inter-|Receive                                                   |[... 
740    face |bytes    packets errs drop fifo frame compressed multicast|[... 
741       lo:  908188   5596     0    0    0     0          0         0 [...         
742     ppp0:15475140  20721   410    0    0   410          0         0 [...  
743     eth0:  614530   7085     0    0    0     0          0         1 [... 
744    
745   ...] Transmit 
746   ...] bytes    packets errs drop fifo colls carrier compressed 
747   ...]  908188     5596    0    0    0     0       0          0 
748   ...] 1375103    17405    0    0    0     0       0          0 
749   ...] 1703981     5535    0    0    0     3       0          0 
750
751 In addition, each Channel Bond interface has it's own directory.  For
752 example, the bond0 device will have a directory called /proc/net/bond0/.
753 It will contain information that is specific to that bond, such as the
754 current slaves of the bond, the link status of the slaves, and how
755 many times the slaves link has failed.
756
757 1.5 SCSI info
758 -------------
759
760 If you  have  a  SCSI  host adapter in your system, you'll find a subdirectory
761 named after  the driver for this adapter in /proc/scsi. You'll also see a list
762 of all recognized SCSI devices in /proc/scsi:
763
764   >cat /proc/scsi/scsi 
765   Attached devices: 
766   Host: scsi0 Channel: 00 Id: 00 Lun: 00 
767     Vendor: IBM      Model: DGHS09U          Rev: 03E0 
768     Type:   Direct-Access                    ANSI SCSI revision: 03 
769   Host: scsi0 Channel: 00 Id: 06 Lun: 00 
770     Vendor: PIONEER  Model: CD-ROM DR-U06S   Rev: 1.04 
771     Type:   CD-ROM                           ANSI SCSI revision: 02 
772
773
774 The directory  named  after  the driver has one file for each adapter found in
775 the system.  These  files  contain information about the controller, including
776 the used  IRQ  and  the  IO  address range. The amount of information shown is
777 dependent on  the adapter you use. The example shows the output for an Adaptec
778 AHA-2940 SCSI adapter:
779
780   > cat /proc/scsi/aic7xxx/0 
781    
782   Adaptec AIC7xxx driver version: 5.1.19/3.2.4 
783   Compile Options: 
784     TCQ Enabled By Default : Disabled 
785     AIC7XXX_PROC_STATS     : Disabled 
786     AIC7XXX_RESET_DELAY    : 5 
787   Adapter Configuration: 
788              SCSI Adapter: Adaptec AHA-294X Ultra SCSI host adapter 
789                              Ultra Wide Controller 
790       PCI MMAPed I/O Base: 0xeb001000 
791    Adapter SEEPROM Config: SEEPROM found and used. 
792         Adaptec SCSI BIOS: Enabled 
793                       IRQ: 10 
794                      SCBs: Active 0, Max Active 2, 
795                            Allocated 15, HW 16, Page 255 
796                Interrupts: 160328 
797         BIOS Control Word: 0x18b6 
798      Adapter Control Word: 0x005b 
799      Extended Translation: Enabled 
800   Disconnect Enable Flags: 0xffff 
801        Ultra Enable Flags: 0x0001 
802    Tag Queue Enable Flags: 0x0000 
803   Ordered Queue Tag Flags: 0x0000 
804   Default Tag Queue Depth: 8 
805       Tagged Queue By Device array for aic7xxx host instance 0: 
806         {255,255,255,255,255,255,255,255,255,255,255,255,255,255,255,255} 
807       Actual queue depth per device for aic7xxx host instance 0: 
808         {1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1} 
809   Statistics: 
810   (scsi0:0:0:0) 
811     Device using Wide/Sync transfers at 40.0 MByte/sec, offset 8 
812     Transinfo settings: current(12/8/1/0), goal(12/8/1/0), user(12/15/1/0) 
813     Total transfers 160151 (74577 reads and 85574 writes) 
814   (scsi0:0:6:0) 
815     Device using Narrow/Sync transfers at 5.0 MByte/sec, offset 15 
816     Transinfo settings: current(50/15/0/0), goal(50/15/0/0), user(50/15/0/0) 
817     Total transfers 0 (0 reads and 0 writes) 
818
819
820 1.6 Parallel port info in /proc/parport
821 ---------------------------------------
822
823 The directory  /proc/parport  contains information about the parallel ports of
824 your system.  It  has  one  subdirectory  for  each port, named after the port
825 number (0,1,2,...).
826
827 These directories contain the four files shown in Table 1-8.
828
829
830 Table 1-8: Files in /proc/parport 
831 ..............................................................................
832  File      Content                                                             
833  autoprobe Any IEEE-1284 device ID information that has been acquired.         
834  devices   list of the device drivers using that port. A + will appear by the
835            name of the device currently using the port (it might not appear
836            against any). 
837  hardware  Parallel port's base address, IRQ line and DMA channel.             
838  irq       IRQ that parport is using for that port. This is in a separate
839            file to allow you to alter it by writing a new value in (IRQ
840            number or none). 
841 ..............................................................................
842
843 1.7 TTY info in /proc/tty
844 -------------------------
845
846 Information about  the  available  and actually used tty's can be found in the
847 directory /proc/tty.You'll  find  entries  for drivers and line disciplines in
848 this directory, as shown in Table 1-9.
849
850
851 Table 1-9: Files in /proc/tty 
852 ..............................................................................
853  File          Content                                        
854  drivers       list of drivers and their usage                
855  ldiscs        registered line disciplines                    
856  driver/serial usage statistic and status of single tty lines 
857 ..............................................................................
858
859 To see  which  tty's  are  currently in use, you can simply look into the file
860 /proc/tty/drivers:
861
862   > cat /proc/tty/drivers 
863   pty_slave            /dev/pts      136   0-255 pty:slave 
864   pty_master           /dev/ptm      128   0-255 pty:master 
865   pty_slave            /dev/ttyp       3   0-255 pty:slave 
866   pty_master           /dev/pty        2   0-255 pty:master 
867   serial               /dev/cua        5   64-67 serial:callout 
868   serial               /dev/ttyS       4   64-67 serial 
869   /dev/tty0            /dev/tty0       4       0 system:vtmaster 
870   /dev/ptmx            /dev/ptmx       5       2 system 
871   /dev/console         /dev/console    5       1 system:console 
872   /dev/tty             /dev/tty        5       0 system:/dev/tty 
873   unknown              /dev/tty        4    1-63 console 
874
875
876 1.8 Miscellaneous kernel statistics in /proc/stat
877 -------------------------------------------------
878
879 Various pieces   of  information about  kernel activity  are  available in the
880 /proc/stat file.  All  of  the numbers reported  in  this file are  aggregates
881 since the system first booted.  For a quick look, simply cat the file:
882
883   > cat /proc/stat
884   cpu  2255 34 2290 22625563 6290 127 456 0
885   cpu0 1132 34 1441 11311718 3675 127 438 0
886   cpu1 1123 0 849 11313845 2614 0 18 0
887   intr 114930548 113199788 3 0 5 263 0 4 [... lots more numbers ...]
888   ctxt 1990473
889   btime 1062191376
890   processes 2915
891   procs_running 1
892   procs_blocked 0
893
894 The very first  "cpu" line aggregates the  numbers in all  of the other "cpuN"
895 lines.  These numbers identify the amount of time the CPU has spent performing
896 different kinds of work.  Time units are in USER_HZ (typically hundredths of a
897 second).  The meanings of the columns are as follows, from left to right:
898
899 - user: normal processes executing in user mode
900 - nice: niced processes executing in user mode
901 - system: processes executing in kernel mode
902 - idle: twiddling thumbs
903 - iowait: waiting for I/O to complete
904 - irq: servicing interrupts
905 - softirq: servicing softirqs
906 - steal: involuntary wait
907
908 The "intr" line gives counts of interrupts  serviced since boot time, for each
909 of the  possible system interrupts.   The first  column  is the  total of  all
910 interrupts serviced; each  subsequent column is the  total for that particular
911 interrupt.
912
913 The "ctxt" line gives the total number of context switches across all CPUs.
914
915 The "btime" line gives  the time at which the  system booted, in seconds since
916 the Unix epoch.
917
918 The "processes" line gives the number  of processes and threads created, which
919 includes (but  is not limited  to) those  created by  calls to the  fork() and
920 clone() system calls.
921
922 The  "procs_running" line gives the  number of processes  currently running on
923 CPUs.
924
925 The   "procs_blocked" line gives  the  number of  processes currently blocked,
926 waiting for I/O to complete.
927
928
929 1.9 Ext4 file system parameters
930 ------------------------------
931
932 Information about mounted ext4 file systems can be found in
933 /proc/fs/ext4.  Each mounted filesystem will have a directory in
934 /proc/fs/ext4 based on its device name (i.e., /proc/fs/ext4/hdc or
935 /proc/fs/ext4/dm-0).   The files in each per-device directory are shown
936 in Table 1-10, below.
937
938 Table 1-10: Files in /proc/fs/ext4/<devname>
939 ..............................................................................
940  File            Content                                        
941  mb_groups       details of multiblock allocator buddy cache of free blocks
942  mb_history      multiblock allocation history
943  stats           controls whether the multiblock allocator should start
944                  collecting statistics, which are shown during the unmount
945  group_prealloc  the multiblock allocator will round up allocation
946                  requests to a multiple of this tuning parameter if the
947                  stripe size is not set in the ext4 superblock
948  max_to_scan     The maximum number of extents the multiblock allocator
949                  will search to find the best extent
950  min_to_scan     The minimum number of extents the multiblock allocator
951                  will search to find the best extent
952  order2_req      Tuning parameter which controls the minimum size for 
953                  requests (as a power of 2) where the buddy cache is
954                  used
955  stream_req      Files which have fewer blocks than this tunable
956                  parameter will have their blocks allocated out of a
957                  block group specific preallocation pool, so that small
958                  files are packed closely together.  Each large file
959                  will have its blocks allocated out of its own unique
960                  preallocation pool.
961 inode_readahead  Tuning parameter which controls the maximum number of
962                  inode table blocks that ext4's inode table readahead
963                  algorithm will pre-read into the buffer cache
964 ..............................................................................
965
966
967 ------------------------------------------------------------------------------
968 Summary
969 ------------------------------------------------------------------------------
970 The /proc file system serves information about the running system. It not only
971 allows access to process data but also allows you to request the kernel status
972 by reading files in the hierarchy.
973
974 The directory  structure  of /proc reflects the types of information and makes
975 it easy, if not obvious, where to look for specific data.
976 ------------------------------------------------------------------------------
977
978 ------------------------------------------------------------------------------
979 CHAPTER 2: MODIFYING SYSTEM PARAMETERS
980 ------------------------------------------------------------------------------
981
982 ------------------------------------------------------------------------------
983 In This Chapter
984 ------------------------------------------------------------------------------
985 * Modifying kernel parameters by writing into files found in /proc/sys
986 * Exploring the files which modify certain parameters
987 * Review of the /proc/sys file tree
988 ------------------------------------------------------------------------------
989
990
991 A very  interesting part of /proc is the directory /proc/sys. This is not only
992 a source  of  information,  it also allows you to change parameters within the
993 kernel. Be  very  careful  when attempting this. You can optimize your system,
994 but you  can  also  cause  it  to  crash.  Never  alter kernel parameters on a
995 production system.  Set  up  a  development machine and test to make sure that
996 everything works  the  way  you want it to. You may have no alternative but to
997 reboot the machine once an error has been made.
998
999 To change  a  value,  simply  echo  the new value into the file. An example is
1000 given below  in the section on the file system data. You need to be root to do
1001 this. You  can  create  your  own  boot script to perform this every time your
1002 system boots.
1003
1004 The files  in /proc/sys can be used to fine tune and monitor miscellaneous and
1005 general things  in  the operation of the Linux kernel. Since some of the files
1006 can inadvertently  disrupt  your  system,  it  is  advisable  to  read  both
1007 documentation and  source  before actually making adjustments. In any case, be
1008 very careful  when  writing  to  any  of these files. The entries in /proc may
1009 change slightly between the 2.1.* and the 2.2 kernel, so if there is any doubt
1010 review the kernel documentation in the directory /usr/src/linux/Documentation.
1011 This chapter  is  heavily  based  on the documentation included in the pre 2.2
1012 kernels, and became part of it in version 2.2.1 of the Linux kernel.
1013
1014 2.1 /proc/sys/fs - File system data
1015 -----------------------------------
1016
1017 This subdirectory  contains  specific  file system, file handle, inode, dentry
1018 and quota information.
1019
1020 Currently, these files are in /proc/sys/fs:
1021
1022 dentry-state
1023 ------------
1024
1025 Status of  the  directory  cache.  Since  directory  entries  are  dynamically
1026 allocated and  deallocated,  this  file indicates the current status. It holds
1027 six values, in which the last two are not used and are always zero. The others
1028 are listed in table 2-1.
1029
1030
1031 Table 2-1: Status files of the directory cache 
1032 ..............................................................................
1033  File       Content                                                            
1034  nr_dentry  Almost always zero                                                 
1035  nr_unused  Number of unused cache entries                                     
1036  age_limit  
1037             in seconds after the entry may be reclaimed, when memory is short 
1038  want_pages internally                                                         
1039 ..............................................................................
1040
1041 dquot-nr and dquot-max
1042 ----------------------
1043
1044 The file dquot-max shows the maximum number of cached disk quota entries.
1045
1046 The file  dquot-nr  shows  the  number of allocated disk quota entries and the
1047 number of free disk quota entries.
1048
1049 If the number of available cached disk quotas is very low and you have a large
1050 number of simultaneous system users, you might want to raise the limit.
1051
1052 file-nr and file-max
1053 --------------------
1054
1055 The kernel  allocates file handles dynamically, but doesn't free them again at
1056 this time.
1057
1058 The value  in  file-max  denotes  the  maximum number of file handles that the
1059 Linux kernel will allocate. When you get a lot of error messages about running
1060 out of  file handles, you might want to raise this limit. The default value is
1061 10% of  RAM in kilobytes.  To  change it, just  write the new number  into the
1062 file:
1063
1064   # cat /proc/sys/fs/file-max 
1065   4096 
1066   # echo 8192 > /proc/sys/fs/file-max 
1067   # cat /proc/sys/fs/file-max 
1068   8192 
1069
1070
1071 This method  of  revision  is  useful  for  all customizable parameters of the
1072 kernel - simply echo the new value to the corresponding file.
1073
1074 Historically, the three values in file-nr denoted the number of allocated file
1075 handles,  the number of  allocated but  unused file  handles, and  the maximum
1076 number of file handles. Linux 2.6 always  reports 0 as the number of free file
1077 handles -- this  is not an error,  it just means that the  number of allocated
1078 file handles exactly matches the number of used file handles.
1079
1080 Attempts to  allocate more  file descriptors than  file-max are  reported with
1081 printk, look for "VFS: file-max limit <number> reached".
1082
1083 inode-state and inode-nr
1084 ------------------------
1085
1086 The file inode-nr contains the first two items from inode-state, so we'll skip
1087 to that file...
1088
1089 inode-state contains  two  actual numbers and five dummy values. The numbers
1090 are nr_inodes and nr_free_inodes (in order of appearance).
1091
1092 nr_inodes
1093 ~~~~~~~~~
1094
1095 Denotes the  number  of  inodes the system has allocated. This number will
1096 grow and shrink dynamically.
1097
1098 nr_open
1099 -------
1100
1101 Denotes the maximum number of file-handles a process can
1102 allocate. Default value is 1024*1024 (1048576) which should be
1103 enough for most machines. Actual limit depends on RLIMIT_NOFILE
1104 resource limit.
1105
1106 nr_free_inodes
1107 --------------
1108
1109 Represents the  number of free inodes. Ie. The number of inuse inodes is
1110 (nr_inodes - nr_free_inodes).
1111
1112 aio-nr and aio-max-nr
1113 ---------------------
1114
1115 aio-nr is the running total of the number of events specified on the
1116 io_setup system call for all currently active aio contexts.  If aio-nr
1117 reaches aio-max-nr then io_setup will fail with EAGAIN.  Note that
1118 raising aio-max-nr does not result in the pre-allocation or re-sizing
1119 of any kernel data structures.
1120
1121 2.2 /proc/sys/fs/binfmt_misc - Miscellaneous binary formats
1122 -----------------------------------------------------------
1123
1124 Besides these  files, there is the subdirectory /proc/sys/fs/binfmt_misc. This
1125 handles the kernel support for miscellaneous binary formats.
1126
1127 Binfmt_misc provides  the ability to register additional binary formats to the
1128 Kernel without  compiling  an additional module/kernel. Therefore, binfmt_misc
1129 needs to  know magic numbers at the beginning or the filename extension of the
1130 binary.
1131
1132 It works by maintaining a linked list of structs that contain a description of
1133 a binary  format,  including  a  magic  with size (or the filename extension),
1134 offset and  mask,  and  the  interpreter name. On request it invokes the given
1135 interpreter with  the  original  program  as  argument,  as  binfmt_java  and
1136 binfmt_em86 and  binfmt_mz  do.  Since binfmt_misc does not define any default
1137 binary-formats, you have to register an additional binary-format.
1138
1139 There are two general files in binfmt_misc and one file per registered format.
1140 The two general files are register and status.
1141
1142 Registering a new binary format
1143 -------------------------------
1144
1145 To register a new binary format you have to issue the command
1146
1147   echo :name:type:offset:magic:mask:interpreter: > /proc/sys/fs/binfmt_misc/register 
1148
1149
1150
1151 with appropriate  name (the name for the /proc-dir entry), offset (defaults to
1152 0, if  omitted),  magic, mask (which can be omitted, defaults to all 0xff) and
1153 last but  not  least,  the  interpreter that is to be invoked (for example and
1154 testing /bin/echo).  Type  can be M for usual magic matching or E for filename
1155 extension matching (give extension in place of magic).
1156
1157 Check or reset the status of the binary format handler
1158 ------------------------------------------------------
1159
1160 If you  do a cat on the file /proc/sys/fs/binfmt_misc/status, you will get the
1161 current status (enabled/disabled) of binfmt_misc. Change the status by echoing
1162 0 (disables)  or  1  (enables)  or  -1  (caution:  this  clears all previously
1163 registered binary  formats)  to status. For example echo 0 > status to disable
1164 binfmt_misc (temporarily).
1165
1166 Status of a single handler
1167 --------------------------
1168
1169 Each registered  handler has an entry in /proc/sys/fs/binfmt_misc. These files
1170 perform the  same function as status, but their scope is limited to the actual
1171 binary format.  By  cating this file, you also receive all related information
1172 about the interpreter/magic of the binfmt.
1173
1174 Example usage of binfmt_misc (emulate binfmt_java)
1175 --------------------------------------------------
1176
1177   cd /proc/sys/fs/binfmt_misc  
1178   echo ':Java:M::\xca\xfe\xba\xbe::/usr/local/java/bin/javawrapper:' > register  
1179   echo ':HTML:E::html::/usr/local/java/bin/appletviewer:' > register  
1180   echo ':Applet:M::<!--applet::/usr/local/java/bin/appletviewer:' > register 
1181   echo ':DEXE:M::\x0eDEX::/usr/bin/dosexec:' > register 
1182
1183
1184 These four  lines  add  support  for  Java  executables and Java applets (like
1185 binfmt_java, additionally  recognizing the .html extension with no need to put
1186 <!--applet> to  every  applet  file).  You  have  to  install  the JDK and the
1187 shell-script /usr/local/java/bin/javawrapper  too.  It  works  around  the
1188 brokenness of  the Java filename handling. To add a Java binary, just create a
1189 link to the class-file somewhere in the path.
1190
1191 2.3 /proc/sys/kernel - general kernel parameters
1192 ------------------------------------------------
1193
1194 This directory  reflects  general  kernel  behaviors. As I've said before, the
1195 contents depend  on  your  configuration.  Here you'll find the most important
1196 files, along with descriptions of what they mean and how to use them.
1197
1198 acct
1199 ----
1200
1201 The file contains three values; highwater, lowwater, and frequency.
1202
1203 It exists  only  when  BSD-style  process  accounting is enabled. These values
1204 control its behavior. If the free space on the file system where the log lives
1205 goes below  lowwater  percentage,  accounting  suspends.  If  it  goes  above
1206 highwater percentage,  accounting  resumes. Frequency determines how often you
1207 check the amount of free space (value is in seconds). Default settings are: 4,
1208 2, and  30.  That is, suspend accounting if there is less than 2 percent free;
1209 resume it  if we have a value of 3 or more percent; consider information about
1210 the amount of free space valid for 30 seconds
1211
1212 ctrl-alt-del
1213 ------------
1214
1215 When the value in this file is 0, ctrl-alt-del is trapped and sent to the init
1216 program to  handle a graceful restart. However, when the value is greater that
1217 zero, Linux's  reaction  to  this key combination will be an immediate reboot,
1218 without syncing its dirty buffers.
1219
1220 [NOTE]
1221     When a  program  (like  dosemu)  has  the  keyboard  in  raw  mode,  the
1222     ctrl-alt-del is  intercepted  by  the  program  before it ever reaches the
1223     kernel tty  layer,  and  it is up to the program to decide what to do with
1224     it.
1225
1226 domainname and hostname
1227 -----------------------
1228
1229 These files  can  be controlled to set the NIS domainname and hostname of your
1230 box. For the classic darkstar.frop.org a simple:
1231
1232   # echo "darkstar" > /proc/sys/kernel/hostname 
1233   # echo "frop.org" > /proc/sys/kernel/domainname 
1234
1235
1236 would suffice to set your hostname and NIS domainname.
1237
1238 osrelease, ostype and version
1239 -----------------------------
1240
1241 The names make it pretty obvious what these fields contain:
1242
1243   > cat /proc/sys/kernel/osrelease 
1244   2.2.12 
1245    
1246   > cat /proc/sys/kernel/ostype 
1247   Linux 
1248    
1249   > cat /proc/sys/kernel/version 
1250   #4 Fri Oct 1 12:41:14 PDT 1999 
1251
1252
1253 The files  osrelease and ostype should be clear enough. Version needs a little
1254 more clarification.  The  #4 means that this is the 4th kernel built from this
1255 source base and the date after it indicates the time the kernel was built. The
1256 only way to tune these values is to rebuild the kernel.
1257
1258 panic
1259 -----
1260
1261 The value  in  this  file  represents  the  number of seconds the kernel waits
1262 before rebooting  on  a  panic.  When  you  use  the  software  watchdog,  the
1263 recommended setting  is  60. If set to 0, the auto reboot after a kernel panic
1264 is disabled, which is the default setting.
1265
1266 printk
1267 ------
1268
1269 The four values in printk denote
1270 * console_loglevel,
1271 * default_message_loglevel,
1272 * minimum_console_loglevel and
1273 * default_console_loglevel
1274 respectively.
1275
1276 These values  influence  printk()  behavior  when  printing  or  logging error
1277 messages, which  come  from  inside  the  kernel.  See  syslog(2)  for  more
1278 information on the different log levels.
1279
1280 console_loglevel
1281 ----------------
1282
1283 Messages with a higher priority than this will be printed to the console.
1284
1285 default_message_level
1286 ---------------------
1287
1288 Messages without an explicit priority will be printed with this priority.
1289
1290 minimum_console_loglevel
1291 ------------------------
1292
1293 Minimum (highest) value to which the console_loglevel can be set.
1294
1295 default_console_loglevel
1296 ------------------------
1297
1298 Default value for console_loglevel.
1299
1300 sg-big-buff
1301 -----------
1302
1303 This file  shows  the size of the generic SCSI (sg) buffer. At this point, you
1304 can't tune  it  yet,  but  you  can  change  it  at  compile  time  by editing
1305 include/scsi/sg.h and changing the value of SG_BIG_BUFF.
1306
1307 If you use a scanner with SANE (Scanner Access Now Easy) you might want to set
1308 this to a higher value. Refer to the SANE documentation on this issue.
1309
1310 modprobe
1311 --------
1312
1313 The location  where  the  modprobe  binary  is  located.  The kernel uses this
1314 program to load modules on demand.
1315
1316 unknown_nmi_panic
1317 -----------------
1318
1319 The value in this file affects behavior of handling NMI. When the value is
1320 non-zero, unknown NMI is trapped and then panic occurs. At that time, kernel
1321 debugging information is displayed on console.
1322
1323 NMI switch that most IA32 servers have fires unknown NMI up, for example.
1324 If a system hangs up, try pressing the NMI switch.
1325
1326 panic_on_unrecovered_nmi
1327 ------------------------
1328
1329 The default Linux behaviour on an NMI of either memory or unknown is to continue
1330 operation. For many environments such as scientific computing it is preferable
1331 that the box is taken out and the error dealt with than an uncorrected
1332 parity/ECC error get propogated.
1333
1334 A small number of systems do generate NMI's for bizarre random reasons such as
1335 power management so the default is off. That sysctl works like the existing
1336 panic controls already in that directory.
1337
1338 nmi_watchdog
1339 ------------
1340
1341 Enables/Disables the NMI watchdog on x86 systems.  When the value is non-zero
1342 the NMI watchdog is enabled and will continuously test all online cpus to
1343 determine whether or not they are still functioning properly. Currently,
1344 passing "nmi_watchdog=" parameter at boot time is required for this function
1345 to work.
1346
1347 If LAPIC NMI watchdog method is in use (nmi_watchdog=2 kernel parameter), the
1348 NMI watchdog shares registers with oprofile. By disabling the NMI watchdog,
1349 oprofile may have more registers to utilize.
1350
1351 msgmni
1352 ------
1353
1354 Maximum number of message queue ids on the system.
1355 This value scales to the amount of lowmem. It is automatically recomputed
1356 upon memory add/remove or ipc namespace creation/removal.
1357 When a value is written into this file, msgmni's value becomes fixed, i.e. it
1358 is not recomputed anymore when one of the above events occurs.
1359 Use auto_msgmni to change this behavior.
1360
1361 auto_msgmni
1362 -----------
1363
1364 Enables/Disables automatic recomputing of msgmni upon memory add/remove or
1365 upon ipc namespace creation/removal (see the msgmni description above).
1366 Echoing "1" into this file enables msgmni automatic recomputing.
1367 Echoing "0" turns it off.
1368 auto_msgmni default value is 1.
1369
1370
1371 2.4 /proc/sys/vm - The virtual memory subsystem
1372 -----------------------------------------------
1373
1374 The files  in  this directory can be used to tune the operation of the virtual
1375 memory (VM)  subsystem  of  the  Linux  kernel.
1376
1377 vfs_cache_pressure
1378 ------------------
1379
1380 Controls the tendency of the kernel to reclaim the memory which is used for
1381 caching of directory and inode objects.
1382
1383 At the default value of vfs_cache_pressure=100 the kernel will attempt to
1384 reclaim dentries and inodes at a "fair" rate with respect to pagecache and
1385 swapcache reclaim.  Decreasing vfs_cache_pressure causes the kernel to prefer
1386 to retain dentry and inode caches.  Increasing vfs_cache_pressure beyond 100
1387 causes the kernel to prefer to reclaim dentries and inodes.
1388
1389 dirty_background_bytes
1390 ----------------------
1391
1392 Contains the amount of dirty memory at which the pdflush background writeback
1393 daemon will start writeback.
1394
1395 If dirty_background_bytes is written, dirty_background_ratio becomes a function
1396 of its value (dirty_background_bytes / the amount of dirtyable system memory).
1397
1398 dirty_background_ratio
1399 ----------------------
1400
1401 Contains, as a percentage of the dirtyable system memory (free pages + mapped
1402 pages + file cache, not including locked pages and HugePages), the number of
1403 pages at which the pdflush background writeback daemon will start writing out
1404 dirty data.
1405
1406 If dirty_background_ratio is written, dirty_background_bytes becomes a function
1407 of its value (dirty_background_ratio * the amount of dirtyable system memory).
1408
1409 dirty_bytes
1410 -----------
1411
1412 Contains the amount of dirty memory at which a process generating disk writes
1413 will itself start writeback.
1414
1415 If dirty_bytes is written, dirty_ratio becomes a function of its value
1416 (dirty_bytes / the amount of dirtyable system memory).
1417
1418 dirty_ratio
1419 -----------
1420
1421 Contains, as a percentage of the dirtyable system memory (free pages + mapped
1422 pages + file cache, not including locked pages and HugePages), the number of
1423 pages at which a process which is generating disk writes will itself start
1424 writing out dirty data.
1425
1426 If dirty_ratio is written, dirty_bytes becomes a function of its value
1427 (dirty_ratio * the amount of dirtyable system memory).
1428
1429 dirty_writeback_centisecs
1430 -------------------------
1431
1432 The pdflush writeback daemons will periodically wake up and write `old' data
1433 out to disk.  This tunable expresses the interval between those wakeups, in
1434 100'ths of a second.
1435
1436 Setting this to zero disables periodic writeback altogether.
1437
1438 dirty_expire_centisecs
1439 ----------------------
1440
1441 This tunable is used to define when dirty data is old enough to be eligible
1442 for writeout by the pdflush daemons.  It is expressed in 100'ths of a second. 
1443 Data which has been dirty in-memory for longer than this interval will be
1444 written out next time a pdflush daemon wakes up.
1445
1446 highmem_is_dirtyable
1447 --------------------
1448
1449 Only present if CONFIG_HIGHMEM is set.
1450
1451 This defaults to 0 (false), meaning that the ratios set above are calculated
1452 as a percentage of lowmem only.  This protects against excessive scanning
1453 in page reclaim, swapping and general VM distress.
1454
1455 Setting this to 1 can be useful on 32 bit machines where you want to make
1456 random changes within an MMAPed file that is larger than your available
1457 lowmem without causing large quantities of random IO.  Is is safe if the
1458 behavior of all programs running on the machine is known and memory will
1459 not be otherwise stressed.
1460
1461 legacy_va_layout
1462 ----------------
1463
1464 If non-zero, this sysctl disables the new 32-bit mmap mmap layout - the kernel
1465 will use the legacy (2.4) layout for all processes.
1466
1467 lowmem_reserve_ratio
1468 ---------------------
1469
1470 For some specialised workloads on highmem machines it is dangerous for
1471 the kernel to allow process memory to be allocated from the "lowmem"
1472 zone.  This is because that memory could then be pinned via the mlock()
1473 system call, or by unavailability of swapspace.
1474
1475 And on large highmem machines this lack of reclaimable lowmem memory
1476 can be fatal.
1477
1478 So the Linux page allocator has a mechanism which prevents allocations
1479 which _could_ use highmem from using too much lowmem.  This means that
1480 a certain amount of lowmem is defended from the possibility of being
1481 captured into pinned user memory.
1482
1483 (The same argument applies to the old 16 megabyte ISA DMA region.  This
1484 mechanism will also defend that region from allocations which could use
1485 highmem or lowmem).
1486
1487 The `lowmem_reserve_ratio' tunable determines how aggressive the kernel is
1488 in defending these lower zones.
1489
1490 If you have a machine which uses highmem or ISA DMA and your
1491 applications are using mlock(), or if you are running with no swap then
1492 you probably should change the lowmem_reserve_ratio setting.
1493
1494 The lowmem_reserve_ratio is an array. You can see them by reading this file.
1495 -
1496 % cat /proc/sys/vm/lowmem_reserve_ratio
1497 256     256     32
1498 -
1499 Note: # of this elements is one fewer than number of zones. Because the highest
1500       zone's value is not necessary for following calculation.
1501
1502 But, these values are not used directly. The kernel calculates # of protection
1503 pages for each zones from them. These are shown as array of protection pages
1504 in /proc/zoneinfo like followings. (This is an example of x86-64 box).
1505 Each zone has an array of protection pages like this.
1506
1507 -
1508 Node 0, zone      DMA
1509   pages free     1355
1510         min      3
1511         low      3
1512         high     4
1513         :
1514         :
1515     numa_other   0
1516         protection: (0, 2004, 2004, 2004)
1517         ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
1518   pagesets
1519     cpu: 0 pcp: 0
1520         :
1521 -
1522 These protections are added to score to judge whether this zone should be used
1523 for page allocation or should be reclaimed.
1524
1525 In this example, if normal pages (index=2) are required to this DMA zone and
1526 pages_high is used for watermark, the kernel judges this zone should not be
1527 used because pages_free(1355) is smaller than watermark + protection[2]
1528 (4 + 2004 = 2008). If this protection value is 0, this zone would be used for
1529 normal page requirement. If requirement is DMA zone(index=0), protection[0]
1530 (=0) is used.
1531
1532 zone[i]'s protection[j] is calculated by following expression.
1533
1534 (i < j):
1535   zone[i]->protection[j]
1536   = (total sums of present_pages from zone[i+1] to zone[j] on the node)
1537     / lowmem_reserve_ratio[i];
1538 (i = j):
1539    (should not be protected. = 0;
1540 (i > j):
1541    (not necessary, but looks 0)
1542
1543 The default values of lowmem_reserve_ratio[i] are
1544     256 (if zone[i] means DMA or DMA32 zone)
1545     32  (others).
1546 As above expression, they are reciprocal number of ratio.
1547 256 means 1/256. # of protection pages becomes about "0.39%" of total present
1548 pages of higher zones on the node.
1549
1550 If you would like to protect more pages, smaller values are effective.
1551 The minimum value is 1 (1/1 -> 100%).
1552
1553 page-cluster
1554 ------------
1555
1556 page-cluster controls the number of pages which are written to swap in
1557 a single attempt.  The swap I/O size.
1558
1559 It is a logarithmic value - setting it to zero means "1 page", setting
1560 it to 1 means "2 pages", setting it to 2 means "4 pages", etc.
1561
1562 The default value is three (eight pages at a time).  There may be some
1563 small benefits in tuning this to a different value if your workload is
1564 swap-intensive.
1565
1566 overcommit_memory
1567 -----------------
1568
1569 Controls overcommit of system memory, possibly allowing processes
1570 to allocate (but not use) more memory than is actually available.
1571
1572
1573 0       -       Heuristic overcommit handling. Obvious overcommits of
1574                 address space are refused. Used for a typical system. It
1575                 ensures a seriously wild allocation fails while allowing
1576                 overcommit to reduce swap usage.  root is allowed to
1577                 allocate slightly more memory in this mode. This is the
1578                 default.
1579
1580 1       -       Always overcommit. Appropriate for some scientific
1581                 applications.
1582
1583 2       -       Don't overcommit. The total address space commit
1584                 for the system is not permitted to exceed swap plus a
1585                 configurable percentage (default is 50) of physical RAM.
1586                 Depending on the percentage you use, in most situations
1587                 this means a process will not be killed while attempting
1588                 to use already-allocated memory but will receive errors
1589                 on memory allocation as appropriate.
1590
1591 overcommit_ratio
1592 ----------------
1593
1594 Percentage of physical memory size to include in overcommit calculations
1595 (see above.)
1596
1597 Memory allocation limit = swapspace + physmem * (overcommit_ratio / 100)
1598
1599         swapspace = total size of all swap areas
1600         physmem = size of physical memory in system
1601
1602 nr_hugepages and hugetlb_shm_group
1603 ----------------------------------
1604
1605 nr_hugepages configures number of hugetlb page reserved for the system.
1606
1607 hugetlb_shm_group contains group id that is allowed to create SysV shared
1608 memory segment using hugetlb page.
1609
1610 hugepages_treat_as_movable
1611 --------------------------
1612
1613 This parameter is only useful when kernelcore= is specified at boot time to
1614 create ZONE_MOVABLE for pages that may be reclaimed or migrated. Huge pages
1615 are not movable so are not normally allocated from ZONE_MOVABLE. A non-zero
1616 value written to hugepages_treat_as_movable allows huge pages to be allocated
1617 from ZONE_MOVABLE.
1618
1619 Once enabled, the ZONE_MOVABLE is treated as an area of memory the huge
1620 pages pool can easily grow or shrink within. Assuming that applications are
1621 not running that mlock() a lot of memory, it is likely the huge pages pool
1622 can grow to the size of ZONE_MOVABLE by repeatedly entering the desired value
1623 into nr_hugepages and triggering page reclaim.
1624
1625 laptop_mode
1626 -----------
1627
1628 laptop_mode is a knob that controls "laptop mode". All the things that are
1629 controlled by this knob are discussed in Documentation/laptops/laptop-mode.txt.
1630
1631 block_dump
1632 ----------
1633
1634 block_dump enables block I/O debugging when set to a nonzero value. More
1635 information on block I/O debugging is in Documentation/laptops/laptop-mode.txt.
1636
1637 swap_token_timeout
1638 ------------------
1639
1640 This file contains valid hold time of swap out protection token. The Linux
1641 VM has token based thrashing control mechanism and uses the token to prevent
1642 unnecessary page faults in thrashing situation. The unit of the value is
1643 second. The value would be useful to tune thrashing behavior.
1644
1645 drop_caches
1646 -----------
1647
1648 Writing to this will cause the kernel to drop clean caches, dentries and
1649 inodes from memory, causing that memory to become free.
1650
1651 To free pagecache:
1652         echo 1 > /proc/sys/vm/drop_caches
1653 To free dentries and inodes:
1654         echo 2 > /proc/sys/vm/drop_caches
1655 To free pagecache, dentries and inodes:
1656         echo 3 > /proc/sys/vm/drop_caches
1657
1658 As this is a non-destructive operation and dirty objects are not freeable, the
1659 user should run `sync' first.
1660
1661
1662 2.5 /proc/sys/dev - Device specific parameters
1663 ----------------------------------------------
1664
1665 Currently there is only support for CDROM drives, and for those, there is only
1666 one read-only  file containing information about the CD-ROM drives attached to
1667 the system:
1668
1669   >cat /proc/sys/dev/cdrom/info 
1670   CD-ROM information, Id: cdrom.c 2.55 1999/04/25 
1671    
1672   drive name:             sr0     hdb 
1673   drive speed:            32      40 
1674   drive # of slots:       1       0 
1675   Can close tray:         1       1 
1676   Can open tray:          1       1 
1677   Can lock tray:          1       1 
1678   Can change speed:       1       1 
1679   Can select disk:        0       1 
1680   Can read multisession:  1       1 
1681   Can read MCN:           1       1 
1682   Reports media changed:  1       1 
1683   Can play audio:         1       1 
1684
1685
1686 You see two drives, sr0 and hdb, along with a list of their features.
1687
1688 2.6 /proc/sys/sunrpc - Remote procedure calls
1689 ---------------------------------------------
1690
1691 This directory  contains four files, which enable or disable debugging for the
1692 RPC functions NFS, NFS-daemon, RPC and NLM. The default values are 0. They can
1693 be set to one to turn debugging on. (The default value is 0 for each)
1694
1695 2.7 /proc/sys/net - Networking stuff
1696 ------------------------------------
1697
1698 The interface  to  the  networking  parts  of  the  kernel  is  located  in
1699 /proc/sys/net. Table  2-3  shows all possible subdirectories. You may see only
1700 some of them, depending on your kernel's configuration.
1701
1702
1703 Table 2-3: Subdirectories in /proc/sys/net 
1704 ..............................................................................
1705  Directory Content             Directory  Content            
1706  core      General parameter   appletalk  Appletalk protocol 
1707  unix      Unix domain sockets netrom     NET/ROM            
1708  802       E802 protocol       ax25       AX25               
1709  ethernet  Ethernet protocol   rose       X.25 PLP layer     
1710  ipv4      IP version 4        x25        X.25 protocol      
1711  ipx       IPX                 token-ring IBM token ring     
1712  bridge    Bridging            decnet     DEC net            
1713  ipv6      IP version 6                   
1714 ..............................................................................
1715
1716 We will  concentrate  on IP networking here. Since AX15, X.25, and DEC Net are
1717 only minor players in the Linux world, we'll skip them in this chapter. You'll
1718 find some  short  info on Appletalk and IPX further on in this chapter. Review
1719 the online  documentation  and the kernel source to get a detailed view of the
1720 parameters for  those  protocols.  In  this  section  we'll  discuss  the
1721 subdirectories printed  in  bold letters in the table above. As default values
1722 are suitable for most needs, there is no need to change these values.
1723
1724 /proc/sys/net/core - Network core options
1725 -----------------------------------------
1726
1727 rmem_default
1728 ------------
1729
1730 The default setting of the socket receive buffer in bytes.
1731
1732 rmem_max
1733 --------
1734
1735 The maximum receive socket buffer size in bytes.
1736
1737 wmem_default
1738 ------------
1739
1740 The default setting (in bytes) of the socket send buffer.
1741
1742 wmem_max
1743 --------
1744
1745 The maximum send socket buffer size in bytes.
1746
1747 message_burst and message_cost
1748 ------------------------------
1749
1750 These parameters  are used to limit the warning messages written to the kernel
1751 log from  the  networking  code.  They  enforce  a  rate  limit  to  make  a
1752 denial-of-service attack  impossible. A higher message_cost factor, results in
1753 fewer messages that will be written. Message_burst controls when messages will
1754 be dropped.  The  default  settings  limit  warning messages to one every five
1755 seconds.
1756
1757 warnings
1758 --------
1759
1760 This controls console messages from the networking stack that can occur because
1761 of problems on the network like duplicate address or bad checksums. Normally,
1762 this should be enabled, but if the problem persists the messages can be
1763 disabled.
1764
1765
1766 netdev_max_backlog
1767 ------------------
1768
1769 Maximum number  of  packets,  queued  on  the  INPUT  side, when the interface
1770 receives packets faster than kernel can process them.
1771
1772 optmem_max
1773 ----------
1774
1775 Maximum ancillary buffer size allowed per socket. Ancillary data is a sequence
1776 of struct cmsghdr structures with appended data.
1777
1778 /proc/sys/net/unix - Parameters for Unix domain sockets
1779 -------------------------------------------------------
1780
1781 There are  only  two  files  in this subdirectory. They control the delays for
1782 deleting and destroying socket descriptors.
1783
1784 2.8 /proc/sys/net/ipv4 - IPV4 settings
1785 --------------------------------------
1786
1787 IP version  4  is  still the most used protocol in Unix networking. It will be
1788 replaced by  IP version 6 in the next couple of years, but for the moment it's
1789 the de  facto  standard  for  the  internet  and  is  used  in most networking
1790 environments around  the  world.  Because  of the importance of this protocol,
1791 we'll have a deeper look into the subtree controlling the behavior of the IPv4
1792 subsystem of the Linux kernel.
1793
1794 Let's start with the entries in /proc/sys/net/ipv4.
1795
1796 ICMP settings
1797 -------------
1798
1799 icmp_echo_ignore_all and icmp_echo_ignore_broadcasts
1800 ----------------------------------------------------
1801
1802 Turn on (1) or off (0), if the kernel should ignore all ICMP ECHO requests, or
1803 just those to broadcast and multicast addresses.
1804
1805 Please note that if you accept ICMP echo requests with a broadcast/multi\-cast
1806 destination address  your  network  may  be  used as an exploder for denial of
1807 service packet flooding attacks to other hosts.
1808
1809 icmp_destunreach_rate, icmp_echoreply_rate, icmp_paramprob_rate and icmp_timeexeed_rate
1810 ---------------------------------------------------------------------------------------
1811
1812 Sets limits  for  sending  ICMP  packets  to specific targets. A value of zero
1813 disables all  limiting.  Any  positive  value sets the maximum package rate in
1814 hundredth of a second (on Intel systems).
1815
1816 IP settings
1817 -----------
1818
1819 ip_autoconfig
1820 -------------
1821
1822 This file contains the number one if the host received its IP configuration by
1823 RARP, BOOTP, DHCP or a similar mechanism. Otherwise it is zero.
1824
1825 ip_default_ttl
1826 --------------
1827
1828 TTL (Time  To  Live) for IPv4 interfaces. This is simply the maximum number of
1829 hops a packet may travel.
1830
1831 ip_dynaddr
1832 ----------
1833
1834 Enable dynamic  socket  address rewriting on interface address change. This is
1835 useful for dialup interface with changing IP addresses.
1836
1837 ip_forward
1838 ----------
1839
1840 Enable or  disable forwarding of IP packages between interfaces. Changing this
1841 value resets  all other parameters to their default values. They differ if the
1842 kernel is configured as host or router.
1843
1844 ip_local_port_range
1845 -------------------
1846
1847 Range of  ports  used  by  TCP  and UDP to choose the local port. Contains two
1848 numbers, the  first  number  is the lowest port, the second number the highest
1849 local port.  Default  is  1024-4999.  Should  be  changed  to  32768-61000 for
1850 high-usage systems.
1851
1852 ip_no_pmtu_disc
1853 ---------------
1854
1855 Global switch  to  turn  path  MTU  discovery off. It can also be set on a per
1856 socket basis by the applications or on a per route basis.
1857
1858 ip_masq_debug
1859 -------------
1860
1861 Enable/disable debugging of IP masquerading.
1862
1863 IP fragmentation settings
1864 -------------------------
1865
1866 ipfrag_high_trash and ipfrag_low_trash
1867 --------------------------------------
1868
1869 Maximum memory  used to reassemble IP fragments. When ipfrag_high_thresh bytes
1870 of memory  is  allocated  for  this  purpose,  the  fragment handler will toss
1871 packets until ipfrag_low_thresh is reached.
1872
1873 ipfrag_time
1874 -----------
1875
1876 Time in seconds to keep an IP fragment in memory.
1877
1878 TCP settings
1879 ------------
1880
1881 tcp_ecn
1882 -------
1883
1884 This file controls the use of the ECN bit in the IPv4 headers. This is a new
1885 feature about Explicit Congestion Notification, but some routers and firewalls
1886 block traffic that has this bit set, so it could be necessary to echo 0 to
1887 /proc/sys/net/ipv4/tcp_ecn if you want to talk to these sites. For more info
1888 you could read RFC2481.
1889
1890 tcp_retrans_collapse
1891 --------------------
1892
1893 Bug-to-bug compatibility with some broken printers. On retransmit, try to send
1894 larger packets to work around bugs in certain TCP stacks. Can be turned off by
1895 setting it to zero.
1896
1897 tcp_keepalive_probes
1898 --------------------
1899
1900 Number of  keep  alive  probes  TCP  sends  out,  until  it  decides  that the
1901 connection is broken.
1902
1903 tcp_keepalive_time
1904 ------------------
1905
1906 How often  TCP  sends out keep alive messages, when keep alive is enabled. The
1907 default is 2 hours.
1908
1909 tcp_syn_retries
1910 ---------------
1911
1912 Number of  times  initial  SYNs  for  a  TCP  connection  attempt  will  be
1913 retransmitted. Should  not  be  higher  than 255. This is only the timeout for
1914 outgoing connections,  for  incoming  connections the number of retransmits is
1915 defined by tcp_retries1.
1916
1917 tcp_sack
1918 --------
1919
1920 Enable select acknowledgments after RFC2018.
1921
1922 tcp_timestamps
1923 --------------
1924
1925 Enable timestamps as defined in RFC1323.
1926
1927 tcp_stdurg
1928 ----------
1929
1930 Enable the  strict  RFC793 interpretation of the TCP urgent pointer field. The
1931 default is  to  use  the  BSD  compatible interpretation of the urgent pointer
1932 pointing to the first byte after the urgent data. The RFC793 interpretation is
1933 to have  it  point  to  the last byte of urgent data. Enabling this option may
1934 lead to interoperability problems. Disabled by default.
1935
1936 tcp_syncookies
1937 --------------
1938
1939 Only valid  when  the  kernel  was  compiled  with CONFIG_SYNCOOKIES. Send out
1940 syncookies when  the  syn backlog queue of a socket overflows. This is to ward
1941 off the common 'syn flood attack'. Disabled by default.
1942
1943 Note that  the  concept  of a socket backlog is abandoned. This means the peer
1944 may not  receive  reliable  error  messages  from  an  over loaded server with
1945 syncookies enabled.
1946
1947 tcp_window_scaling
1948 ------------------
1949
1950 Enable window scaling as defined in RFC1323.
1951
1952 tcp_fin_timeout
1953 ---------------
1954
1955 The length  of  time  in  seconds  it  takes to receive a final FIN before the
1956 socket is  always  closed.  This  is  strictly  a  violation  of  the  TCP
1957 specification, but required to prevent denial-of-service attacks.
1958
1959 tcp_max_ka_probes
1960 -----------------
1961
1962 Indicates how  many  keep alive probes are sent per slow timer run. Should not
1963 be set too high to prevent bursts.
1964
1965 tcp_max_syn_backlog
1966 -------------------
1967
1968 Length of  the per socket backlog queue. Since Linux 2.2 the backlog specified
1969 in listen(2)  only  specifies  the  length  of  the  backlog  queue of already
1970 established sockets. When more connection requests arrive Linux starts to drop
1971 packets. When  syncookies  are  enabled the packets are still answered and the
1972 maximum queue is effectively ignored.
1973
1974 tcp_retries1
1975 ------------
1976
1977 Defines how  often  an  answer  to  a  TCP connection request is retransmitted
1978 before giving up.
1979
1980 tcp_retries2
1981 ------------
1982
1983 Defines how often a TCP packet is retransmitted before giving up.
1984
1985 Interface specific settings
1986 ---------------------------
1987
1988 In the directory /proc/sys/net/ipv4/conf you'll find one subdirectory for each
1989 interface the  system  knows about and one directory calls all. Changes in the
1990 all subdirectory  affect  all  interfaces,  whereas  changes  in  the  other
1991 subdirectories affect  only  one  interface.  All  directories  have  the same
1992 entries:
1993
1994 accept_redirects
1995 ----------------
1996
1997 This switch  decides  if the kernel accepts ICMP redirect messages or not. The
1998 default is 'yes' if the kernel is configured for a regular host and 'no' for a
1999 router configuration.
2000
2001 accept_source_route
2002 -------------------
2003
2004 Should source  routed  packages  be  accepted  or  declined.  The  default  is
2005 dependent on  the  kernel  configuration.  It's 'yes' for routers and 'no' for
2006 hosts.
2007
2008 bootp_relay
2009 ~~~~~~~~~~~
2010
2011 Accept packets  with source address 0.b.c.d with destinations not to this host
2012 as local ones. It is supposed that a BOOTP relay daemon will catch and forward
2013 such packets.
2014
2015 The default  is  0,  since this feature is not implemented yet (kernel version
2016 2.2.12).
2017
2018 forwarding
2019 ----------
2020
2021 Enable or disable IP forwarding on this interface.
2022
2023 log_martians
2024 ------------
2025
2026 Log packets with source addresses with no known route to kernel log.
2027
2028 mc_forwarding
2029 -------------
2030
2031 Do multicast routing. The kernel needs to be compiled with CONFIG_MROUTE and a
2032 multicast routing daemon is required.
2033
2034 proxy_arp
2035 ---------
2036
2037 Does (1) or does not (0) perform proxy ARP.
2038
2039 rp_filter
2040 ---------
2041
2042 Integer value determines if a source validation should be made. 1 means yes, 0
2043 means no.  Disabled by default, but local/broadcast address spoofing is always
2044 on.
2045
2046 If you  set this to 1 on a router that is the only connection for a network to
2047 the net,  it  will  prevent  spoofing  attacks  against your internal networks
2048 (external addresses  can  still  be  spoofed), without the need for additional
2049 firewall rules.
2050
2051 secure_redirects
2052 ----------------
2053
2054 Accept ICMP  redirect  messages  only  for gateways, listed in default gateway
2055 list. Enabled by default.
2056
2057 shared_media
2058 ------------
2059
2060 If it  is  not  set  the kernel does not assume that different subnets on this
2061 device can communicate directly. Default setting is 'yes'.
2062
2063 send_redirects
2064 --------------
2065
2066 Determines whether to send ICMP redirects to other hosts.
2067
2068 Routing settings
2069 ----------------
2070
2071 The directory  /proc/sys/net/ipv4/route  contains  several  file  to  control
2072 routing issues.
2073
2074 error_burst and error_cost
2075 --------------------------
2076
2077 These  parameters  are used to limit how many ICMP destination unreachable to 
2078 send  from  the  host  in question. ICMP destination unreachable messages are 
2079 sent  when  we  cannot reach  the next hop while trying to transmit a packet. 
2080 It  will also print some error messages to kernel logs if someone is ignoring 
2081 our   ICMP  redirects.  The  higher  the  error_cost  factor  is,  the  fewer 
2082 destination  unreachable  and error messages will be let through. Error_burst 
2083 controls  when  destination  unreachable  messages and error messages will be
2084 dropped. The default settings limit warning messages to five every second.
2085
2086 flush
2087 -----
2088
2089 Writing to this file results in a flush of the routing cache.
2090
2091 gc_elasticity, gc_interval, gc_min_interval_ms, gc_timeout, gc_thresh
2092 ---------------------------------------------------------------------
2093
2094 Values to  control  the  frequency  and  behavior  of  the  garbage collection
2095 algorithm for the routing cache. gc_min_interval is deprecated and replaced
2096 by gc_min_interval_ms.
2097
2098
2099 max_size
2100 --------
2101
2102 Maximum size  of  the routing cache. Old entries will be purged once the cache
2103 reached has this size.
2104
2105 redirect_load, redirect_number
2106 ------------------------------
2107
2108 Factors which  determine  if  more ICPM redirects should be sent to a specific
2109 host. No  redirects  will be sent once the load limit or the maximum number of
2110 redirects has been reached.
2111
2112 redirect_silence
2113 ----------------
2114
2115 Timeout for redirects. After this period redirects will be sent again, even if
2116 this has been stopped, because the load or number limit has been reached.
2117
2118 Network Neighbor handling
2119 -------------------------
2120
2121 Settings about how to handle connections with direct neighbors (nodes attached
2122 to the same link) can be found in the directory /proc/sys/net/ipv4/neigh.
2123
2124 As we  saw  it  in  the  conf directory, there is a default subdirectory which
2125 holds the  default  values, and one directory for each interface. The contents
2126 of the  directories  are identical, with the single exception that the default
2127 settings contain additional options to set garbage collection parameters.
2128
2129 In the interface directories you'll find the following entries:
2130
2131 base_reachable_time, base_reachable_time_ms
2132 -------------------------------------------
2133
2134 A base  value  used for computing the random reachable time value as specified
2135 in RFC2461.
2136
2137 Expression of base_reachable_time, which is deprecated, is in seconds.
2138 Expression of base_reachable_time_ms is in milliseconds.
2139
2140 retrans_time, retrans_time_ms
2141 -----------------------------
2142
2143 The time between retransmitted Neighbor Solicitation messages.
2144 Used for address resolution and to determine if a neighbor is
2145 unreachable.
2146
2147 Expression of retrans_time, which is deprecated, is in 1/100 seconds (for
2148 IPv4) or in jiffies (for IPv6).
2149 Expression of retrans_time_ms is in milliseconds.
2150
2151 unres_qlen
2152 ----------
2153
2154 Maximum queue  length  for a pending arp request - the number of packets which
2155 are accepted from other layers while the ARP address is still resolved.
2156
2157 anycast_delay
2158 -------------
2159
2160 Maximum for  random  delay  of  answers  to  neighbor solicitation messages in
2161 jiffies (1/100  sec). Not yet implemented (Linux does not have anycast support
2162 yet).
2163
2164 ucast_solicit
2165 -------------
2166
2167 Maximum number of retries for unicast solicitation.
2168
2169 mcast_solicit
2170 -------------
2171
2172 Maximum number of retries for multicast solicitation.
2173
2174 delay_first_probe_time
2175 ----------------------
2176
2177 Delay for  the  first  time  probe  if  the  neighbor  is  reachable.  (see
2178 gc_stale_time)
2179
2180 locktime
2181 --------
2182
2183 An ARP/neighbor  entry  is only replaced with a new one if the old is at least
2184 locktime old. This prevents ARP cache thrashing.
2185
2186 proxy_delay
2187 -----------
2188
2189 Maximum time  (real  time is random [0..proxytime]) before answering to an ARP
2190 request for  which  we have an proxy ARP entry. In some cases, this is used to
2191 prevent network flooding.
2192
2193 proxy_qlen
2194 ----------
2195
2196 Maximum queue length of the delayed proxy arp timer. (see proxy_delay).
2197
2198 app_solicit
2199 ----------
2200
2201 Determines the  number of requests to send to the user level ARP daemon. Use 0
2202 to turn off.
2203
2204 gc_stale_time
2205 -------------
2206
2207 Determines how  often  to  check  for stale ARP entries. After an ARP entry is
2208 stale it  will  be resolved again (which is useful when an IP address migrates
2209 to another  machine).  When  ucast_solicit is greater than 0 it first tries to
2210 send an  ARP  packet  directly  to  the  known  host  When  that  fails  and
2211 mcast_solicit is greater than 0, an ARP request is broadcasted.
2212
2213 2.9 Appletalk
2214 -------------
2215
2216 The /proc/sys/net/appletalk  directory  holds the Appletalk configuration data
2217 when Appletalk is loaded. The configurable parameters are:
2218
2219 aarp-expiry-time
2220 ----------------
2221
2222 The amount  of  time  we keep an ARP entry before expiring it. Used to age out
2223 old hosts.
2224
2225 aarp-resolve-time
2226 -----------------
2227
2228 The amount of time we will spend trying to resolve an Appletalk address.
2229
2230 aarp-retransmit-limit
2231 ---------------------
2232
2233 The number of times we will retransmit a query before giving up.
2234
2235 aarp-tick-time
2236 --------------
2237
2238 Controls the rate at which expires are checked.
2239
2240 The directory  /proc/net/appletalk  holds the list of active Appletalk sockets
2241 on a machine.
2242
2243 The fields  indicate  the DDP type, the local address (in network:node format)
2244 the remote  address,  the  size of the transmit pending queue, the size of the
2245 received queue  (bytes waiting for applications to read) the state and the uid
2246 owning the socket.
2247
2248 /proc/net/atalk_iface lists  all  the  interfaces  configured for appletalk.It
2249 shows the  name  of the interface, its Appletalk address, the network range on
2250 that address  (or  network number for phase 1 networks), and the status of the
2251 interface.
2252
2253 /proc/net/atalk_route lists  each  known  network  route.  It lists the target
2254 (network) that the route leads to, the router (may be directly connected), the
2255 route flags, and the device the route is using.
2256
2257 2.10 IPX
2258 --------
2259
2260 The IPX protocol has no tunable values in proc/sys/net.
2261
2262 The IPX  protocol  does,  however,  provide  proc/net/ipx. This lists each IPX
2263 socket giving  the  local  and  remote  addresses  in  Novell  format (that is
2264 network:node:port). In  accordance  with  the  strange  Novell  tradition,
2265 everything but the port is in hex. Not_Connected is displayed for sockets that
2266 are not  tied to a specific remote address. The Tx and Rx queue sizes indicate
2267 the number  of  bytes  pending  for  transmission  and  reception.  The  state
2268 indicates the  state  the  socket  is  in and the uid is the owning uid of the
2269 socket.
2270
2271 The /proc/net/ipx_interface  file lists all IPX interfaces. For each interface
2272 it gives  the network number, the node number, and indicates if the network is
2273 the primary  network.  It  also  indicates  which  device  it  is bound to (or
2274 Internal for  internal  networks)  and  the  Frame  Type if appropriate. Linux
2275 supports 802.3,  802.2,  802.2  SNAP  and DIX (Blue Book) ethernet framing for
2276 IPX.
2277
2278 The /proc/net/ipx_route  table  holds  a list of IPX routes. For each route it
2279 gives the  destination  network, the router node (or Directly) and the network
2280 address of the router (or Connected) for internal networks.
2281
2282 2.11 /proc/sys/fs/mqueue - POSIX message queues filesystem
2283 ----------------------------------------------------------
2284
2285 The "mqueue"  filesystem provides  the necessary kernel features to enable the
2286 creation of a  user space  library that  implements  the  POSIX message queues
2287 API (as noted by the  MSG tag in the  POSIX 1003.1-2001 version  of the System
2288 Interfaces specification.)
2289
2290 The "mqueue" filesystem contains values for determining/setting  the amount of
2291 resources used by the file system.
2292
2293 /proc/sys/fs/mqueue/queues_max is a read/write  file for  setting/getting  the
2294 maximum number of message queues allowed on the system.
2295
2296 /proc/sys/fs/mqueue/msg_max  is  a  read/write file  for  setting/getting  the
2297 maximum number of messages in a queue value.  In fact it is the limiting value
2298 for another (user) limit which is set in mq_open invocation. This attribute of
2299 a queue must be less or equal then msg_max.
2300
2301 /proc/sys/fs/mqueue/msgsize_max is  a read/write  file for setting/getting the
2302 maximum  message size value (it is every  message queue's attribute set during
2303 its creation).
2304
2305 2.12 /proc/<pid>/oom_adj - Adjust the oom-killer score
2306 ------------------------------------------------------
2307
2308 This file can be used to adjust the score used to select which processes
2309 should be killed in an  out-of-memory  situation.  Giving it a high score will
2310 increase the likelihood of this process being killed by the oom-killer.  Valid
2311 values are in the range -16 to +15, plus the special value -17, which disables
2312 oom-killing altogether for this process.
2313
2314 2.13 /proc/<pid>/oom_score - Display current oom-killer score
2315 -------------------------------------------------------------
2316
2317 ------------------------------------------------------------------------------
2318 This file can be used to check the current score used by the oom-killer is for
2319 any given <pid>. Use it together with /proc/<pid>/oom_adj to tune which
2320 process should be killed in an out-of-memory situation.
2321
2322 ------------------------------------------------------------------------------
2323 Summary
2324 ------------------------------------------------------------------------------
2325 Certain aspects  of  kernel  behavior  can be modified at runtime, without the
2326 need to  recompile  the kernel, or even to reboot the system. The files in the
2327 /proc/sys tree  can  not only be read, but also modified. You can use the echo
2328 command to write value into these files, thereby changing the default settings
2329 of the kernel.
2330 ------------------------------------------------------------------------------
2331
2332 2.14  /proc/<pid>/io - Display the IO accounting fields
2333 -------------------------------------------------------
2334
2335 This file contains IO statistics for each running process
2336
2337 Example
2338 -------
2339
2340 test:/tmp # dd if=/dev/zero of=/tmp/test.dat &
2341 [1] 3828
2342
2343 test:/tmp # cat /proc/3828/io
2344 rchar: 323934931
2345 wchar: 323929600
2346 syscr: 632687
2347 syscw: 632675
2348 read_bytes: 0
2349 write_bytes: 323932160
2350 cancelled_write_bytes: 0
2351
2352
2353 Description
2354 -----------
2355
2356 rchar
2357 -----
2358
2359 I/O counter: chars read
2360 The number of bytes which this task has caused to be read from storage. This
2361 is simply the sum of bytes which this process passed to read() and pread().
2362 It includes things like tty IO and it is unaffected by whether or not actual
2363 physical disk IO was required (the read might have been satisfied from
2364 pagecache)
2365
2366
2367 wchar
2368 -----
2369
2370 I/O counter: chars written
2371 The number of bytes which this task has caused, or shall cause to be written
2372 to disk. Similar caveats apply here as with rchar.
2373
2374
2375 syscr
2376 -----
2377
2378 I/O counter: read syscalls
2379 Attempt to count the number of read I/O operations, i.e. syscalls like read()
2380 and pread().
2381
2382
2383 syscw
2384 -----
2385
2386 I/O counter: write syscalls
2387 Attempt to count the number of write I/O operations, i.e. syscalls like
2388 write() and pwrite().
2389
2390
2391 read_bytes
2392 ----------
2393
2394 I/O counter: bytes read
2395 Attempt to count the number of bytes which this process really did cause to
2396 be fetched from the storage layer. Done at the submit_bio() level, so it is
2397 accurate for block-backed filesystems. <please add status regarding NFS and
2398 CIFS at a later time>
2399
2400
2401 write_bytes
2402 -----------
2403
2404 I/O counter: bytes written
2405 Attempt to count the number of bytes which this process caused to be sent to
2406 the storage layer. This is done at page-dirtying time.
2407
2408
2409 cancelled_write_bytes
2410 ---------------------
2411
2412 The big inaccuracy here is truncate. If a process writes 1MB to a file and
2413 then deletes the file, it will in fact perform no writeout. But it will have
2414 been accounted as having caused 1MB of write.
2415 In other words: The number of bytes which this process caused to not happen,
2416 by truncating pagecache. A task can cause "negative" IO too. If this task
2417 truncates some dirty pagecache, some IO which another task has been accounted
2418 for (in it's write_bytes) will not be happening. We _could_ just subtract that
2419 from the truncating task's write_bytes, but there is information loss in doing
2420 that.
2421
2422
2423 Note
2424 ----
2425
2426 At its current implementation state, this is a bit racy on 32-bit machines: if
2427 process A reads process B's /proc/pid/io while process B is updating one of
2428 those 64-bit counters, process A could see an intermediate result.
2429
2430
2431 More information about this can be found within the taskstats documentation in
2432 Documentation/accounting.
2433
2434 2.15 /proc/<pid>/coredump_filter - Core dump filtering settings
2435 ---------------------------------------------------------------
2436 When a process is dumped, all anonymous memory is written to a core file as
2437 long as the size of the core file isn't limited. But sometimes we don't want
2438 to dump some memory segments, for example, huge shared memory. Conversely,
2439 sometimes we want to save file-backed memory segments into a core file, not
2440 only the individual files.
2441
2442 /proc/<pid>/coredump_filter allows you to customize which memory segments
2443 will be dumped when the <pid> process is dumped. coredump_filter is a bitmask
2444 of memory types. If a bit of the bitmask is set, memory segments of the
2445 corresponding memory type are dumped, otherwise they are not dumped.
2446
2447 The following 7 memory types are supported:
2448   - (bit 0) anonymous private memory
2449   - (bit 1) anonymous shared memory
2450   - (bit 2) file-backed private memory
2451   - (bit 3) file-backed shared memory
2452   - (bit 4) ELF header pages in file-backed private memory areas (it is
2453             effective only if the bit 2 is cleared)
2454   - (bit 5) hugetlb private memory
2455   - (bit 6) hugetlb shared memory
2456
2457   Note that MMIO pages such as frame buffer are never dumped and vDSO pages
2458   are always dumped regardless of the bitmask status.
2459
2460   Note bit 0-4 doesn't effect any hugetlb memory. hugetlb memory are only
2461   effected by bit 5-6.
2462
2463 Default value of coredump_filter is 0x23; this means all anonymous memory
2464 segments and hugetlb private memory are dumped.
2465
2466 If you don't want to dump all shared memory segments attached to pid 1234,
2467 write 0x21 to the process's proc file.
2468
2469   $ echo 0x21 > /proc/1234/coredump_filter
2470
2471 When a new process is created, the process inherits the bitmask status from its
2472 parent. It is useful to set up coredump_filter before the program runs.
2473 For example:
2474
2475   $ echo 0x7 > /proc/self/coredump_filter
2476   $ ./some_program
2477
2478 2.16    /proc/<pid>/mountinfo - Information about mounts
2479 --------------------------------------------------------
2480
2481 This file contains lines of the form:
2482
2483 36 35 98:0 /mnt1 /mnt2 rw,noatime master:1 - ext3 /dev/root rw,errors=continue
2484 (1)(2)(3)   (4)   (5)      (6)      (7)   (8) (9)   (10)         (11)
2485
2486 (1) mount ID:  unique identifier of the mount (may be reused after umount)
2487 (2) parent ID:  ID of parent (or of self for the top of the mount tree)
2488 (3) major:minor:  value of st_dev for files on filesystem
2489 (4) root:  root of the mount within the filesystem
2490 (5) mount point:  mount point relative to the process's root
2491 (6) mount options:  per mount options
2492 (7) optional fields:  zero or more fields of the form "tag[:value]"
2493 (8) separator:  marks the end of the optional fields
2494 (9) filesystem type:  name of filesystem of the form "type[.subtype]"
2495 (10) mount source:  filesystem specific information or "none"
2496 (11) super options:  per super block options
2497
2498 Parsers should ignore all unrecognised optional fields.  Currently the
2499 possible optional fields are:
2500
2501 shared:X  mount is shared in peer group X
2502 master:X  mount is slave to peer group X
2503 propagate_from:X  mount is slave and receives propagation from peer group X (*)
2504 unbindable  mount is unbindable
2505
2506 (*) X is the closest dominant peer group under the process's root.  If
2507 X is the immediate master of the mount, or if there's no dominant peer
2508 group under the same root, then only the "master:X" field is present
2509 and not the "propagate_from:X" field.
2510
2511 For more information on mount propagation see:
2512
2513   Documentation/filesystems/sharedsubtree.txt
2514
2515 2.17    /proc/sys/fs/epoll - Configuration options for the epoll interface
2516 --------------------------------------------------------
2517
2518 This directory contains configuration options for the epoll(7) interface.
2519
2520 max_user_instances
2521 ------------------
2522
2523 This is the maximum number of epoll file descriptors that a single user can
2524 have open at a given time. The default value is 128, and should be enough
2525 for normal users.
2526
2527 max_user_watches
2528 ----------------
2529
2530 Every epoll file descriptor can store a number of files to be monitored
2531 for event readiness. Each one of these monitored files constitutes a "watch".
2532 This configuration option sets the maximum number of "watches" that are
2533 allowed for each user.
2534 Each "watch" costs roughly 90 bytes on a 32bit kernel, and roughly 160 bytes
2535 on a 64bit one.
2536 The current default value for  max_user_watches  is the 1/32 of the available
2537 low memory, divided for the "watch" cost in bytes.
2538
2539
2540 ------------------------------------------------------------------------------
2541