home *** CD-ROM | disk | FTP | other *** search
/ PC Welt 2006 November (DVD) / PCWELT_11_2006.ISO / casper / filesystem.squashfs / usr / share / doc / iproute / README.lnstat < prev    next >
Encoding:
Text File  |  2004-10-19  |  1.9 KB  |  82 lines
  1. lnstat - linux networking statistics
  2. (C) 2004 Harald Welte <laforge@gnumonks.org
  3. ======================================================================
  4.  
  5. This tool is a generalized and more feature-complete replacement for the old
  6. 'rtstat' program.
  7.  
  8. In addition to routing cache statistics, it supports any kind of statistics
  9. the linux kernel exports via a file in /proc/net/stat.  In a stock 2.6.9
  10. kernel, this is 
  11.     per-protocol neighbour cache statistics 
  12.         (ipv4, ipv6, atm, decnet)
  13.     routing cache statistics
  14.         (ipv4)
  15.     connection tracking statistics
  16.         (ipv4)
  17.  
  18. Please note that lnstat will adopt to any additional statistics that might be
  19. added to the kernel at some later point
  20.  
  21. I personally always like examples more than any reference documentation, so I
  22. list the following examples.  If somebody wants to do a manpage, feel free
  23. to send me a patch :)
  24.  
  25. EXAMPLES:
  26.  
  27. In order to get a list of supported statistics files, you can run
  28.  
  29.     lnstat -d
  30.  
  31. It will display something like
  32.  
  33. /proc/net/stat/arp_cache:
  34.          1: entries
  35.          2: allocs
  36.          3: destroys
  37. [...]
  38. /proc/net/stat/rt_cache:
  39.          1: entries
  40.          2: in_hit
  41.          3: in_slow_tot
  42.  
  43. You can now select the files/keys you are interested by something like
  44.  
  45.     lnstat -k arp_cache:entries,rt_cache:in_hit,arp_cache:destroys
  46.  
  47. arp_cach|rt_cache|arp_cach|
  48.  entries|  in_hit|destroys|
  49.        6|       6|       0|
  50.        6|       0|       0|
  51.        6|       2|       0|
  52.  
  53.  
  54. You can specify the interval (e.g. 10 seconds) by:
  55.     
  56.     lnstat -i 10
  57.  
  58. You can specify to only use one particular statistics file:
  59.  
  60.     lnstat -f ip_conntrack
  61.  
  62. You can specify individual field widths 
  63.  
  64.     lnstat -k arp_cache:entries,rt_cache:entries -w 20,8
  65.  
  66. You can specify not to print a header at all
  67.     
  68.     lnstat -s 0
  69.  
  70. You can specify to print a header only at start of the program
  71.  
  72.     lnstat -s 1
  73.  
  74. You can specify to print a header at start and every 20 lines:
  75.  
  76.     lnstat -s 20
  77.  
  78. You can specify the number of samples you want to take (e.g. 5):
  79.     
  80.     lnstat -c 5
  81.  
  82.