An Introduction To Using Tcpdump at The Linux Command Line Opensourcecom
An Introduction To Using Tcpdump at The Linux Command Line Opensourcecom
com
1. Installation on Linux
Tcpdump is included with several Linux distributions, so chances are, you already have it
installed. Check whether tcpdump is installed on your system with the following
command:
$ which tcpdump
/usr/sbin/tcpdump
If tcpdump is not installed, you can install it but using your distribution's package
manager. For example, on CentOS or Red Hat Enterprise Linux, like this:
Tcpdump requires libpcap, which is a library for network packet capture. If it's not
installed, it will be automatically added as a dependency.
$ sudo tcpdump -D
1.eth0
2.virbr0
3.eth1
4.any (Pseudo-device that captures on all interfaces)
5.lo [Loopback]
In the example above, you can see all the interfaces available in my machine. The
special interface any allows capturing in any active interface.
Let's use it to start capturing some packets. Capture all packets in any interface by
running this command:
.
.
Tcpdump continues to capture packets until it receives an interrupt signal. You can
interrupt capturing by pressing Ctrl+C. As you can see in this example, tcpdump captured
more than 9,000 packets. In this case, since I am connected to this server using ssh,
tcpdump captured all these packets. To limit the number of packets captured and stop
tcpdump, use the -c (for count) option:
In this case, tcpdump stopped capturing automatically after capturing five packets. This is
useful in different scenarios—for instance, if you're troubleshooting connectivity and
capturing a few initial packets is enough. This is even more useful when we apply filters
to capture specific packets (shown below).
By default, tcpdump resolves IP addresses and ports into names, as shown in the
previous example. When troubleshooting network issues, it is often easier to use the IP
addresses and port numbers; disable name resolution by using the option -n and port
resolution with -nn:
5 packets captured
6 packets received by filter
0 packets dropped by kernel
As shown above, the capture output now displays the IP addresses and port numbers.
This also prevents tcpdump from issuing DNS lookups, which helps to lower network
traffic while troubleshooting network issues.
Now that you're able to capture network packets, let's explore what this output means.
Tcpdump is capable of capturing and decoding many different protocols, such as TCP,
UDP, ICMP, and many more. While we can't cover all of them here, to help you get
started, let's explore the TCP packet. You can find more details about the different
protocol formats in tcpdump's manual pages. A typical TCP packet captured by tcpdump
looks like this:
The fields may vary depending on the type of packet being sent, but this is the general
format.
The first field, 08:41:13.729687, represents the timestamp of the received packet as per the
local clock.
Next, IP represents the network layer protocol—in this case, IPv4. For IPv6 packets, the
value is IP6.
The next field, 192.168.64.28.22, is the source IP address and port. This is followed by the
destination IP address and port, represented by 192.168.64.1.41916.
After the source and destination, you can find the TCP Flags Flags [P.]. Typical values
for this field include:
. ACK Acknowledgment
This field can also be a combination of these values, such as [S.] for a SYN-ACK packet.
Next is the sequence number of the data contained in the packet. For the first packet
captured, this is an absolute number. Subsequent packets use a relative number to make
it easier to follow. In this example, the sequence is seq 196:568, which means this packet
contains bytes 196 to 568 of this flow.
This is followed by the Ack Number: ack 1. In this case, it is 1 since this is the side
sending data. For the side receiving data, this field represents the next expected byte
(data) on this flow. For example, the Ack number for the next packet in this flow would be
568.
The next field is the window size win 309, which represents the number of bytes available
in the receiving buffer, followed by TCP options such as the MSS (Maximum Segment
Size) or Window Scale. For details about TCP protocol options, consult Transmission
Control Protocol (TCP) Parameters.
Finally, we have the packet length, length 372, which represents the length, in bytes, of
the payload data. The length is the difference between the last and first bytes in the
sequence number.
Now let's learn how to filter packets to narrow down results and make it easier to
troubleshoot specific issues.
4. Filtering packets
As mentioned above, tcpdump can capture too many packets, some of which are not
even related to the issue you're troubleshooting. For example, if you're troubleshooting a
connectivity issue with a web server you're not interested in the SSH traffic, so removing
the SSH packets from the output makes it easier to work on the real issue.
One of tcpdump's most powerful features is its ability to filter the captured packets using
a variety of parameters, such as source and destination IP addresses, ports, protocols,
etc. Let's look at some of the most common ones.
Protocol
To filter packets based on protocol, specifying the protocol in the command line. For
example, capture ICMP packets only by using this command:
$ ping opensource.com
PING opensource.com (54.204.39.132) 56(84) bytes of data.
64 bytes from ec2-54-204-39-132.compute-1.amazonaws.com (54.204.39.132): icmp_seq=1
Back in the tcpdump capture, notice that tcpdump captures and displays only the ICMP-
related packets. In this case, tcpdump is not displaying name resolution packets that
were generated when resolving the name opensource.com:
Host
Limit capture to only packets related to a specific host by using the host filter:
In this example, tcpdump captures and displays only packets to and from host
54.204.39.132.
Port
To filter packets based on the desired service or port, use the port filter. For example,
capture packets related to a web (HTTP) service by using this command:
Source IP/hostname
You can also filter packets based on the source or destination IP Address or hostname.
For example, to capture packets from host 192.168.122.98:
Notice that tcpdumps captured packets with source IP address 192.168.122.98 for multiple
services such as name resolution (port 53) and HTTP (port 80). The response packets
are not displayed since their source IP is different.
Conversely, you can use the dst filter to filter by destination IP/hostname:
Complex expressions
You can also combine filters by using the logical operators and and or to create more
You can create more complex expressions by grouping filter with parentheses. In this
case, enclose the entire filter expression with quotation marks to prevent the shell from
confusing them with shell expressions:
$ sudo tcpdump -i any -c5 -nn "port 80 and (src 192.168.122.98 or src 54.204.39.132
tcpdump: verbose output suppressed, use -v or -vv for full protocol decode
listening on any, link-type LINUX_SLL (Linux cooked), capture size 262144 bytes
10:10:37.602214 IP 192.168.122.98.39346 > 54.204.39.132.80: Flags [S], seq 87110867
10:10:37.650651 IP 54.204.39.132.80 > 192.168.122.98.39346: Flags [S.], seq 8547531
10:10:37.650708 IP 192.168.122.98.39346 > 54.204.39.132.80: Flags [.], ack 1, win 2
10:10:37.651097 IP 192.168.122.98.39346 > 54.204.39.132.80: Flags [P.], seq 1:113,
10:10:37.692900 IP 54.204.39.132.80 > 192.168.122.98.39346: Flags [.], ack 113, win
5 packets captured
5 packets received by filter
0 packets dropped by kernel
In this example, we're filtering packets for HTTP service only (port 80) and source IP
addresses 192.168.122.98 or 54.204.39.132. This is a quick way of examining both sides of
the same flow.
In the previous examples, we're checking only the packets' headers for information such
as source, destinations, ports, etc. Sometimes this is all we need to troubleshoot network
connectivity issues. Sometimes, however, we need to inspect the content of the packet to
ensure that the message we're sending contains what we need or that we received the
expected response. To see the packet content, tcpdump provides two additional flags: -X
to print content in hex, and ASCII or -A to print the content in ASCII.
For example, inspect the HTTP content of a web request like this:
................
13:02:14.951199 IP 54.204.39.132.80 > 192.168.122.98.39366: Flags [.], ack 113, win
E..4.F@./.."6.'...zb.P..o..'.......9.2.....
.R.a....................
13:02:14.955030 IP 54.204.39.132.80 > 192.168.122.98.39366: Flags [P.], seq 1:643,
E....G@./...6.'...zb.P..o..'.......9.......
.R.b....HTTP/1.1 302 Found
Server: nginx
Date: Sun, 23 Sep 2018 17:02:14 GMT
Content-Type: text/html; charset=iso-8859-1
Content-Length: 207
X-Content-Type-Options: nosniff
Location: https://opensource.com/
Cache-Control: max-age=1209600
Expires: Sun, 07 Oct 2018 17:02:14 GMT
X-Request-ID: v-6baa3acc-bf52-11e8-9195-22000ab8cf2d
X-Varnish: 632951979
Age: 0
Via: 1.1 varnish (Varnish/5.2)
X-Cache: MISS
Connection: keep-alive
This is helpful for troubleshooting issues with API calls, assuming the calls are using
plain HTTP. For encrypted connections, this output is less useful.
Another useful feature provided by tcpdump is the ability to save the capture to a file so
you can analyze the results later. This allows you to capture packets in batch mode
overnight, for example, and verify the results in the morning. It also helps when there are
too many packets to analyze since real-time capture can occur too fast.
To save packets to a file instead of displaying them on screen, use the option -w (for
write):
This command saves the output in a file named webserver.pcap. The .pcap extension
stands for "packet capture" and is the convention for this file format.
As shown in this example, nothing gets displayed on-screen, and the capture finishes
after capturing 10 packets, as per the option -c10. If you want some feedback to ensure
packets are being captured, use the option -v.
Tcpdump creates a file in binary format so you cannot simply open it with a text editor. To
read the contents of the file, execute tcpdump with the -r (for read) option:
Since you're no longer capturing the packets directly from the network interface, sudo is
not required to read the file.
You can also use any of the filters we've discussed to filter the content from the file, just
as you would with real-time data. For example, inspect the packets in the capture file
What's next?
These basic features of tcpdump will help you get started with this powerful and versatile
tool. To learn more, consult the tcpdump website and man pages.
The tcpdump command line interface provides great flexibility for capturing and analyzing
network traffic. If you need a graphical tool to understand more complex flows, look at
Wireshark.
One benefit of Wireshark is that it can read .pcap files captured by tcpdump. You can use
tcpdump to capture packets in a remote machine that does not have a GUI and analyze
the result file with Wireshark, but that is a topic for another day.
This article was originally published in October 2018 and has been updated by Seth
Kenlon.
a Linux enthusiast for over 20 years. He is currently interested in hacking stuff using
the Go Programming...
• More about me
Recommended reading
As a Network engineer, this has been one of the greatest post I have ever read on this blog.
Nice share, Ricardo. I used use this tool before I knew Wireshark. This makes me want to make a
nostalgic with Tdpdump
My guess is it's because autocorrect, but several times you use "packages" where I think you mean
"packets." Am I wrong? Very good article, that minor nit aside.
Thank you for your feedback ! You're right. I will get it fixed.
Find us:
Privacy Policy | Terms of Use | Contact | Meet the Team | Visit opensource.org
For more discussion on open source and the role of the CIO in the enterprise, join us at The
EnterprisersProject.com.
The opinions expressed on this website are those of each author, not of the author's employer or
of Red Hat.
Opensource.com aspires to publish all content under a Creative Commons license but may not be
able to do so in all cases. You are responsible for ensuring that you have the necessary
permission to reuse any work on this site. Red Hat and the Red Hat logo are trademarks of Red