开通博客赚积分
发布资源赚积分
分类

源码开发语言/平台
当前位置：首页 > 源码/资料 > 嵌入式/单片机编程 > 嵌入式Linux > 查看源码
proc.txt
资源名称：SBC-2410X_kernel.tar.gz　[点击查看]
上传用户：lgb322
上传日期：2013-02-24
资源大小：30529k
文件大小：70k
源码类别：

嵌入式Linux

开发平台：

Unix_Linux

proc.txt：源码内容
  1. ------------------------------------------------------------------------------
  2.                        T H E  /proc   F I L E S Y S T E M
  3. ------------------------------------------------------------------------------
  4. /proc/sys         Terrehon Bowden <terrehon@pacbell.net>        October 7 1999
  5.                   Bodo Bauer <bb@ricochet.net>
  7. 2.4.x update   Jorge Nerin <comandante@zaralinux.com>      November 14 2000
  8. ------------------------------------------------------------------------------
  9. Version 1.3                                              Kernel version 2.2.12
  10.       Kernel version 2.4.0-test11-pre4
  11. ------------------------------------------------------------------------------
  13. Table of Contents
  14. -----------------
  16.   0     Preface
  17.   0.1 Introduction/Credits
  18.   0.2 Legal Stuff
  20.   1 Collecting System Information
  21.   1.1 Process-Specific Subdirectories
  22.   1.2 Kernel data
  23.   1.3 IDE devices in /proc/ide
  24.   1.4 Networking info in /proc/net
  25.   1.5 SCSI info
  26.   1.6 Parallel port info in /proc/parport
  27.   1.7 TTY info in /proc/tty
  29.   2 Modifying System Parameters
  30.   2.1 /proc/sys/fs - File system data
  31.   2.2 /proc/sys/fs/binfmt_misc - Miscellaneous binary formats
  32.   2.3 /proc/sys/kernel - general kernel parameters
  33.   2.4 /proc/sys/vm - The virtual memory subsystem
  34.   2.5 /proc/sys/dev - Device specific parameters
  35.   2.6 /proc/sys/sunrpc - Remote procedure calls
  36.   2.7 /proc/sys/net - Networking stuff
  37.   2.8 /proc/sys/net/ipv4 - IPV4 settings
  38.   2.9 Appletalk
  39.   2.10 IPX
  41. ------------------------------------------------------------------------------
  42. Preface
  43. ------------------------------------------------------------------------------
  45. 0.1 Introduction/Credits
  46. ------------------------
  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, APX, 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.
  61. We'd like  to  thank Alan Cox, Rik van Riel, and Alexey Kuznetsov and a lot of
  62. other people for help compiling this documentation. We'd also like to extend a
  63. special thank  you to Andi Kleen for documentation, which we relied on heavily
  64. to create  this  document,  as well as the additional information he provided.
  65. Thanks to  everybody  else  who contributed source or docs to the Linux kernel
  66. and helped create a great piece of software... :)
  68. If you  have  any comments, corrections or additions, please don't hesitate to
  69. contact Bodo  Bauer  at  bb@ricochet.net.  We'll  be happy to add them to this
  70. document.
  72. The   latest   version    of   this   document   is    available   online   at
  73. http://skaro.nightcrawler.com/~bb/Docs/Proc as HTML version.
  75. If  the above  direction does  not works  for you,  ypu could  try the  kernel
  76. mailing  list  at  linux-kernel@vger.kernel.org  and/or try  to  reach  me  at
  77. comandante@zaralinux.com.
  79. 0.2 Legal Stuff
  80. ---------------
  82. We don't  guarantee  the  correctness  of this document, and if you come to us
  83. complaining about  how  you  screwed  up  your  system  because  of  incorrect
  84. documentation, we won't feel responsible...
  86. ------------------------------------------------------------------------------
  87. CHAPTER 1: COLLECTING SYSTEM INFORMATION
  88. ------------------------------------------------------------------------------
  90. ------------------------------------------------------------------------------
  91. In This Chapter
  92. ------------------------------------------------------------------------------
  93. * Investigating  the  properties  of  the  pseudo  file  system  /proc and its
  94.   ability to provide information on the running Linux system
  95. * Examining /proc's structure
  96. * Uncovering  various  information  about the kernel and the processes running
  97.   on the system
  98. ------------------------------------------------------------------------------
  101. The proc  file  system acts as an interface to internal data structures in the
  102. kernel. It  can  be  used to obtain information about the system and to change
  103. certain kernel parameters at runtime (sysctl).
  105. First, we'll  take  a  look  at the read-only parts of /proc. In Chapter 2, we
  106. show you how you can use /proc/sys to change settings.
  108. 1.1 Process-Specific Subdirectories
  109. -----------------------------------
  111. The directory  /proc  contains  (among other things) one subdirectory for each
  112. process running on the system, which is named after the process ID (PID).
  114. The link  self  points  to  the  process reading the file system. Each process
  115. subdirectory has the entries listed in Table 1-1.
  118. Table 1-1: Process specific entries in /proc 
  119. ..............................................................................
  120.  File    Content                                        
  121.  cmdline Command line arguments                         
  122.  cpu  Current and last cpu in wich it was executed (2.4)(smp)
  123.  cwd  Link to the current working directory
  124.  environ Values of environment variables      
  125.  exe  Link to the executable of this process
  126.  fd      Directory, which contains all file descriptors 
  127.  maps  Memory maps to executables and library files (2.4)
  128.  mem     Memory held by this process                    
  129.  root  Link to the root directory of this process
  130.  stat    Process status                                 
  131.  statm   Process memory status information              
  132.  status  Process status in human readable form          
  133. ..............................................................................
  135. For example, to get the status information of a process, all you have to do is
  136. read the file /proc/PID/status:
  138.   >cat /proc/self/status 
  139.   Name:   cat 
  140.   State:  R (running) 
  141.   Pid:    5452 
  142.   PPid:   743 
  143.   TracerPid:      0 (2.4)
  144.   Uid:    501     501     501     501 
  145.   Gid:    100     100     100     100 
  146.   Groups: 100 14 16 
  147.   VmSize:     1112 kB 
  148.   VmLck:         0 kB 
  149.   VmRSS:       348 kB 
  150.   VmData:       24 kB 
  151.   VmStk:        12 kB 
  152.   VmExe:         8 kB 
  153.   VmLib:      1044 kB 
  154.   SigPnd: 0000000000000000 
  155.   SigBlk: 0000000000000000 
  156.   SigIgn: 0000000000000000 
  157.   SigCgt: 0000000000000000 
  158.   CapInh: 00000000fffffeff 
  159.   CapPrm: 0000000000000000 
  160.   CapEff: 0000000000000000 
  163. This shows you nearly the same information you would get if you viewed it with
  164. the ps  command.  In  fact,  ps  uses  the  proc  file  system  to  obtain its
  165. information. The  statm  file  contains  more  detailed  information about the
  166. process memory usage. Its seven fields are explained in Table 1-2.
  169. Table 1-2: Contents of the statm files 
  170. ..............................................................................
  171.  File     Content                         
  172.  size     total program size              
  173.  resident size of memory portions         
  174.  shared   number of pages that are shared 
  175.  trs      number of pages that are 'code' 
  176.  drs      number of pages of data/stack   
  177.  lrs      number of pages of library      
  178.  dt       number of dirty pages           
  179. ..............................................................................
  181. 1.2 Kernel data
  182. ---------------
  184. Similar to  the  process entries, the kernel data files give information about
  185. the running kernel. The files used to obtain this information are contained in
  186. /proc and  are  listed  in Table 1-3. Not all of these will be present in your
  187. system. It  depends  on the kernel configuration and the loaded modules, which
  188. files are there, and which are missing.
  190. Table 1-3: Kernel info in /proc 
  191. ..............................................................................
  192.  File        Content                                           
  193.  apm         Advanced power management info                    
  194.  bus         Directory containing bus specific information     
  195.  cmdline     Kernel command line                               
  196.  cpuinfo     Info about the CPU                                
  197.  devices     Available devices (block and character)           
  198.  dma         Used DMS channels                                 
  199.  filesystems Supported filesystems                             
  200.  driver      Various drivers grouped here, currently rtc (2.4)
  201.  execdomains Execdomains, related to security (2.4)
  202.  fb      Frame Buffer devices (2.4)
  203.  fs      File system parameters, currently nfs/exports (2.4)
  204.  ide         Directory containing info about the IDE subsystem 
  205.  interrupts  Interrupt usage                                   
  206.  iomem      Memory map (2.4)
  207.  ioports     I/O port usage                                    
  208.  irq      Masks for irq to cpu affinity (2.4)(smp?)
  209.  isapnp      ISA PnP (Plug&Play) Info (2.4)
  210.  kcore       Kernel core image (can be ELF or A.OUT(deprecated in 2.4))   
  211.  kmsg        Kernel messages                                   
  212.  ksyms       Kernel symbol table                               
  213.  loadavg     Load average of last 1, 5 & 15 minutes                
  214.  locks       Kernel locks                                      
  215.  meminfo     Memory info                                       
  216.  misc        Miscellaneous                                     
  217.  modules     List of loaded modules                            
  218.  mounts      Mounted filesystems                               
  219.  net         Networking info (see text)                        
  220.  partitions  Table of partitions known to the system           
  221.  pci      Depreciated info of PCI bus (new way -> /proc/bus/pci/, 
  222.              decoupled by lspci (2.4)
  223.  rtc         Real time clock                                   
  224.  scsi        SCSI info (see text)                              
  225.  slabinfo    Slab pool info                                    
  226.  stat        Overall statistics                                
  227.  swaps       Swap space utilization                            
  228.  sys         See chapter 2                                     
  229.  sysvipc     Info of SysVIPC Resources (msg, sem, shm) (2.4)
  230.  tty      Info of tty drivers
  231.  uptime      System uptime                                     
  232.  version     Kernel version                                    
  233.  video      bttv info of video resources (2.4)
  234. ..............................................................................
  236. You can,  for  example,  check  which interrupts are currently in use and what
  237. they are used for by looking in the file /proc/interrupts:
  239.   > cat /proc/interrupts 
  240.              CPU0        
  241.     0:    8728810          XT-PIC  timer 
  242.     1:        895          XT-PIC  keyboard 
  243.     2:          0          XT-PIC  cascade 
  244.     3:     531695          XT-PIC  aha152x 
  245.     4:    2014133          XT-PIC  serial 
  246.     5:      44401          XT-PIC  pcnet_cs 
  247.     8:          2          XT-PIC  rtc 
  248.    11:          8          XT-PIC  i82365 
  249.    12:     182918          XT-PIC  PS/2 Mouse 
  250.    13:          1          XT-PIC  fpu 
  251.    14:    1232265          XT-PIC  ide0 
  252.    15:          7          XT-PIC  ide1 
  253.   NMI:          0 
  255. In 2.4.* a couple of lines where added to this file LOC & ERR (this time is the
  256. output of a SMP machine):
  258.   > cat /proc/interrupts 
  260.              CPU0       CPU1       
  261.     0:    1243498    1214548    IO-APIC-edge  timer
  262.     1:       8949       8958    IO-APIC-edge  keyboard
  263.     2:          0          0          XT-PIC  cascade
  264.     5:      11286      10161    IO-APIC-edge  soundblaster
  265.     8:          1          0    IO-APIC-edge  rtc
  266.     9:      27422      27407    IO-APIC-edge  3c503
  267.    12:     113645     113873    IO-APIC-edge  PS/2 Mouse
  268.    13:          0          0          XT-PIC  fpu
  269.    14:      22491      24012    IO-APIC-edge  ide0
  270.    15:       2183       2415    IO-APIC-edge  ide1
  271.    17:      30564      30414   IO-APIC-level  eth0
  272.    18:        177        164   IO-APIC-level  bttv
  273.   NMI:    2457961    2457959 
  274.   LOC:    2457882    2457881 
  275.   ERR:       2155
  277. NMI is incremented in this case because every timer interrupt generates a NMI
  278. (Non Maskable Interrupt) which is used by the NMI Watchdog to detect lookups.
  280. LOC is the local interrupt counter of the internal APIC of every CPU.
  282. ERR is incremented in the case of errors in the IO-APIC bus (the bus that
  283. connects the CPUs in a SMP system. This means that an error has been detected,
  284. the IO-APIC automatically retry the transmission, so it should not be a big
  285. problem, but you should read the SMP-FAQ.
  287. In this context it could be interesting to note the new irq directory in 2.4.
  288. It could be used to set IRQ to CPU affinity, this means that you can "hook" an
  289. IRQ to only one CPU, or to exclude a CPU of handling IRQs. The contents of the
  290. irq subdir is one subdir for each IRQ, and one file; prof_cpu_mask
  292. For example 
  293.   > ls /proc/irq/
  294.   0  10  12  14  16  18  2  4  6  8  prof_cpu_mask
  295.   1  11  13  15  17  19  3  5  7  9
  296.   > ls /proc/irq/0/
  297.   smp_affinity
  299. The contents of the prof_cpu_mask file and each smp_affinity file for each IRQ
  300. is the same by default:
  302.   > cat /proc/irq/0/smp_affinity 
  303.   ffffffff
  305. It's a bitmask, in wich you can specify wich CPUs can handle the IRQ, you can
  306. set it by doing:
  308.   > echo 1 > /proc/irq/prof_cpu_mask
  310. This means that only the first CPU will handle the IRQ, but you can also echo 5
  311. wich means that only the first and fourth CPU can handle the IRQ.
  313. The way IRQs are routed is handled by the IO-APIC, and it's Round Robin
  314. between all the CPUs which are allowed to handle it. As usual the kernel has
  315. more info than you and does a better job than you, so the defaults are the
  316. best choice for almost everyone.
  318. There are  three  more  important subdirectories in /proc: net, scsi, and sys.
  319. The general  rule  is  that  the  contents,  or  even  the  existence of these
  320. directories, depend  on your kernel configuration. If SCSI is not enabled, the
  321. directory scsi  may  not  exist. The same is true with the net, which is there
  322. only when networking support is present in the running kernel.
  324. The slabinfo  file  gives  information  about  memory usage at the slab level.
  325. Linux uses  slab  pools for memory management above page level in version 2.2.
  326. Commonly used  objects  have  their  own  slab  pool (such as network buffers,
  327. directory cache, and so on).
  329. 1.3 IDE devices in /proc/ide
  330. ----------------------------
  332. The subdirectory /proc/ide contains information about all IDE devices of which
  333. the kernel  is  aware.  There is one subdirectory for each IDE controller, the
  334. file drivers  and a link for each IDE device, pointing to the device directory
  335. in the controller specific subtree.
  337. The file  drivers  contains general information about the drivers used for the
  338. IDE devices:
  340.   > cat /proc/ide/drivers 
  341.   ide-cdrom version 4.53 
  342.   ide-disk version 1.08 
  345. More detailed  information  can  be  found  in  the  controller  specific
  346. subdirectories. These  are  named  ide0,  ide1  and  so  on.  Each  of  these
  347. directories contains the files shown in table 1-4.
  350. Table 1-4: IDE controller info in  /proc/ide/ide? 
  351. ..............................................................................
  352.  File    Content                                 
  353.  channel IDE channel (0 or 1)                    
  354.  config  Configuration (only for PCI/IDE bridge) 
  355.  mate    Mate name                               
  356.  model   Type/Chipset of IDE controller          
  357. ..............................................................................
  359. Each device  connected  to  a  controller  has  a separate subdirectory in the
  360. controllers directory.  The  files  listed in table 1-5 are contained in these
  361. directories.
  364. Table 1-5: IDE device information 
  365. ..............................................................................
  366.  File             Content                                    
  367.  cache            The cache                                  
  368.  capacity         Capacity of the medium (in 512Byte blocks) 
  369.  driver           driver and version                         
  370.  geometry         physical and logical geometry              
  371.  identify         device identify block                      
  372.  media            media type                                 
  373.  model            device identifier                          
  374.  settings         device setup                               
  375.  smart_thresholds IDE disk management thresholds             
  376.  smart_values     IDE disk management values                 
  377. ..............................................................................
  379. The most  interesting  file is settings. This file contains a nice overview of
  380. the drive parameters:
  382.   # cat /proc/ide/ide0/hda/settings 
  383.   name                    value           min             max             mode 
  384.   ----                    -----           ---             ---             ---- 
  385.   bios_cyl                526             0               65535           rw 
  386.   bios_head               255             0               255             rw 
  387.   bios_sect               63              0               63              rw 
  388.   breada_readahead        4               0               127             rw 
  389.   bswap                   0               0               1               r 
  390.   file_readahead          72              0               2097151         rw 
  391.   io_32bit                0               0               3               rw 
  392.   keepsettings            0               0               1               rw 
  393.   max_kb_per_request      122             1               127             rw 
  394.   multcount               0               0               8               rw 
  395.   nice1                   1               0               1               rw 
  396.   nowerr                  0               0               1               rw 
  397.   pio_mode                write-only      0               255             w 
  398.   slow                    0               0               1               rw 
  399.   unmaskirq               0               0               1               rw 
  400.   using_dma               0               0               1               rw 
  403. 1.4 Networking info in /proc/net
  404. --------------------------------
  406. The subdirectory  /proc/net  follows  the  usual  pattern. Table 1-6 shows the
  407. additional values  you  get  for  IP  version 6 if you configure the kernel to
  408. support this. Table 1-7 lists the files and their meaning.
  411. Table 1-6: IPv6 info in /proc/net 
  412. ..............................................................................
  413.  File       Content                                               
  414.  udp6       UDP sockets (IPv6)                                    
  415.  tcp6       TCP sockets (IPv6)                                    
  416.  raw6       Raw device statistics (IPv6)                          
  417.  igmp6      IP multicast addresses, which this host joined (IPv6) 
  418.  if_inet6   List of IPv6 interface addresses                      
  419.  ipv6_route Kernel routing table for IPv6                         
  420.  rt6_stats  Global IPv6 routing tables statistics                 
  421.  sockstat6  Socket statistics (IPv6)                              
  422.  snmp6      Snmp data (IPv6)                                      
  423. ..............................................................................
  426. Table 1-7: Network info in /proc/net 
  427. ..............................................................................
  428.  File          Content                                                         
  429.  arp           Kernel  ARP table                                               
  430.  dev           network devices with statistics                                 
  431.  dev_mcast     the Layer2 multicast groups a device is listening too
  432.                (interface index, label, number of references, number of bound
  433.                addresses). 
  434.  dev_stat      network device status                                           
  435.  ip_fwchains   Firewall chain linkage                                          
  436.  ip_fwnames    Firewall chain names                                            
  437.  ip_masq       Directory containing the masquerading tables                    
  438.  ip_masquerade Major masquerading table                                        
  439.  netstat       Network statistics                                              
  440.  raw           raw device statistics                                           
  441.  route         Kernel routing table                                            
  442.  rpc           Directory containing rpc info                                   
  443.  rt_cache      Routing cache                                                   
  444.  snmp          SNMP data                                                       
  445.  sockstat      Socket statistics                                               
  446.  tcp           TCP  sockets                                                    
  447.  tr_rif        Token ring RIF routing table                                    
  448.  udp           UDP sockets                                                     
  449.  unix          UNIX domain sockets                                             
  450.  wireless      Wireless interface data (Wavelan etc)                           
  451.  igmp          IP multicast addresses, which this host joined                  
  452.  psched        Global packet scheduler parameters.                             
  453.  netlink       List of PF_NETLINK sockets                                      
  454.  ip_mr_vifs    List of multicast virtual interfaces                            
  455.  ip_mr_cache   List of multicast routing cache                                 
  456. ..............................................................................
  458. You can  use  this  information  to see which network devices are available in
  459. your system and how much traffic was routed over those devices:
  461.   > cat /proc/net/dev 
  462.   Inter-|Receive                                                   |[... 
  463.    face |bytes    packets errs drop fifo frame compressed multicast|[... 
  464.       lo:  908188   5596     0    0    0     0          0         0 [...         
  465.     ppp0:15475140  20721   410    0    0   410          0         0 [...  
  466.     eth0:  614530   7085     0    0    0     0          0         1 [... 
  467.    
  468.   ...] Transmit 
  469.   ...] bytes    packets errs drop fifo colls carrier compressed 
  470.   ...]  908188     5596    0    0    0     0       0          0 
  471.   ...] 1375103    17405    0    0    0     0       0          0 
  472.   ...] 1703981     5535    0    0    0     3       0          0 
  474. In addition, each Channel Bond interface has it's own directory.  For
  475. example, the bond0 device will have a directory called /proc/net/bond0/.
  476. It will contain information that is specific to that bond, such as the
  477. current slaves of the bond, the link status of the slaves, and how
  478. many times the slaves link has failed.
  480. 1.5 SCSI info
  481. -------------
  483. If you  have  a  SCSI  host adapter in your system, you'll find a subdirectory
  484. named after  the driver for this adapter in /proc/scsi. You'll also see a list
  485. of all recognized SCSI devices in /proc/scsi:
  487.   >cat /proc/scsi/scsi 
  488.   Attached devices: 
  489.   Host: scsi0 Channel: 00 Id: 00 Lun: 00 
  490.     Vendor: IBM      Model: DGHS09U          Rev: 03E0 
  491.     Type:   Direct-Access                    ANSI SCSI revision: 03 
  492.   Host: scsi0 Channel: 00 Id: 06 Lun: 00 
  493.     Vendor: PIONEER  Model: CD-ROM DR-U06S   Rev: 1.04 
  494.     Type:   CD-ROM                           ANSI SCSI revision: 02 
  497. The directory  named  after  the driver has one file for each adapter found in
  498. the system.  These  files  contain information about the controller, including
  499. the used  IRQ  and  the  IO  address range. The amount of information shown is
  500. dependent on  the adapter you use. The example shows the output for an Adaptec
  501. AHA-2940 SCSI adapter:
  503.   > cat /proc/scsi/aic7xxx/0 
  504.    
  505.   Adaptec AIC7xxx driver version: 5.1.19/3.2.4 
  506.   Compile Options: 
  507.     TCQ Enabled By Default : Disabled 
  508.     AIC7XXX_PROC_STATS     : Disabled 
  509.     AIC7XXX_RESET_DELAY    : 5 
  510.   Adapter Configuration: 
  511.              SCSI Adapter: Adaptec AHA-294X Ultra SCSI host adapter 
  512.                              Ultra Wide Controller 
  513.       PCI MMAPed I/O Base: 0xeb001000 
  514.    Adapter SEEPROM Config: SEEPROM found and used. 
  515.         Adaptec SCSI BIOS: Enabled 
  516.                       IRQ: 10 
  517.                      SCBs: Active 0, Max Active 2, 
  518.                            Allocated 15, HW 16, Page 255 
  519.                Interrupts: 160328 
  520.         BIOS Control Word: 0x18b6 
  521.      Adapter Control Word: 0x005b 
  522.      Extended Translation: Enabled 
  523.   Disconnect Enable Flags: 0xffff 
  524.        Ultra Enable Flags: 0x0001 
  525.    Tag Queue Enable Flags: 0x0000 
  526.   Ordered Queue Tag Flags: 0x0000 
  527.   Default Tag Queue Depth: 8 
  528.       Tagged Queue By Device array for aic7xxx host instance 0: 
  529.         {255,255,255,255,255,255,255,255,255,255,255,255,255,255,255,255} 
  530.       Actual queue depth per device for aic7xxx host instance 0: 
  531.         {1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1} 
  532.   Statistics: 
  533.   (scsi0:0:0:0) 
  534.     Device using Wide/Sync transfers at 40.0 MByte/sec, offset 8 
  535.     Transinfo settings: current(12/8/1/0), goal(12/8/1/0), user(12/15/1/0) 
  536.     Total transfers 160151 (74577 reads and 85574 writes) 
  537.   (scsi0:0:6:0) 
  538.     Device using Narrow/Sync transfers at 5.0 MByte/sec, offset 15 
  539.     Transinfo settings: current(50/15/0/0), goal(50/15/0/0), user(50/15/0/0) 
  540.     Total transfers 0 (0 reads and 0 writes) 
  543. 1.6 Parallel port info in /proc/parport
  544. ---------------------------------------
  546. The directory  /proc/parport  contains information about the parallel ports of
  547. your system.  It  has  one  subdirectory  for  each port, named after the port
  548. number (0,1,2,...).
  550. These directories contain the four files shown in Table 1-8.
  553. Table 1-8: Files in /proc/parport 
  554. ..............................................................................
  555.  File      Content                                                             
  556.  autoprobe Any IEEE-1284 device ID information that has been acquired.         
  557.  devices   list of the device drivers using that port. A + will appear by the
  558.            name of the device currently using the port (it might not appear
  559.            against any). 
  560.  hardware  Parallel port's base address, IRQ line and DMA channel.             
  561.  irq       IRQ that parport is using for that port. This is in a separate
  562.            file to allow you to alter it by writing a new value in (IRQ
  563.            number or none). 
  564. ..............................................................................
  566. 1.7 TTY info in /proc/tty
  567. -------------------------
  569. Information about  the  available  and actually used tty's can be found in the
  570. directory /proc/tty.You'll  find  entries  for drivers and line disciplines in
  571. this directory, as shown in Table 1-9.
  574. Table 1-9: Files in /proc/tty 
  575. ..............................................................................
  576.  File          Content                                        
  577.  drivers       list of drivers and their usage                
  578.  ldiscs        registered line disciplines                    
  579.  driver/serial usage statistic and status of single tty lines 
  580. ..............................................................................
  582. To see  which  tty's  are  currently in use, you can simply look into the file
  583. /proc/tty/drivers:
  585.   > cat /proc/tty/drivers 
  586.   pty_slave            /dev/pts      136   0-255 pty:slave 
  587.   pty_master           /dev/ptm      128   0-255 pty:master 
  588.   pty_slave            /dev/ttyp       3   0-255 pty:slave 
  589.   pty_master           /dev/pty        2   0-255 pty:master 
  590.   serial               /dev/cua        5   64-67 serial:callout 
  591.   serial               /dev/ttyS       4   64-67 serial 
  592.   /dev/tty0            /dev/tty0       4       0 system:vtmaster 
  593.   /dev/ptmx            /dev/ptmx       5       2 system 
  594.   /dev/console         /dev/console    5       1 system:console 
  595.   /dev/tty             /dev/tty        5       0 system:/dev/tty 
  596.   unknown              /dev/tty        4    1-63 console 
  599. ------------------------------------------------------------------------------
  600. Summary
  601. ------------------------------------------------------------------------------
  602. The /proc file system serves information about the running system. It not only
  603. allows access to process data but also allows you to request the kernel status
  604. by reading files in the hierarchy.
  606. The directory  structure  of /proc reflects the types of information and makes
  607. it easy, if not obvious, where to look for specific data.
  608. ------------------------------------------------------------------------------
  610. ------------------------------------------------------------------------------
  611. CHAPTER 2: MODIFYING SYSTEM PARAMETERS
  612. ------------------------------------------------------------------------------
  614. ------------------------------------------------------------------------------
  615. In This Chapter
  616. ------------------------------------------------------------------------------
  617. * Modifying kernel parameters by writing into files found in /proc/sys
  618. * Exploring the files which modify certain parameters
  619. * Review of the /proc/sys file tree
  620. ------------------------------------------------------------------------------
  623. A very  interesting part of /proc is the directory /proc/sys. This is not only
  624. a source  of  information,  it also allows you to change parameters within the
  625. kernel. Be  very  careful  when attempting this. You can optimize your system,
  626. but you  can  also  cause  it  to  crash.  Never  alter kernel parameters on a
  627. production system.  Set  up  a  development machine and test to make sure that
  628. everything works  the  way  you want it to. You may have no alternative but to
  629. reboot the machine once an error has been made.
  631. To change  a  value,  simply  echo  the new value into the file. An example is
  632. given below  in the section on the file system data. You need to be root to do
  633. this. You  can  create  your  own  boot script to perform this every time your
  634. system boots.
  636. The files  in /proc/sys can be used to fine tune and monitor miscellaneous and
  637. general things  in  the operation of the Linux kernel. Since some of the files
  638. can inadvertently  disrupt  your  system,  it  is  advisable  to  read  both
  639. documentation and  source  before actually making adjustments. In any case, be
  640. very careful  when  writing  to  any  of these files. The entries in /proc may
  641. change slightly between the 2.1.* and the 2.2 kernel, so if there is any doubt
  642. review the kernel documentation in the directory /usr/src/linux/Documentation.
  643. This chapter  is  heavily  based  on the documentation included in the pre 2.2
  644. kernels, and became part of it in version 2.2.1 of the Linux kernel.
  646. 2.1 /proc/sys/fs - File system data
  647. -----------------------------------
  649. This subdirectory  contains  specific  file system, file handle, inode, dentry
  650. and quota information.
  652. Currently, these files are in /proc/sys/fs:
  654. dentry-state
  655. ------------
  657. Status of  the  directory  cache.  Since  directory  entries  are  dynamically
  658. allocated and  deallocated,  this  file indicates the current status. It holds
  659. six values, in which the last two are not used and are always zero. The others
  660. are listed in table 2-1.
  663. Table 2-1: Status files of the directory cache 
  664. ..............................................................................
  665.  File       Content                                                            
  666.  nr_dentry  Almost always zero                                                 
  667.  nr_unused  Number of unused cache entries                                     
  668.  age_limit  
  669.             in seconds after the entry may be reclaimed, when memory is short 
  670.  want_pages internally                                                         
  671. ..............................................................................
  673. dquot-nr and dquot-max
  674. ----------------------
  676. The file dquot-max shows the maximum number of cached disk quota entries.
  678. The file  dquot-nr  shows  the  number of allocated disk quota entries and the
  679. number of free disk quota entries.
  681. If the number of available cached disk quotas is very low and you have a large
  682. number of simultaneous system users, you might want to raise the limit.
  684. file-nr and file-max
  685. --------------------
  687. The kernel  allocates file handles dynamically, but doesn't free them again at
  688. this time.
  690. The value  in  file-max  denotes  the  maximum number of file handles that the
  691. Linux kernel will allocate. When you get a lot of error messages about running
  692. out of  file handles, you might want to raise this limit. The default value is
  693. 4096. To change it, just write the new number into the file:
  695.   # cat /proc/sys/fs/file-max 
  696.   4096 
  697.   # echo 8192 > /proc/sys/fs/file-max 
  698.   # cat /proc/sys/fs/file-max 
  699.   8192 
  702. This method  of  revision  is  useful  for  all customizable parameters of the
  703. kernel - simply echo the new value to the corresponding file.
  705. The three  values  in file-nr denote the number of allocated file handles, the
  706. number of  used file handles, and the maximum number of file handles. When the
  707. allocated file  handles  come close to the maximum, but the number of actually
  708. used ones  is  far  behind,  you've  encountered  a peak in your usage of file
  709. handles and you don't need to increase the maximum.
  711. inode-state, inode-nr and inode-max
  712. -----------------------------------
  714. As with  file  handles, the kernel allocates the inode structures dynamically,
  715. but can't free them yet.
  717. The value  in  inode-max  denotes  the  maximum number of inode handlers. This
  718. value should  be  3 to 4 times larger than the value in file-max, since stdin,
  719. stdout, and  network  sockets also need an inode struct to handle them. If you
  720. regularly run out of inodes, you should increase this value.
  722. The file inode-nr contains the first two items from inode-state, so we'll skip
  723. to that file...
  725. inode-state contains  three  actual numbers and four dummy values. The numbers
  726. are nr_inodes, nr_free_inodes, and preshrink (in order of appearance).
  728. nr_inodes
  729. ~~~~~~~~~
  731. Denotes the  number  of  inodes the system has allocated. This can be slightly
  732. more than inode-max because Linux allocates them one pageful at a time.
  734. nr_free_inodes
  735. --------------
  737. Represents the  number  of free inodes and preshrink is nonzero when nr_inodes
  738. is greater than inode-max and the system needs to prune the inode list instead
  739. of allocating more.
  742. super-nr and super-max
  743. ----------------------
  745. Again, super  block structures are allocated by the kernel, but not freed. The
  746. file super-max  contains  the  maximum  number  of super block handlers, where
  747. super-nr shows the number of currently allocated ones.
  749. Every mounted file system needs a super block, so if you plan to mount lots of
  750. file systems, you may want to increase these numbers.
  752. 2.2 /proc/sys/fs/binfmt_misc - Miscellaneous binary formats
  753. -----------------------------------------------------------
  755. Besides these  files, there is the subdirectory /proc/sys/fs/binfmt_misc. This
  756. handles the kernel support for miscellaneous binary formats.
  758. Binfmt_misc provides  the ability to register additional binary formats to the
  759. Kernel without  compiling  an additional module/kernel. Therefore, binfmt_misc
  760. needs to  know magic numbers at the beginning or the filename extension of the
  761. binary.
  763. It works by maintaining a linked list of structs that contain a description of
  764. a binary  format,  including  a  magic  with size (or the filename extension),
  765. offset and  mask,  and  the  interpreter name. On request it invokes the given
  766. interpreter with  the  original  program  as  argument,  as  binfmt_java  and
  767. binfmt_em86 and  binfmt_mz  do.  Since binfmt_misc does not define any default
  768. binary-formats, you have to register an additional binary-format.
  770. There are two general files in binfmt_misc and one file per registered format.
  771. The two general files are register and status.
  773. Registering a new binary format
  774. -------------------------------
  776. To register a new binary format you have to issue the command
  778.   echo :name:type:offset:magic:mask:interpreter: > /proc/sys/fs/binfmt_misc/register 
  782. with appropriate  name (the name for the /proc-dir entry), offset (defaults to
  783. 0, if  omitted),  magic, mask (which can be omitted, defaults to all 0xff) and
  784. last but  not  least,  the  interpreter that is to be invoked (for example and
  785. testing /bin/echo).  Type  can be M for usual magic matching or E for filename
  786. extension matching (give extension in place of magic).
  788. Check or reset the status of the binary format handler
  789. ------------------------------------------------------
  791. If you  do a cat on the file /proc/sys/fs/binfmt_misc/status, you will get the
  792. current status (enabled/disabled) of binfmt_misc. Change the status by echoing
  793. 0 (disables)  or  1  (enables)  or  -1  (caution:  this  clears all previously
  794. registered binary  formats)  to status. For example echo 0 > status to disable
  795. binfmt_misc (temporarily).
  797. Status of a single handler
  798. --------------------------
  800. Each registered  handler has an entry in /proc/sys/fs/binfmt_misc. These files
  801. perform the  same function as status, but their scope is limited to the actual
  802. binary format.  By  cating this file, you also receive all related information
  803. about the interpreter/magic of the binfmt.
  805. Example usage of binfmt_misc (emulate binfmt_java)
  806. --------------------------------------------------
  808.   cd /proc/sys/fs/binfmt_misc  
  809.   echo ':Java:M::xcaxfexbaxbe::/usr/local/java/bin/javawrapper:' > register  
  810.   echo ':HTML:E::html::/usr/local/java/bin/appletviewer:' > register  
  811.   echo ':Applet:M::<!--applet::/usr/local/java/bin/appletviewer:' > register 
  812.   echo ':DEXE:M::x0eDEX::/usr/bin/dosexec:' > register 
  815. These four  lines  add  support  for  Java  executables and Java applets (like
  816. binfmt_java, additionally  recognizing the .html extension with no need to put
  817. <!--applet> to  every  applet  file).  You  have  to  install  the JDK and the
  818. shell-script /usr/local/java/bin/javawrapper  too.  It  works  around  the
  819. brokenness of  the Java filename handling. To add a Java binary, just create a
  820. link to the class-file somewhere in the path.
  822. 2.3 /proc/sys/kernel - general kernel parameters
  823. ------------------------------------------------
  825. This directory  reflects  general  kernel  behaviors. As I've said before, the
  826. contents depend  on  your  configuration.  Here you'll find the most important
  827. files, along with descriptions of what they mean and how to use them.
  829. acct
  830. ----
  832. The file contains three values; highwater, lowwater, and frequency.
  834. It exists  only  when  BSD-style  process  accounting is enabled. These values
  835. control its behavior. If the free space on the file system where the log lives
  836. goes below  lowwater  percentage,  accounting  suspends.  If  it  goes  above
  837. highwater percentage,  accounting  resumes. Frequency determines how often you
  838. check the amount of free space (value is in seconds). Default settings are: 4,
  839. 2, and  30.  That is, suspend accounting if there is less than 2 percent free;
  840. resume it  if we have a value of 3 or more percent; consider information about
  841. the amount of free space valid for 30 seconds
  843. ctrl-alt-del
  844. ------------
  846. When the value in this file is 0, ctrl-alt-del is trapped and sent to the init
  847. program to  handle a graceful restart. However, when the value is greater that
  848. zero, Linux's  reaction  to  this key combination will be an immediate reboot,
  849. without syncing its dirty buffers.
  851. [NOTE]
  852.     When a  program  (like  dosemu)  has  the  keyboard  in  raw  mode,  the
  853.     ctrl-alt-del is  intercepted  by  the  program  before it ever reaches the
  854.     kernel tty  layer,  and  it is up to the program to decide what to do with
  855.     it.
  857. domainname and hostname
  858. -----------------------
  860. These files  can  be controlled to set the NIS domainname and hostname of your
  861. box. For the classic darkstar.frop.org a simple:
  863.   # echo "darkstar" > /proc/sys/kernel/hostname 
  864.   # echo "frop.org" > /proc/sys/kernel/domainname 
  867. would suffice to set your hostname and NIS domainname.
  869. osrelease, ostype and version
  870. -----------------------------
  872. The names make it pretty obvious what these fields contain:
  874.   > cat /proc/sys/kernel/osrelease 
  875.   2.2.12 
  876.    
  877.   > cat /proc/sys/kernel/ostype 
  878.   Linux 
  879.    
  880.   > cat /proc/sys/kernel/version 
  881.   #4 Fri Oct 1 12:41:14 PDT 1999 
  884. The files  osrelease and ostype should be clear enough. Version needs a little
  885. more clarification.  The  #4 means that this is the 4th kernel built from this
  886. source base and the date after it indicates the time the kernel was built. The
  887. only way to tune these values is to rebuild the kernel.
  889. panic
  890. -----
  892. The value  in  this  file  represents  the  number of seconds the kernel waits
  893. before rebooting  on  a  panic.  When  you  use  the  software  watchdog,  the
  894. recommended setting  is  60. If set to 0, the auto reboot after a kernel panic
  895. is disabled, which is the default setting.
  897. printk
  898. ------
  900. The four values in printk denote
  901. * console_loglevel,
  902. * default_message_loglevel,
  903. * minimum_console_level and
  904. * default_console_loglevel
  905. respectively.
  907. These values  influence  printk()  behavior  when  printing  or  logging error
  908. messages, which  come  from  inside  the  kernel.  See  syslog(2)  for  more
  909. information on the different log levels.
  911. console_loglevel
  912. ----------------
  914. Messages with a higher priority than this will be printed to the console.
  916. default_message_level
  917. ---------------------
  919. Messages without an explicit priority will be printed with this priority.
  921. minimum_console_loglevel
  922. ------------------------
  924. Minimum (highest) value to which the console_loglevel can be set.
  926. default_console_loglevel
  927. ------------------------
  929. Default value for console_loglevel.
  931. sg-big-buff
  932. -----------
  934. This file  shows  the size of the generic SCSI (sg) buffer. At this point, you
  935. can't tune  it  yet,  but  you  can  change  it  at  compile  time  by editing
  936. include/scsi/sg.h and changing the value of SG_BIG_BUFF.
  938. If you use a scanner with SANE (Scanner Access Now Easy) you might want to set
  939. this to a higher value. Refer to the SANE documentation on this issue.
  941. modprobe
  942. --------
  944. The location  where  the  modprobe  binary  is  located.  The kernel uses this
  945. program to load modules on demand.
  947. 2.4 /proc/sys/vm - The virtual memory subsystem
  948. -----------------------------------------------
  950. The files  in  this directory can be used to tune the operation of the virtual
  951. memory (VM)  subsystem  of  the  Linux  kernel.  In addition, one of the files
  952. (bdflush) has some influence on disk usage.
  954. bdflush
  955. -------
  957. This file  controls  the  operation of the bdflush kernel daemon. It currently
  958. contains nine  integer  values,  six of which are actually used by the kernel.
  959. They are listed in table 2-2.
  962. Table 2-2: Parameters in /proc/sys/vm/bdflush 
  963. ..............................................................................
  964.  Value      Meaning                                                            
  965.  nfract     Percentage of buffer cache dirty to  activate bdflush              
  966.  ndirty     Maximum number of dirty blocks to  write out per wake-cycle        
  967.  nrefill    Number of clean buffers to try to obtain  each time we call refill 
  968.  nref_dirt  buffer threshold for activating bdflush when trying to refill
  969.             buffers. 
  970.  dummy      Unused                                                             
  971.  age_buffer Time for normal buffer to age before we flush it                   
  972.  age_super  Time for superblock to age before we flush it                      
  973.  dummy      Unused                                                             
  974.  dummy      Unused                                                             
  975. ..............................................................................
  977. nfract
  978. ------
  980. This parameter  governs  the  maximum  number  of  dirty buffers in the buffer
  981. cache. Dirty means that the contents of the buffer still have to be written to
  982. disk (as  opposed  to  a  clean  buffer,  which  can just be forgotten about).
  983. Setting this  to  a  higher value means that Linux can delay disk writes for a
  984. long time, but it also means that it will have to do a lot of I/O at once when
  985. memory becomes short. A lower value will spread out disk I/O more evenly.
  987. ndirty
  988. ------
  990. Ndirty gives the maximum number of dirty buffers that bdflush can write to the
  991. disk at  one  time.  A high value will mean delayed, bursty I/O, while a small
  992. value can lead to memory shortage when bdflush isn't woken up often enough.
  994. nrefill
  995. -------
  997. This is  the  number  of  buffers  that  bdflush  will add to the list of free
  998. buffers when  refill_freelist()  is  called.  It is necessary to allocate free
  999. buffers beforehand,  since  the  buffers  are  often  different sizes than the
  1000. memory pages  and some bookkeeping needs to be done beforehand. The higher the
  1001. number, the  more  memory  will be wasted and the less often refill_freelist()
  1002. will need to run.
  1004. nref_dirt
  1005. ---------
  1007. When refill_freelist() comes across more than nref_dirt dirty buffers, it will
  1008. wake up bdflush.
  1010. age_buffer and age_super
  1011. ------------------------
  1013. Finally, the age_buffer and age_super parameters govern the maximum time Linux
  1014. waits before  writing  out  a  dirty buffer to disk. The value is expressed in
  1015. jiffies (clockticks),  the  number of jiffies per second is 100. Age_buffer is
  1016. the maximum age for data blocks, while age_super is for filesystems meta data.
  1018. buffermem
  1019. ---------
  1021. The three  values  in  this  file  control  how much memory should be used for
  1022. buffer memory.  The  percentage  is calculated as a percentage of total system
  1023. memory.
  1025. The values are:
  1027. min_percent
  1028. -----------
  1030. This is  the  minimum  percentage  of  memory  that  should be spent on buffer
  1031. memory.
  1033. borrow_percent
  1034. --------------
  1036. When Linux is short on memory, and the buffer cache uses more than it has been
  1037. allotted, the  memory  management  (MM)  subsystem will prune the buffer cache
  1038. more heavily than other memory to compensate.
  1040. max_percent
  1041. -----------
  1043. This is the maximum amount of memory that can be used for buffer memory.
  1045. freepages
  1046. ---------
  1048. This file contains three values: min, low and high:
  1050. min
  1051. ---
  1052. When the  number  of  free  pages  in the system reaches this number, only the
  1053. kernel can allocate more memory.
  1055. low
  1056. ---
  1057. If the number of free pages falls below this point, the kernel starts swapping
  1058. aggressively.
  1060. high
  1061. ----
  1062. The kernel  tries  to  keep  up to this amount of memory free; if memory falls
  1063. below this point, the kernel starts gently swapping in the hopes that it never
  1064. has to do really aggressive swapping.
  1066. kswapd
  1067. ------
  1069. Kswapd is  the  kernel  swap  out daemon. That is, kswapd is that piece of the
  1070. kernel that  frees  memory when it gets fragmented or full. Since every system
  1071. is different, you'll probably want some control over this piece of the system.
  1073. The file contains three numbers:
  1075. tries_base
  1076. ----------
  1078. The maximum  number  of  pages kswapd tries to free in one round is calculated
  1079. from this  number.  Usually  this  number  will  be  divided  by  4  or 8 (see
  1080. mm/vmscan.c), so it isn't as big as it looks.
  1082. When you  need to increase the bandwidth to/from swap, you'll want to increase
  1083. this number.
  1085. tries_min
  1086. ---------
  1088. This is  the  minimum number of times kswapd tries to free a page each time it
  1089. is called. Basically it's just there to make sure that kswapd frees some pages
  1090. even when it's being called with minimum priority.
  1092. swap_cluster
  1093. ------------
  1095. This is probably the greatest influence on system performance.
  1097. swap_cluster is  the  number  of  pages kswapd writes in one turn. You'll want
  1098. this value  to  be  large  so that kswapd does its I/O in large chunks and the
  1099. disk doesn't  have  to  seek  as  often, but you don't want it to be too large
  1100. since that would flood the request queue.
  1102. overcommit_memory
  1103. -----------------
  1105. This file  contains  one  value.  The following algorithm is used to decide if
  1106. there's enough  memory:  if  the  value of overcommit_memory is positive, then
  1107. there's always  enough  memory. This is a useful feature, since programs often
  1108. malloc() huge  amounts  of  memory 'just in case', while they only use a small
  1109. part of  it.  Leaving  this value at 0 will lead to the failure of such a huge
  1110. malloc(), when in fact the system has enough memory for the program to run.
  1112. On the  other  hand,  enabling this feature can cause you to run out of memory
  1113. and thrash the system to death, so large and/or important servers will want to
  1114. set this value to 0.
  1116. pagecache
  1117. ---------
  1119. This file  does exactly the same job as buffermem, only this file controls the
  1120. amount of memory allowed for memory mapping and generic caching of files.
  1122. You don't  want  the  minimum level to be too low, otherwise your system might
  1123. thrash when memory is tight or fragmentation is high.
  1125. pagetable_cache
  1126. ---------------
  1128. The kernel  keeps a number of page tables in a per-processor cache (this helps
  1129. a lot  on  SMP systems). The cache size for each processor will be between the
  1130. low and the high value.
  1132. On a  low-memory,  single  CPU system, you can safely set these values to 0 so
  1133. you don't  waste  memory.  It  is  used  on SMP systems so that the system can
  1134. perform fast  pagetable allocations without having to acquire the kernel memory
  1135. lock.
  1137. For large  systems,  the  settings  are probably fine. For normal systems they
  1138. won't hurt  a  bit.  For  small  systems  (  less  than  16MB ram) it might be
  1139. advantageous to set both values to 0.
  1141. swapctl
  1142. -------
  1144. This file  contains  no less than 8 variables. All of these values are used by
  1145. kswapd.
  1147. The first four variables
  1148. * sc_max_page_age,
  1149. * sc_page_advance,
  1150. * sc_page_decline and
  1151. * sc_page_initial_age
  1152. are used  to  keep  track  of  Linux's page aging. Page aging is a bookkeeping
  1153. method to  track  which pages of memory are often used, and which pages can be
  1154. swapped out without consequences.
  1156. When a  page  is  swapped in, it starts at sc_page_initial_age (default 3) and
  1157. when the  page  is  scanned  by  kswapd,  its age is adjusted according to the
  1158. following scheme:
  1160. * If  the  page  was used since the last time we scanned, its age is increased
  1161.   by sc_page_advance  (default  3).  Where  the  maximum  value  is  given  by
  1162.   sc_max_page_age (default 20).
  1163. * Otherwise  (meaning  it wasn't used) its age is decreased by sc_page_decline
  1164.   (default 1).
  1166. When a page reaches age 0, it's ready to be swapped out.
  1168. The variables  sc_age_cluster_fract, sc_age_cluster_min, sc_pageout_weight and
  1169. sc_bufferout_weight, can  be  used  to  control  kswapd's  aggressiveness  in
  1170. swapping out pages.
  1172. Sc_age_cluster_fract is used to calculate how many pages from a process are to
  1173. be scanned by kswapd. The formula used is
  1175. (sc_age_cluster_fract divided by 1024) times resident set size
  1177. So if you want kswapd to scan the whole process, sc_age_cluster_fract needs to
  1178. have a  value  of  1024.  The  minimum  number  of  pages  kswapd will scan is
  1179. represented by sc_age_cluster_min, which is done so that kswapd will also scan
  1180. small processes.
  1182. The values  of  sc_pageout_weight  and sc_bufferout_weight are used to control
  1183. how many  tries  kswapd  will make in order to swap out one page/buffer. These
  1184. values can  be used to fine-tune the ratio between user pages and buffer/cache
  1185. memory. When  you find that your Linux system is swapping out too many process
  1186. pages in  order  to  satisfy  buffer  memory  demands,  you may want to either
  1187. increase sc_bufferout_weight, or decrease the value of sc_pageout_weight.
  1189. 2.5 /proc/sys/dev - Device specific parameters
  1190. ----------------------------------------------
  1192. Currently there is only support for CDROM drives, and for those, there is only
  1193. one read-only  file containing information about the CD-ROM drives attached to
  1194. the system:
  1196.   >cat /proc/sys/dev/cdrom/info 
  1197.   CD-ROM information, Id: cdrom.c 2.55 1999/04/25 
  1198.    
  1199.   drive name:             sr0     hdb 
  1200.   drive speed:            32      40 
  1201.   drive # of slots:       1       0 
  1202.   Can close tray:         1       1 
  1203.   Can open tray:          1       1 
  1204.   Can lock tray:          1       1 
  1205.   Can change speed:       1       1 
  1206.   Can select disk:        0       1 
  1207.   Can read multisession:  1       1 
  1208.   Can read MCN:           1       1 
  1209.   Reports media changed:  1       1 
  1210.   Can play audio:         1       1 
  1213. You see two drives, sr0 and hdb, along with a list of their features.
  1215. 2.6 /proc/sys/sunrpc - Remote procedure calls
  1216. ---------------------------------------------
  1218. This directory  contains four files, which enable or disable debugging for the
  1219. RPC functions NFS, NFS-daemon, RPC and NLM. The default values are 0. They can
  1220. be set to one to turn debugging on. (The default value is 0 for each)
  1222. 2.7 /proc/sys/net - Networking stuff
  1223. ------------------------------------
  1225. The interface  to  the  networking  parts  of  the  kernel  is  located  in
  1226. /proc/sys/net. Table  2-3  shows all possible subdirectories. You may see only
  1227. some of them, depending on your kernel's configuration.
  1230. Table 2-3: Subdirectories in /proc/sys/net 
  1231. ..............................................................................
  1232.  Directory Content             Directory  Content            
  1233.  core      General parameter   appletalk  Appletalk protocol 
  1234.  unix      Unix domain sockets netrom     NET/ROM            
  1235.  802       E802 protocol       ax25       AX25               
  1236.  ethernet  Ethernet protocol   rose       X.25 PLP layer     
  1237.  ipv4      IP version 4        x25        X.25 protocol      
  1238.  ipx       IPX                 token-ring IBM token ring     
  1239.  bridge    Bridging            decnet     DEC net            
  1240.  ipv6      IP version 6                   
  1241. ..............................................................................
  1243. We will  concentrate  on IP networking here. Since AX15, X.25, and DEC Net are
  1244. only minor players in the Linux world, we'll skip them in this chapter. You'll
  1245. find some  short  info on Appletalk and IPX further on in this chapter. Review
  1246. the online  documentation  and the kernel source to get a detailed view of the
  1247. parameters for  those  protocols.  In  this  section  we'll  discuss  the
  1248. subdirectories printed  in  bold letters in the table above. As default values
  1249. are suitable for most needs, there is no need to change these values.
  1251. /proc/sys/net/core - Network core options
  1252. -----------------------------------------
  1254. rmem_default
  1255. ------------
  1257. The default setting of the socket receive buffer in bytes.
  1259. rmem_max
  1260. --------
  1262. The maximum receive socket buffer size in bytes.
  1264. wmem_default
  1265. ------------
  1267. The default setting (in bytes) of the socket send buffer.
  1269. wmem_max
  1270. --------
  1272. The maximum send socket buffer size in bytes.
  1274. message_burst and message_cost
  1275. ------------------------------
  1277. These parameters  are used to limit the warning messages written to the kernel
  1278. log from  the  networking  code.  They  enforce  a  rate  limit  to  make  a
  1279. denial-of-service attack  impossible. A higher message_cost factor, results in
  1280. fewer messages that will be written. Message_burst controls when messages will
  1281. be dropped.  The  default  settings  limit  warning messages to one every five
  1282. seconds.
  1284. netdev_max_backlog
  1285. ------------------
  1287. Maximum number  of  packets,  queued  on  the  INPUT  side, when the interface
  1288. receives packets faster than kernel can process them.
  1290. optmem_max
  1291. ----------
  1293. Maximum ancillary buffer size allowed per socket. Ancillary data is a sequence
  1294. of struct cmsghdr structures with appended data.
  1296. /proc/sys/net/unix - Parameters for Unix domain sockets
  1297. -------------------------------------------------------
  1299. There are  only  two  files  in this subdirectory. They control the delays for
  1300. deleting and destroying socket descriptors.
  1302. 2.8 /proc/sys/net/ipv4 - IPV4 settings
  1303. --------------------------------------
  1305. IP version  4  is  still the most used protocol in Unix networking. It will be
  1306. replaced by  IP version 6 in the next couple of years, but for the moment it's
  1307. the de  facto  standard  for  the  internet  and  is  used  in most networking
  1308. environments around  the  world.  Because  of the importance of this protocol,
  1309. we'll have a deeper look into the subtree controlling the behavior of the IPv4
  1310. subsystem of the Linux kernel.
  1312. Let's start with the entries in /proc/sys/net/ipv4.
  1314. ICMP settings
  1315. -------------
  1317. icmp_echo_ignore_all and icmp_echo_ignore_broadcasts
  1318. ----------------------------------------------------
  1320. Turn on (1) or off (0), if the kernel should ignore all ICMP ECHO requests, or
  1321. just those to broadcast and multicast addresses.
  1323. Please note that if you accept ICMP echo requests with a broadcast/multi-cast
  1324. destination address  your  network  may  be  used as an exploder for denial of
  1325. service packet flooding attacks to other hosts.
  1327. icmp_destunreach_rate, icmp_echoreply_rate, icmp_paramprob_rate and icmp_timeexeed_rate
  1328. ---------------------------------------------------------------------------------------
  1330. Sets limits  for  sending  ICMP  packets  to specific targets. A value of zero
  1331. disables all  limiting.  Any  positive  value sets the maximum package rate in
  1332. hundredth of a second (on Intel systems).
  1334. IP settings
  1335. -----------
  1337. ip_autoconfig
  1338. -------------
  1340. This file contains the number one if the host received its IP configuration by
  1341. RARP, BOOTP, DHCP or a similar mechanism. Otherwise it is zero.
  1343. ip_default_ttl
  1344. --------------
  1346. TTL (Time  To  Live) for IPv4 interfaces. This is simply the maximum number of
  1347. hops a packet may travel.
  1349. ip_dynaddr
  1350. ----------
  1352. Enable dynamic  socket  address rewriting on interface address change. This is
  1353. useful for dialup interface with changing IP addresses.
  1355. ip_forward
  1356. ----------
  1358. Enable or  disable forwarding of IP packages between interfaces. Changing this
  1359. value resets  all other parameters to their default values. They differ if the
  1360. kernel is configured as host or router.
  1362. ip_local_port_range
  1363. -------------------
  1365. Range of  ports  used  by  TCP  and UDP to choose the local port. Contains two
  1366. numbers, the  first  number  is the lowest port, the second number the highest
  1367. local port.  Default  is  1024-4999.  Should  be  changed  to  32768-61000 for
  1368. high-usage systems.
  1370. ip_no_pmtu_disc
  1371. ---------------
  1373. Global switch  to  turn  path  MTU  discovery off. It can also be set on a per
  1374. socket basis by the applications or on a per route basis.
  1376. ip_masq_debug
  1377. -------------
  1379. Enable/disable debugging of IP masquerading.
  1381. IP fragmentation settings
  1382. -------------------------
  1384. ipfrag_high_trash and ipfrag_low_trash
  1385. --------------------------------------
  1387. Maximum memory  used to reassemble IP fragments. When ipfrag_high_thresh bytes
  1388. of memory  is  allocated  for  this  purpose,  the  fragment handler will toss
  1389. packets until ipfrag_low_thresh is reached.
  1391. ipfrag_time
  1392. -----------
  1394. Time in seconds to keep an IP fragment in memory.
  1396. TCP settings
  1397. ------------
  1399. tcp_ecn
  1400. -------
  1402. This file controls the use of the ECN bit in the IPv4 headers, this is a new
  1403. feature about Explicit Congestion Notification, but some routers and firewalls
  1404. block trafic that has this bit set, so it could be necessary to echo 0 to
  1405. /proc/sys/net/ipv4/tcp_ecn, if you want to talk to this sites. For more info
  1406. you could read RFC2481.
  1408. tcp_retrans_collapse
  1409. --------------------
  1411. Bug-to-bug compatibility with some broken printers. On retransmit, try to send
  1412. larger packets to work around bugs in certain TCP stacks. Can be turned off by
  1413. setting it to zero.
  1415. tcp_keepalive_probes
  1416. --------------------
  1418. Number of  keep  alive  probes  TCP  sends  out,  until  it  decides  that the
  1419. connection is broken.
  1421. tcp_keepalive_time
  1422. ------------------
  1424. How often  TCP  sends out keep alive messages, when keep alive is enabled. The
  1425. default is 2 hours.
  1427. tcp_syn_retries
  1428. ---------------
  1430. Number of  times  initial  SYNs  for  a  TCP  connection  attempt  will  be
  1431. retransmitted. Should  not  be  higher  than 255. This is only the timeout for
  1432. outgoing connections,  for  incoming  connections the number of retransmits is
  1433. defined by tcp_retries1.
  1435. tcp_sack
  1436. --------
  1438. Enable select acknowledgments after RFC2018.
  1440. tcp_timestamps
  1441. --------------
  1443. Enable timestamps as defined in RFC1323.
  1445. tcp_stdurg
  1446. ----------
  1448. Enable the  strict  RFC793 interpretation of the TCP urgent pointer field. The
  1449. default is  to  use  the  BSD  compatible interpretation of the urgent pointer
  1450. pointing to the first byte after the urgent data. The RFC793 interpretation is
  1451. to have  it  point  to  the last byte of urgent data. Enabling this option may
  1452. lead to interoperatibility problems. Disabled by default.
  1454. tcp_syncookies
  1455. --------------
  1457. Only valid  when  the  kernel  was  compiled  with CONFIG_SYNCOOKIES. Send out
  1458. syncookies when  the  syn backlog queue of a socket overflows. This is to ward
  1459. off the common 'syn flood attack'. Disabled by default.
  1461. Note that  the  concept  of a socket backlog is abandoned. This means the peer
  1462. may not  receive  reliable  error  messages  from  an  over loaded server with
  1463. syncookies enabled.
  1465. tcp_window_scaling
  1466. ------------------
  1468. Enable window scaling as defined in RFC1323.
  1470. tcp_fin_timeout
  1471. ---------------
  1473. The length  of  time  in  seconds  it  takes to receive a final FIN before the
  1474. socket is  always  closed.  This  is  strictly  a  violation  of  the  TCP
  1475. specification, but required to prevent denial-of-service attacks.
  1477. tcp_max_ka_probes
  1478. -----------------
  1480. Indicates how  many  keep alive probes are sent per slow timer run. Should not
  1481. be set too high to prevent bursts.
  1483. tcp_max_syn_backlog
  1484. -------------------
  1486. Length of  the per socket backlog queue. Since Linux 2.2 the backlog specified
  1487. in listen(2)  only  specifies  the  length  of  the  backlog  queue of already
  1488. established sockets. When more connection requests arrive Linux starts to drop
  1489. packets. When  syncookies  are  enabled the packets are still answered and the
  1490. maximum queue is effectively ignored.
  1492. tcp_retries1
  1493. ------------
  1495. Defines how  often  an  answer  to  a  TCP connection request is retransmitted
  1496. before giving up.
  1498. tcp_retries2
  1499. ------------
  1501. Defines how often a TCP packet is retransmitted before giving up.
  1503. Interface specific settings
  1504. ---------------------------
  1506. In the directory /proc/sys/net/ipv4/conf you'll find one subdirectory for each
  1507. interface the  system  knows about and one directory calls all. Changes in the
  1508. all subdirectory  affect  all  interfaces,  whereas  changes  in  the  other
  1509. subdirectories affect  only  one  interface.  All  directories  have  the same
  1510. entries:
  1512. accept_redirects
  1513. ----------------
  1515. This switch  decides  if the kernel accepts ICMP redirect messages or not. The
  1516. default is 'yes' if the kernel is configured for a regular host and 'no' for a
  1517. router configuration.
  1519. accept_source_route
  1520. -------------------
  1522. Should source  routed  packages  be  accepted  or  declined.  The  default  is
  1523. dependent on  the  kernel  configuration.  It's 'yes' for routers and 'no' for
  1524. hosts.
  1526. bootp_relay
  1527. ~~~~~~~~~~~
  1529. Accept packets  with source address 0.b.c.d with destinations not to this host
  1530. as local ones. It is supposed that a BOOTP relay daemon will catch and forward
  1531. such packets.
  1533. The default  is  0,  since this feature is not implemented yet (kernel version
  1534. 2.2.12).
  1536. forwarding
  1537. ----------
  1539. Enable or disable IP forwarding on this interface.
  1541. log_martians
  1542. ------------
  1544. Log packets with source addresses with no known route to kernel log.
  1546. mc_forwarding
  1547. -------------
  1549. Do multicast routing. The kernel needs to be compiled with CONFIG_MROUTE and a
  1550. multicast routing daemon is required.
  1552. proxy_arp
  1553. ---------
  1555. Does (1) or does not (0) perform proxy ARP.
  1557. rp_filter
  1558. ---------
  1560. Integer value determines if a source validation should be made. 1 means yes, 0
  1561. means no.  Disabled by default, but local/broadcast address spoofing is always
  1562. on.
  1564. If you  set this to 1 on a router that is the only connection for a network to
  1565. the net,  it  will  prevent  spoofing  attacks  against your internal networks
  1566. (external addresses  can  still  be  spoofed), without the need for additional
  1567. firewall rules.
  1569. secure_redirects
  1570. ----------------
  1572. Accept ICMP  redirect  messages  only  for gateways, listed in default gateway
  1573. list. Enabled by default.
  1575. shared_media
  1576. ------------
  1578. If it  is  not  set  the kernel does not assume that different subnets on this
  1579. device can communicate directly. Default setting is 'yes'.
  1581. send_redirects
  1582. --------------
  1584. Determines whether to send ICMP redirects to other hosts.
  1586. Routing settings
  1587. ----------------
  1589. The directory  /proc/sys/net/ipv4/route  contains  several  file  to  control
  1590. routing issues.
  1592. error_burst and error_cost
  1593. --------------------------
  1595. These parameters  are used to limit the warning messages written to the kernel
  1596. log from  the  routing  code.  The  higher the error_cost factor is, the fewer
  1597. messages will  be written. Error_burst controls when messages will be dropped.
  1598. The default settings limit warning messages to one every five seconds.
  1600. flush
  1601. -----
  1603. Writing to this file results in a flush of the routing cache.
  1605. gc_elastic, gc_interval, gc_min_interval, gc_tresh, gc_timeout
  1606. --------------------------------------------------------------
  1608. Values to  control  the  frequency  and  behavior  of  the  garbage collection
  1609. algorithm for the routing cache.
  1611. max_size
  1612. --------
  1614. Maximum size  of  the routing cache. Old entries will be purged once the cache
  1615. reached has this size.
  1617. max_delay, min_delay
  1618. --------------------
  1620. Delays for flushing the routing cache.
  1622. redirect_load, redirect_number
  1623. ------------------------------
  1625. Factors which  determine  if  more ICPM redirects should be sent to a specific
  1626. host. No  redirects  will be sent once the load limit or the maximum number of
  1627. redirects has been reached.
  1629. redirect_silence
  1630. ----------------
  1632. Timeout for redirects. After this period redirects will be sent again, even if
  1633. this has been stopped, because the load or number limit has been reached.
  1635. Network Neighbor handling
  1636. -------------------------
  1638. Settings about how to handle connections with direct neighbors (nodes attached
  1639. to the same link) can be found in the directory /proc/sys/net/ipv4/neigh.
  1641. As we  saw  it  in  the  conf directory, there is a default subdirectory which
  1642. holds the  default  values, and one directory for each interface. The contents
  1643. of the  directories  are identical, with the single exception that the default
  1644. settings contain additional options to set garbage collection parameters.
  1646. In the interface directories you'll find the following entries:
  1648. base_reachable_time
  1649. -------------------
  1651. A base  value  used for computing the random reachable time value as specified
  1652. in RFC2461.
  1654. retrans_time
  1655. ------------
  1657. The time,  expressed  in  jiffies  (1/100 sec), between retransmitted Neighbor
  1658. Solicitation messages.  Used  for  address  resolution  and  to determine if a
  1659. neighbor is unreachable.
  1661. unres_qlen
  1662. ----------
  1664. Maximum queue  length  for a pending arp request - the number of packets which
  1665. are accepted from other layers while the ARP address is still resolved.
  1667. anycast_delay
  1668. -------------
  1670. Maximum for  random  delay  of  answers  to  neighbor solicitation messages in
  1671. jiffies (1/100  sec). Not yet implemented (Linux does not have anycast support
  1672. yet).
  1674. ucast_solicit
  1675. -------------
  1677. Maximum number of retries for unicast solicitation.
  1679. mcast_solicit
  1680. -------------
  1682. Maximum number of retries for multicast solicitation.
  1684. delay_first_probe_time
  1685. ----------------------
  1687. Delay for  the  first  time  probe  if  the  neighbor  is  reachable.  (see
  1688. gc_stale_time)
  1690. locktime
  1691. --------
  1693. An ARP/neighbor  entry  is only replaced with a new one if the old is at least
  1694. locktime old. This prevents ARP cache thrashing.
  1696. proxy_delay
  1697. -----------
  1699. Maximum time  (real  time is random [0..proxytime]) before answering to an ARP
  1700. request for  which  we have an proxy ARP entry. In some cases, this is used to
  1701. prevent network flooding.
  1703. proxy_qlen
  1704. ----------
  1706. Maximum queue length of the delayed proxy arp timer. (see proxy_delay).
  1708. app_solcit
  1709. ----------
  1711. Determines the  number of requests to send to the user level ARP daemon. Use 0
  1712. to turn off.
  1714. gc_stale_time
  1715. -------------
  1717. Determines how  often  to  check  for stale ARP entries. After an ARP entry is
  1718. stale it  will  be resolved again (which is useful when an IP address migrates
  1719. to another  machine).  When  ucast_solicit is greater than 0 it first tries to
  1720. send an  ARP  packet  directly  to  the  known  host  When  that  fails  and
  1721. mcast_solicit is greater than 0, an ARP request is broadcasted.
  1723. 2.9 Appletalk
  1724. -------------
  1726. The /proc/sys/net/appletalk  directory  holds the Appletalk configuration data
  1727. when Appletalk is loaded. The configurable parameters are:
  1729. aarp-expiry-time
  1730. ----------------
  1732. The amount  of  time  we keep an ARP entry before expiring it. Used to age out
  1733. old hosts.
  1735. aarp-resolve-time
  1736. -----------------
  1738. The amount of time we will spend trying to resolve an Appletalk address.
  1740. aarp-retransmit-limit
  1741. ---------------------
  1743. The number of times we will retransmit a query before giving up.
  1745. aarp-tick-time
  1746. --------------
  1748. Controls the rate at which expires are checked.
  1750. The directory  /proc/net/appletalk  holds the list of active Appletalk sockets
  1751. on a machine.
  1753. The fields  indicate  the DDP type, the local address (in network:node format)
  1754. the remote  address,  the  size of the transmit pending queue, the size of the
  1755. received queue  (bytes waiting for applications to read) the state and the uid
  1756. owning the socket.
  1758. /proc/net/atalk_iface lists  all  the  interfaces  configured for appletalk.It
  1759. shows the  name  of the interface, its Appletalk address, the network range on
  1760. that address  (or  network number for phase 1 networks), and the status of the
  1761. interface.
  1763. /proc/net/atalk_route lists  each  known  network  route.  It lists the target
  1764. (network) that the route leads to, the router (may be directly connected), the
  1765. route flags, and the device the route is using.
  1767. 2.10 IPX
  1768. --------
  1770. The IPX protocol has no tunable values in proc/sys/net.
  1772. The IPX  protocol  does,  however,  provide  proc/net/ipx. This lists each IPX
  1773. socket giving  the  local  and  remote  addresses  in  Novell  format (that is
  1774. network:node:port). In  accordance  with  the  strange  Novell  tradition,
  1775. everything but the port is in hex. Not_Connected is displayed for sockets that
  1776. are not  tied to a specific remote address. The Tx and Rx queue sizes indicate
  1777. the number  of  bytes  pending  for  transmission  and  reception.  The  state
  1778. indicates the  state  the  socket  is  in and the uid is the owning uid of the
  1779. socket.
  1781. The /proc/net/ipx_interface  file lists all IPX interfaces. For each interface
  1782. it gives  the network number, the node number, and indicates if the network is
  1783. the primary  network.  It  also  indicates  which  device  it  is bound to (or
  1784. Internal for  internal  networks)  and  the  Frame  Type if appropriate. Linux
  1785. supports 802.3,  802.2,  802.2  SNAP  and DIX (Blue Book) ethernet framing for
  1786. IPX.
  1788. The /proc/net/ipx_route  table  holds  a list of IPX routes. For each route it
  1789. gives the  destination  network, the router node (or Directly) and the network
  1790. address of the router (or Connected) for internal networks.
  1792. ------------------------------------------------------------------------------
  1793. Summary
  1794. ------------------------------------------------------------------------------
  1795. Certain aspects  of  kernel  behavior  can be modified at runtime, without the
  1796. need to  recompile  the kernel, or even to reboot the system. The files in the
  1797. /proc/sys tree  can  not only be read, but also modified. You can use the echo
  1798. command to write value into these files, thereby changing the default settings
  1799. of the kernel.
  1800. ------------------------------------------------------------------------------