~ubuntu-branches/ubuntu/precise/iproute/precise

« back to all changes in this revision

Viewing changes to man/man8/lnstat.8

  • Committer: Bazaar Package Importer
  • Author(s): Fabio M. Di Nitto
  • Date: 2007-06-11 13:31:12 UTC
  • mfrom: (1.1.4 upstream)
  • Revision ID: james.westby@ubuntu.com-20070611133112-0rtfv32yfs8loo0r
Tags: 20070313-1ubuntu1
* Merge from debian unstable, remaining changes:
  - linux-kernel-headers -> linux-libc-dev B-D rename.
  - MAX_ROUNDS patch to ip/ipaddress.c
  - Ubuntu maintainer foobar.

Show diffs side-by-side

added added

removed removed

Lines of Context:
 
1
.TH LNSTAT 8
 
2
.SH NAME
 
3
lnstat \- unified linux network statistics
 
4
.SH SYNOPSIS
 
5
.B lnstat
 
6
.RI [ options ]
 
7
.SH DESCRIPTION
 
8
This manual page documents briefly the
 
9
.B lnstat
 
10
command.
 
11
.PP
 
12
\fBlnstat\fP is a generalized and more feature-complete replacement for the old rtstat program.
 
13
In addition to routing cache statistics, it supports any kind of statistics the linux kernel
 
14
exports via a file in /proc/net/stat/.
 
15
.SH OPTIONS
 
16
These programs follow the usual GNU command line syntax, with long
 
17
options starting with two dashes (`-').
 
18
lnstat supports the following options.
 
19
.TP
 
20
.B \-h, \-\-help
 
21
Show summary of options.
 
22
.TP
 
23
.B \-V, \-\-version
 
24
Show version of program.
 
25
.TP
 
26
.B \-c, \-\-count <count>
 
27
Print <count> number of intervals.
 
28
.TP
 
29
.B \-d, \-\-dump
 
30
Dump list of available files/keys.
 
31
.TP
 
32
.B \-f, \-\-file <file>
 
33
Statistics file to use.
 
34
.TP
 
35
.B \-i, \-\-interval <intv>
 
36
Set interval to 'intv' seconds.
 
37
.TP
 
38
.B \-k, \-\-keys k,k,k,...
 
39
Display only keys specified.
 
40
.TP
 
41
.B \-s, \-\-subject [0-2]
 
42
Specify display of subject/header. '0' means no header at all, '1' prints a header only at start of the program and '2' prints a header every 20 lines.
 
43
.TP
 
44
.B \-w, \-\-width n,n,n,...
 
45
Width for each field.
 
46
.SH USAGE EXAMPLES
 
47
.TP
 
48
.B # lnstat -d
 
49
Get a list of supported statistics files.
 
50
.TP
 
51
.B # lnstat -k arp_cache:entries,rt_cache:in_hit,arp_cache:destroys
 
52
Select the specified files and keys.
 
53
.TP
 
54
.B # lnstat -i 10
 
55
Use an interval of 10 seconds.
 
56
.TP
 
57
.B # lnstat -f ip_conntrack
 
58
Use only the specified file for statistics.
 
59
.TP
 
60
.B # lnstat -s 0
 
61
Do not print a header at all.
 
62
.TP
 
63
.B # lnstat -s 20
 
64
Print a header at start and every 20 lines.
 
65
.TP
 
66
.B # lnstat -c -1 -i 1 -f rt_cache -k entries,in_hit,in_slow_tot
 
67
Display statistics for keys entries, in_hit and in_slow_tot of field rt_cache every second.
 
68
.SH SEE ALSO
 
69
.BR ip (8),
 
70
and /usr/share/doc/iproute-doc/README.lnstat (package iproute-doc on Debian)
 
71
.br
 
72
.SH AUTHOR
 
73
lnstat was written by Harald Welte <laforge@gnumonks.org>.
 
74
.PP
 
75
This manual page was written by Michael Prokop <mika@grml.org> for the Debian project (but may be used by others).