1LNSTAT(8) System Manager's Manual LNSTAT(8)
2
6 lnstat - unified linux network statistics
7
9 lnstat [options]
10
12 This manual page documents briefly the lnstat command.
13 lnstat is a generalized and more feature-complete replacement for the
15 old rtstat program. It is commonly used to periodically print a selec‐
16 tion of statistical values exported by the kernel. In addition to
17 routing cache statistics, it supports any kind of statistics the linux
18 kernel exports via a file in /proc/net/stat/.
19 Each file in /proc/net/stat/ contains a header line listing the column
21 names. These names are used by lnstat as keys for selecting which sta‐
22 tistics to print. For every CPU present in the system, a line follows
23 which lists the actual values for each column of the file. lnstat sums
24 these values up (which in fact are counters) before printing them.
25 After each interval, only the difference to the last value is printed.
26 Files and columns may be selected by using the -f and -k parameters. By
28 default, all columns of all files are printed.
29
31 lnstat supports the following options.
32 -h, --help
34 Show summary of options.
35 -V, --version
37 Show version of program.
38 -c, --count <count>
40 Print <count> number of intervals.
41 -d, --dump
43 Dump list of available files/keys.
44 -f, --file <file>
46 Statistics file to use, may be specified multiple times. By
47 default all files in /proc/net/stat are scanned.
48 -i, --interval <intv>
50 Set interval to 'intv' seconds.
51 -j, --json
53 Display results in JSON format
54 -k, --keys k,k,k,...
56 Display only keys specified. Each key k is of the form
57 [file:]key. If <file> is given, the search for the given key is
58 limited to that file. Otherwise the first file containing the
59 searched key is being used.
60 -s, --subject [0-2]
62 Specify display of subject/header. '0' means no header at all,
63 '1' prints a header only at start of the program and '2' prints
64 a header every 20 lines.
65 -w, --width n,n,n,...
67 Width for each field.
68
70 # lnstat -d
71 Get a list of supported statistics files.
72 # lnstat -k arp_cache:entries,rt_cache:in_hit,arp_cache:destroys
74 Select the specified files and keys.
75 # lnstat -i 10
77 Use an interval of 10 seconds.
78 # lnstat -f ip_conntrack
80 Use only the specified file for statistics.
81 # lnstat -s 0
83 Do not print a header at all.
84 # lnstat -s 20
86 Print a header at start and every 20 lines.
87 # lnstat -c -1 -i 1 -f rt_cache -k entries,in_hit,in_slow_tot
89 Display statistics for keys entries, in_hit and in_slow_tot of
90 field rt_cache every second.
91
94 /proc/net/stat/arp_cache, /proc/net/stat/ndisc_cache
95 Statistics around neighbor cache and ARP. arp_cache is for IPv4,
96 ndisc_cache is the same for IPv6.
97 entries Number of entries in the neighbor table.
99 allocs How many neighbor entries have been allocated.
101 destroys How many neighbor entries have been removed.
103 hash_grows How often the neighbor (hash) table was increased.
105 lookups How many lookups were performed.
107 hits How many lookups were successful.
109 res_failed How many neighbor lookups failed.
111 rcv_probes_mcast How many multicast neighbor solicitations were
113 received. (IPv6 only.)
114 rcv_probes_ucast How many unicast neighbor solicitations were
116 received. (IPv6 only.)
117 periodic_gc_runs How many garbage collection runs were executed.
119 forced_gc_runs How many forced garbage collection runs were exe‐
121 cuted. Happens when adding an entry and the table is too full.
122 unresolved_discards How many neighbor table entries were dis‐
124 carded due to lookup failure.
125 table_fulls Number of table overflows. Happens if table is full
127 and forced GC run (see forced_gc_runs) has failed.
128 /proc/net/stat/ip_conntrack, /proc/net/stat/nf_conntrack
131 Conntrack related counters. ip_conntrack is for backwards com‐
132 patibility with older userspace only and shows the same data as
133 nf_conntrack.
134 entries Number of entries in conntrack table.
136 searched Number of conntrack table lookups performed.
138 found Number of searched entries which were successful.
140 new Number of conntrack entries added which were not expected
142 before.
143 invalid Number of packets seen which can not be tracked.
145 ignore Number of packets seen which are already connected to a
147 conntrack entry.
148 delete Number of conntrack entries which were removed.
150 delete_list Number of conntrack entries which were put to dying
152 list.
153 insert Number of entries inserted into the list.
155 insert_failed Number of entries for which list insertion was
157 attempted but failed (happens if the same entry is already
158 present).
159 drop Number of packets dropped due to conntrack failure. Either
161 new conntrack entry allocation failed, or protocol helper
162 dropped the packet.
163 early_drop Number of dropped conntrack entries to make room for
165 new ones, if maximum table size was reached.
166 icmp_error Number of packets which could not be tracked due to
168 error situation. This is a subset of invalid.
169 expect_new Number of conntrack entries added after an expecta‐
171 tion for them was already present.
172 expect_create Number of expectations added.
174 expect_delete Number of expectations deleted.
176 search_restart Number of conntrack table lookups which had to be
178 restarted due to hashtable resizes.
179 /proc/net/stat/rt_cache
182 Routing cache statistics.
183 entries Number of entries in routing cache.
185 in_hit Number of route cache hits for incoming packets. Depre‐
187 cated since IP route cache removal, therefore always zero.
188 in_slow_tot Number of routing cache entries added for input
190 traffic.
191 in_slow_mc Number of multicast routing cache entries added for
193 input traffic.
194 in_no_route Number of input packets for which no routing table
196 entry was found.
197 in_brd Number of matched input broadcast packets.
199 in_martian_dst Number of incoming martian destination packets.
201 in_martian_src Number of incoming martian source packets.
203 out_hit Number of route cache hits for outgoing packets. Depre‐
205 cated since IP route cache removal, therefore always zero.
206 out_slow_tot Number of routing cache entries added for output
208 traffic.
209 out_slow_mc Number of multicast routing cache entries added for
211 output traffic.
212 gc_total Total number of garbage collection runs. Deprecated
214 since IP route cache removal, therefore always zero.
215 gc_ignored Number of ignored garbage collection runs due to min‐
217 imum GC interval not reached and routing cache not full. Depre‐
218 cated since IP route cache removal, therefore always zero.
219 gc_goal_miss Number of garbage collector goal misses. Deprecated
221 since IP route cache removal, therefore always zero.
222 gc_dst_overflow Number of destination cache overflows. Depre‐
224 cated since IP route cache removal, therefore always zero.
225 in_hlist_search Number of hash table list traversals for input
227 traffic. Deprecated since IP route cache removal, therefore
228 always zero.
229 out_hlist_search Number of hash table list traversals for output
231 traffic. Deprecated since IP route cache removal, therefore
232 always zero.
233
236 ip(8)
237
239 lnstat was written by Harald Welte <laforge@gnumonks.org>.
240 This manual page was written by Michael Prokop <mika@grml.org> for the
242 Debian project (but may be used by others).
243 LNSTAT(8)