ip-tcp_metrics − management for TCP Metrics


ip [ OPTIONS ] tcp_metrics { COMMAND | help }

ip tcp_metrics { show | flush } SELECTOR

ip tcp_metrics delete [ address ] ADDRESS

SELECTOR := [ [ address ] PREFIX ]


ip tcp_metrics is used to manipulate entries in the kernel that keep TCP information for IPv4 and IPv6 destinations. The entries are created when TCP sockets want to share information for destinations and are stored in a cache keyed by the destination address. The saved information may include values for metrics (initially obtained from routes), recent TSVAL for TIME-WAIT recycling purposes, state for the Fast Open feature, etc. For performance reasons the cache can not grow above configured limit and the older entries are replaced with fresh information, sometimes reclaimed and used for new destinations. The kernel never removes entries, they can be flushed only with this tool.

ip tcp_metrics show - show cached entries
PREFIX (default)

IPv4/IPv6 prefix or address. If no prefix is provided all entries are shown.

The output may contain the following information:

age <S.MMM>sec - time after the entry was created, reset or updated with metrics from sockets. The entry is reset and refreshed on use with metrics from route if the metrics are not updated in last hour. Not all cached values reset the age on update.

cwnd <N> - CWND metric value

fo_cookie <HEX-STRING> - Cookie value received in SYN-ACK to be used by Fast Open for next SYNs

fo_mss <N> - MSS value received in SYN-ACK to be used by Fast Open for next SYNs

fo_syn_drops <N>/<S.MMM>sec ago - Number of drops of initial outgoing Fast Open SYNs with data detected by monitoring the received SYN-ACK after SYN retransmission. The seconds show the time after last SYN drop and together with the drop count can be used to disable Fast Open for some time.

reordering <N> - Reordering metric value

rtt <N>us - RTT metric value

rttvar <N>us - RTTVAR metric value

ssthresh <SSTHRESH> - SSTHRESH metric value

tw_ts <TSVAL>/<SEC>sec ago - recent TSVAL and the seconds after saving it into TIME-WAIT socket

ip tcp_metrics delete - delete single entry
ADDRESS (default)

IPv4/IPv6 address. The address is a required argument.

ip tcp_metrics flush - flush entries
This command flushes the entries selected by some criteria.

This command has the same arguments as show.


ip tcp_metrics show address

Shows the entries for destinations from subnet

ip tcp_metrics show

The same but address keyword is optional

ip tcp_metrics

Show all is the default action

ip tcp_metrics delete

Removes the entry for from cache.

ip tcp_metrics flush

Removes entries for destinations from subnet

ip tcp_metrics flush all

Removes all entries from cache

ip -6 tcp_metrics flush all

Removes all IPv6 entries from cache keeping the IPv4 entries.




Original Manpage by Julian Anastasov <ja@ssi.bg>


Personal Opportunity - Free software gives you access to billions of dollars of software at no cost. Use this software for your business, personal use or to develop a profitable skill. Access to source code provides access to a level of capabilities/information that companies protect though copyrights. Open source is a core component of the Internet and it is available to you. Leverage the billions of dollars in resources and capabilities to build a career, establish a business or change the world. The potential is endless for those who understand the opportunity.

Business Opportunity - Goldman Sachs, IBM and countless large corporations are leveraging open source to reduce costs, develop products and increase their bottom lines. Learn what these companies know about open source and how open source can give you the advantage.

Free Software

Free Software provides computer programs and capabilities at no cost but more importantly, it provides the freedom to run, edit, contribute to, and share the software. The importance of free software is a matter of access, not price. Software at no cost is a benefit but ownership rights to the software and source code is far more significant.

Free Office Software - The Libre Office suite provides top desktop productivity tools for free. This includes, a word processor, spreadsheet, presentation engine, drawing and flowcharting, database and math applications. Libre Office is available for Linux or Windows.

Free Books

The Free Books Library is a collection of thousands of the most popular public domain books in an online readable format. The collection includes great classical literature and more recent works where the U.S. copyright has expired. These books are yours to read and use without restrictions.

Source Code - Want to change a program or know how it works? Open Source provides the source code for its programs so that anyone can use, modify or learn how to write those programs themselves. Visit the GNU source code repositories to download the source.


Study at Harvard, Stanford or MIT - Open edX provides free online courses from Harvard, MIT, Columbia, UC Berkeley and other top Universities. Hundreds of courses for almost all major subjects and course levels. Open edx also offers some paid courses and selected certifications.

Linux Manual Pages - A man or manual page is a form of software documentation found on Linux/Unix operating systems. Topics covered include computer programs (including library and system calls), formal standards and conventions, and even abstract concepts.