1OVS-TCPDUMP(8)                   Open vSwitch                   OVS-TCPDUMP(8)
2
3
4

NAME

6       ovs-tcpdump - Dump traffic from an Open vSwitch port using tcpdump
7

SYNOPSIS

9       ovs-tcpdump -i <port> <tcpdump options>...
10

DESCRIPTION

12       ovs-tcpdump  creates switch mirror ports in the ovs-vswitchd daemon and
13       executes tcpdump to listen against those ports. When  the  tcpdump  in‐
14       stance exits, it then cleans up the mirror port it created.
15
16       ovs-tcpdump  will  not allow multiple mirrors for the same port. It has
17       some logic to parse the current  configuration  and  prevent  duplicate
18       mirrors.
19
20       The -i option may not appear multiple times.
21
22       It  is important to note that under Linux-based kernels, tap devices do
23       not receive packets unless the specific tuntap device has  been  opened
24       by  an  application.   This  requires  CAP_NET_ADMIN privileges, so the
25       ovs-tcpdump command must be run as a user with such  permissions  (this
26       is usually a super-user).
27

OPTIONS

29       • -h or --help
30
31         Prints a brief help message to the console.
32
33       • -V or --version
34
35         Prints version information to the console.
36
37       • --db-sock <socket>
38
39         The  Open  vSwitch  database socket connection string. The default is
40         unix:<rundir>/db.sock.
41
42       • --dump-cmd <command>
43
44         The command to run instead of tcpdump.
45
46       • -i or --interface
47
48         The interface for which a mirror port should be created, and  packets
49         should be dumped.
50
51       • --mirror-to
52
53         The name of the interface which should be the destination of the mir‐
54         rored packets. The default is mi<port>.
55
56       • --span
57
58         If specified, mirror all ports (optional).
59

SEE ALSO

61       ovs-appctl(8),  ovs-vswitchd(8),  ovs-pcap(1),  ovs-tcpundump(1),  tcp‐
62       dump(8), wireshark(8).
63

AUTHOR

65       The Open vSwitch Development Community
66

68       2016-2023, The Open vSwitch Development Community
69
70
71
72
733.2                              Oct 04, 2023                   OVS-TCPDUMP(8)
Impressum