1
.TH "IP\-TCP_METRICS" 8 "23 Aug 2012" "iproute2" "Linux"
3
ip-tcp_metrics \- management for TCP Metrics
12
.RI "{ " COMMAND " | "
17
.BR "ip tcp_metrics" " { " show " | " flush " }
21
.BR "ip tcp_metrics delete " [ " address " ]
26
.RB "[ [ " address " ] "
31
is used to manipulate entries in the kernel that keep TCP information
32
for IPv4 and IPv6 destinations. The entries are created when
33
TCP sockets want to share information for destinations and are
34
stored in a cache keyed by the destination address. The saved
35
information may include values for metrics (initially obtained from
36
routes), recent TSVAL for TIME-WAIT recycling purposes, state for the
37
Fast Open feature, etc.
38
For performance reasons the cache can not grow above configured limit
39
and the older entries are replaced with fresh information, sometimes
40
reclaimed and used for new destinations. The kernel never removes
41
entries, they can be flushed only with this tool.
43
.SS ip tcp_metrics show - show cached entries
46
.BI address " PREFIX " (default)
47
IPv4/IPv6 prefix or address. If no prefix is provided all entries are shown.
50
The output may contain the following information:
52
.BI age " <S.MMM>" sec
53
- time after the entry was created, reset or updated with metrics
54
from sockets. The entry is reset and refreshed on use with metrics from
55
route if the metrics are not updated in last hour. Not all cached values
56
reset the age on update.
61
.BI fo_cookie " <HEX-STRING>"
62
- Cookie value received in SYN-ACK to be used by Fast Open for next SYNs
65
- MSS value received in SYN-ACK to be used by Fast Open for next SYNs
67
.BI fo_syn_drops " <N>/<S.MMM>" "sec ago"
68
- Number of drops of initial outgoing Fast Open SYNs with data
69
detected by monitoring the received SYN-ACK after SYN retransmission.
70
The seconds show the time after last SYN drop and together with
71
the drop count can be used to disable Fast Open for some time.
74
- Reordering metric value
82
.BI ssthresh " <SSTHRESH>"
83
- SSTHRESH metric value
85
.BI tw_ts " <TSVAL>/<SEC>" "sec ago"
86
- recent TSVAL and the seconds after saving it into TIME-WAIT socket
88
.SS ip tcp_metrics delete - delete single entry
91
.BI address " ADDRESS " (default)
92
IPv4/IPv6 address. The address is a required argument.
94
.SS ip tcp_metrics flush - flush entries
95
This command flushes the entries selected by some criteria.
98
This command has the same arguments as
103
ip tcp_metrics show address 192.168.0.0/24
105
Shows the entries for destinations from subnet
108
ip tcp_metrics show 192.168.0.0/24
110
The same but address keyword is optional
115
Show all is the default action
118
ip tcp_metrics delete 192.168.0.1
120
Removes the entry for 192.168.0.1 from cache.
123
ip tcp_metrics flush 192.168.0.0/24
125
Removes entries for destinations from subnet
128
ip tcp_metrics flush all
130
Removes all entries from cache
133
ip -6 tcp_metrics flush all
135
Removes all IPv6 entries from cache keeping the IPv4 entries.
143
Original Manpage by Julian Anastasov <ja@ssi.bg>