码迷,mamicode.com
首页 > 系统相关 > 详细

【转】刚发现一个linux在线文档库。很好很强大。

时间:2015-01-20 10:20:46      阅读:479      评论:0      收藏:0      [点我收藏+]

标签:

原文网址:http://blog.csdn.net/longxibendi/article/details/6048231

1.网址: http://www.mjmwired.net 

 

2.比如查看这个 proc.txt ,就在这里能找到。

http://www.mjmwired.net/kernel/Documentation/filesystems/proc.txt

 

内核参数解释全在这里了。不过,也可以下载内核完源代码,从/usr/src/linux/Documentation/proc.txt查看

下载内核从http://www.kernel.org/pub/linux/kernel/v2.6/

解压完后从这里打开:

linux-2.6.28/Documentation/filesystems/proc.txt    

 

3.此外,在filesystems下还有很多文档,比如ext4.txt,很详细,很全面,很有用。

 

4.这里提供一个2.6.28的完整proc.txt文档

注意linux系统管理技术手册 第二版   说的是  proc.txt  在  /usr/src/linux/Documentation/proc.txt  ,具体问题,具体分析吧。

 

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

 

【转】刚发现一个linux在线文档库。很好很强大。

标签:

原文地址:http://www.cnblogs.com/wi100sh/p/4235305.html

(0)
(0)
   
举报
评论 一句话评论(0
登录后才能评论!
© 2014 mamicode.com 版权所有  联系我们:gaon5@hotmail.com
迷上了代码!