zoukankan      html  css  js  c++  java

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

    原文网址：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. A 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. X 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. ------------------------------------------------------------------------------  
  • 相关阅读:
    git ssh keys
    git 修改 email
    git 撤销commit
    企微调试模式
    ORACLE 根据某个字段固定值进行分区
    Apache FtpClient login失败
    Oracle序列
    Oracle merage into
    Oracle all_tables 以及常用sql
    性能优化-使用高性能的库fastutil
  • 原文地址：https://www.cnblogs.com/wi100sh/p/4235305.html
Copyright © 2011-2022 走看看