Whamcloud - gitweb
New RC 2.16.0-RC5
[fs/lustre-release.git] / lustre / doc / routerstat.8
1 .TH routerstat 1 "Aug 6, 2014" Lustre "utilities"
2 .SH NAME
3 routerstat \- print Lustre router statistics
4 .SH SYNOPSIS
5 .B "routerstat [interval]
6 .br
7 .SH DESCRIPTION
8 .B routerstat
9 displays LNET router statistics.  If no
10 .I interval
11 is specified, the statistics are sampled and printed only once;
12 otherwise, statistics are sampled and printed every
13 .I interval
14 seconds. Type Control-C to stop statistics printing.
15 .LP
16 Output includes the following fields:
17 .LP
18 .nf
19 M - Number of messages currently being processed by LNET
20    (The maximum number of messages ever processed by LNET concurrently)
21 E - Number of LNET errors
22 S - Total size (length) of messages sent in bytes/
23     Number of messages sent
24 R - Total size (length) of messages received in bytes/
25     Number of messages received
26 F - Total size (length) of messages routed in bytes/
27     Number of messages routed
28 D - Total size (length) of messages dropped in bytes/
29     Number of messages dropped
30 .fi
31 .LP
32 When an
33 .I interval
34 is specified, additional lines of statistics are printed including the following fields:
35 .LP
36 .nf
37 M - Number of messages currently being processed by LNET
38    (The maximum number of messages ever processed by LNET concurrently)
39 E - Number of LNET errors per second
40 S - Rate of data sent in Mbytes per second/
41     Count of messages sent per second
42 R - Rate of data received in Mbytes per second/
43     Count of messages received per second
44 F - Rate of data routed in Mbytes per second/
45     Count of messages routed per second
46 D - Rate of data dropped in Mbytes per second/
47     Count of messages dropped per second
48 .SH EXAMPLE
49 .nf
50 # routerstat 1
51 M 0(13) E 0 S 117379184/4250 R 878480/4356 F 0/0 D 0/0
52 M   0( 13) E 0 S    7.00/     7 R    0.00/    14 F    0.00/     0 D 0.00/0
53 M   0( 13) E 0 S    7.00/     7 R    0.00/    14 F    0.00/     0 D 0.00/0
54 M   0( 13) E 0 S    8.00/     8 R    0.00/    16 F    0.00/     0 D 0.00/0
55 M   0( 13) E 0 S    7.00/     7 R    0.00/    14 F    0.00/     0 D 0.00/0
56 M   0( 13) E 0 S    7.00/     7 R    0.00/    14 F    0.00/     0 D 0.00/0
57 M   0( 13) E 0 S    7.00/     7 R    0.00/    14 F    0.00/     0 D 0.00/0
58 M   0( 13) E 0 S    7.00/     7 R    0.00/    14 F    0.00/     0 D 0.00/0
59 M   0( 13) E 0 S    8.00/     8 R    0.00/    16 F    0.00/     0 D 0.00/0
60 M   0( 13) E 0 S    7.00/     7 R    0.00/    14 F    0.00/     0 D 0.00/0
61 ...
62 .fi
63 .SH FILES
64 /proc/sys/lnet/stats