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

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

分享一个Linux管理文档多租户的例子

例题 同一群组microsoft下的两个账号justmine001和justmine002需要共同拥有目录/microsoft/eshop的开发权,以便进行协同工作,但是其他人不允许进入和查阅该目录. 从例题可以分析出: 同一群组下的账户需要共同拥有目录的使用权,且可以编辑里面的任何文件. 其他账户不拥有该目录的任何权限. 需要使用root账户,创建账户.群组,设置目录权限,然后搭建开发环境. 创建账户相关信息 groupadd microsoft ; 新增群组 useradd -G micro

[sharepoint]rest api文档库文件上传,下载,拷贝,剪切,删除文件,创建文件夹,修改文件夹属性,删除文件夹,获取文档列表

写在前面 最近对文档库的知识点进行了整理,也就有了这篇文章,当时查找这些接口,并用在实践中,确实废了一些功夫,也为了让更多的人走更少的弯路. 系列文章 sharepoint环境安装过程中几点需要注意的地方 Rest API的简单应用 rest api方式实现对文档库的管理 通过WebClient模拟post上传文件到服务器 WebHttpRequest在sharepoint文档库中的使用 [sharepoint]Rest api相关知识(转) [sharepoint]根据用户名获取该用户的权限

SharePoint2010文档归档策略(2)-从放置库转移到自己定义的文档库

SharePoint2010文档归档策略(2)-从放置库转移到自己定义的文档库 1. 如果上所述,文档库已经转移到放置库,需要配置[内容管理器设置],点[网站操作]-[网站设置]-[内容管理器设置]如下图: l 如果选中了“允许规则将其他网站指定为目标位置”选项,那么在规则中,就能将上载的文档移动到其他网站.但是其他网站的目标位置,必须事先由管理员在“管理中心 - 一般应用程序设置 - 配置发送到连接”设置之后,才能使用. 如下图: l 自动创建子文件夹的选项非常有用,这样可以避免在一个文件夹中

资料收集:学习 Linux/*BSD/Unix 的 30 个最佳在线文档

文章转自:https://linux.cn/article-10311-1.html 手册页(man)是由系统管理员和 IT 技术开发人员写的,更多的是为了作为参考而不是教你如何使用.手册页对于已经熟悉使用 Linux.Unix 和 BSD 操作系统的人来说是非常有用的.如果你仅仅需要知道某个命令或者某个配置文件的格式那么你可以使用手册页,但是手册页对于 Linux 新手来说并没有太大的帮助.想要通过使用手册页来学习一些新东西不是一个好的选择.这里有将提供 30 个学习 Linux 和 Unix

如何开发一个java开源框架-----Jvn框架之实现自动生成在线文档(第七讲)

一 . 前言:博主正在教大家如何开发一个javaEE框架,我把框架命名为Jvn,博客里有完整的开发视频,每一篇博文都是一个知识点: 关于框架的介绍和学习,可以从我博客第一讲开始看起,博客首页:http://www.cnblogs.com/everxs/ 本次内容视频以及源码下载地址:http://pan.baidu.com/s/1o6MJnFc 二. 本次博客讲的内容 场景:现在是APP时代,APP很热门,而且跟后台交互跑的都是HTTP协议,所以讲到这里,对于这里面的交互. 安卓工程师(客户端)

在线文档预览方案-office web apps

最近再做项目时,要在手机端实现在线文档预览的功能.于是百度了一下实现方案,大致是将文档转换成pdf,然后在通过插件实现预览.这些方案没有具体实现代码,也没有在线预览的地址,再加上项目时间紧迫.只能考虑其它方案,这时微软的office web apps方案映入眼帘,于是和同事一起用一台PC机折腾了几天终于完成了部署,希望通过本篇记录下安装过程和遇到的坑.目前使用该方案的有 明道 微软,我部署的服务地址:http://myscloud.vicp.cc/op/generate.aspx 下面是在线预览

LINUX 内核文档地址

Set colors for man pages: 设置方法比较简单,打开/etc/bash.bashrc(需要root权限)或者~/.bashrc文件加入如下内容: # Set colors for man pagesman() {env \LESS_TERMCAP_mb=$(printf “\e[1;31m”) \LESS_TERMCAP_md=$(printf “\e[1;31m”) \LESS_TERMCAP_me=$(printf “\e[0m”) \LESS_TERMCAP_se=$

云享 值得一用的在线文档即时通讯平台 新用户持续免费

云享 值得一用的在线文档即时通讯平台 新用户持续免费 https:\\Cloudshare.im 我们的特征是团队版本的文档库,同时提供完美的手机APP支持,更妙的是提供类微信体验的通知.即时沟通工具,热烈邀请大伙,伙伴们来体验,给我们反馈. 友好的用户反馈,可以直接留言在当下的Blog https:\\cloudshare.im [email protected] [email protected] b@cloudshare.im c@cloudshare.im 密码 111111 云享 值得

C#WebApi中swagger在线文档输出参数和输入参数显示注释

最近开发webapi 时需要生成在线文档,发现文档里面没注释,在网上查找资料都不齐全,或者看起来很难看懂. 花了点时间搞出来了这个,很多都是借鉴网上资料整理的,通俗易懂小白专用. 最终效果如上图所示 1.定义一个SwaggerControllerDescProvider实现ISwaggerProvider接口 using Swashbuckle.Swagger; using System; using System.Collections.Concurrent; using System.Col