.\" Man page generated from reStructuredText.
.
.TH "OVS-L3PING" "8" "Oct 20, 2021" "2.15" "Open vSwitch"
.SH NAME
ovs-l3ping \- check network deployment for L3 tunneling problems
.
.nr rst2man-indent-level 0
.
.de1 rstReportMargin
\\$1 \\n[an-margin]
level \\n[rst2man-indent-level]
level margin: \\n[rst2man-indent\\n[rst2man-indent-level]]
-
\\n[rst2man-indent0]
\\n[rst2man-indent1]
\\n[rst2man-indent2]
..
.de1 INDENT
.\" .rstReportMargin pre:
. RS \\$1
. nr rst2man-indent\\n[rst2man-indent-level] \\n[an-margin]
. nr rst2man-indent-level +1
.\" .rstReportMargin post:
..
.de UNINDENT
. RE
.\" indent \\n[an-margin]
.\" old: \\n[rst2man-indent\\n[rst2man-indent-level]]
.nr rst2man-indent-level -1
.\" new: \\n[rst2man-indent\\n[rst2man-indent-level]]
.in \\n[rst2man-indent\\n[rst2man-indent-level]]u
..
.SH SYNOPSIS
.sp
\fBovs\-l3ping \-s <TunnelRemoteIP>,<InnerIP>[/<mask>] \-t <tunnelmode>\fP
.sp
\fBovs\-l3ping \-s <TunnelRemoteIP>,<InnerIP>[/<mask>][:<ControlPort>] \-t
<tunnelmode>\fP
.sp
\fBovs\-l3ping \-c <TunnelRemoteIP>,<InnerIP>[/<mask>],<RemoteInnerIP> \-t
<tunnelmode>\fP
.sp
\fBovs\-l3ping \-c
<TunnelRemoteIP>,<InnerIP>[/<mask>][:<ControlPort>[:<DataPort>]],<RemoteInnerIP>[:<ControlPort>[:<DataPort>]]
[\-b <targetbandwidth>] [\-i <testinterval>]
\-t <tunnelmode>\fP
.sp
\fBovs\-l3ping \-h | \-\-help\fP
.sp
\fBovs\-l3ping \-V | \-\-version\fP
.SH DESCRIPTION
.sp
The \fBovs\-l3ping\fP program may be used to check for problems that
could be caused by invalid routing policy, misconfigured firewall in
the tunnel path or a bad NIC driver.  On one of the nodes, run
\fBovs\-l3ping\fP in server mode and on the other node run it in client
mode.  The client and server will establish L3 tunnel, over which
client will give further testing instructions. The \fBovs\-l3ping\fP
client will perform UDP and TCP tests.  This tool is different from
\fBovs\-test\fP that it encapsulates XML/RPC control connection over the
tunnel, so there is no need to open special holes in firewall.
.sp
UDP tests can report packet loss and achieved bandwidth for various
datagram sizes. By default target bandwidth for UDP tests is 1Mbit/s.
.sp
TCP tests report only achieved bandwidth, because kernel TCP stack
takes care of flow control and packet loss.
.SS Client Mode
.sp
An \fBovs\-l3ping\fP client will create a L3 tunnel and connect over it
to the \fBovs\-l3ping\fP server to schedule the tests.  <TunnelRemoteIP>
is the peer’s IP address, where tunnel will be terminated.  <InnerIP>
is the address that will be temporarily assigned during testing.  All
test traffic originating from this IP address to the <RemoteInnerIP>
will be tunneled.  It is possible to override default <ControlPort>
and <DataPort>, if there is any other application that already listens
on those two ports.
.SS Server Mode
.sp
To conduct tests, \fBovs\-l3ping\fP server must be running.  It is
required that both client and server <InnerIP> addresses are in the
same subnet.  It is possible to specify <InnerIP> with netmask in CIDR
format.
.SH OPTIONS
.sp
One of \fB\-s\fP or \fB\-c\fP is required.  The \fB\-t\fP option is
also required.
.INDENT 0.0
.IP \(bu 2
\fB\-s <TunnelRemoteIP>,<InnerIP>[/<mask>][:<ControlPort>]\fP or
\fB\-\-server <TunnelRemoteIP>,<InnerIP>[/<mask>][:<ControlPort>]\fP
.sp
Run in server mode and create L3 tunnel with the client that will be
accepting tunnel at <TunnelRemoteIP> address.  The socket on
\fB<InnerIP>[:<ControlPort>]\fP will be used to receive further
instructions from the client.
.IP \(bu 2
\fB\-c
<TunnelRemoteIP>,<InnerIP>[/<mask>][:<ControlPort>[:<DataPort>]],<RemoteInnerIP>[:<ControlPort>[:<DataPort>]]\fP
or \fB\-\-client
<TunnelRemoteIP>,<InnerIP>[/<mask>][:<ControlPort>[:<DataPort>]],<RemoteInnerIP>[:<ControlPort>[:<DataPort>]]\fP
.sp
Run in client mode and create L3 tunnel with the server on
<TunnelRemoteIP>.  The client will use <InnerIP> to generate test
traffic with the server’s <RemoteInnerIP>.
.IP \(bu 2
\fB\-b <targetbandwidth>\fP or \fB\-\-bandwidth <targetbandwidth>\fP
.sp
Target bandwidth for UDP tests. The <targetbandwidth> must be given
in bits per second.  Use postfix M or K to alter the target
bandwidth magnitude.
.IP \(bu 2
\fB\-i <testinterval>\fP or \fB\-\-interval <testinterval>\fP
.sp
How long each test should run. By default 5 seconds.
.IP \(bu 2
\fB\-t <tunnelmode>\fP or \fB\-\-tunnel\-mode <tunnelmode>\fP
.sp
Specify the tunnel type. This option must match on server and
client.
.IP \(bu 2
\fB\-h\fP or \fB\-\-help\fP
.sp
Prints a brief help message to the console.
.IP \(bu 2
\fB\-V\fP or \fB\-\-version\fP
.sp
Prints version information to the console.
.UNINDENT
.SH EXAMPLES
.sp
On host 192.168.122.220 start \fBovs\-l3ping\fP in server mode.  This command
will create a temporary GRE tunnel with the host 192.168.122.236 and assign
10.1.1.1/28 as the inner IP address, where client will have to connect:
.INDENT 0.0
.INDENT 3.5
.sp
.nf
.ft C
ovs\-l3ping \-s 192.168.122.236,10.1.1.1/28 \-t gre
.ft P
.fi
.UNINDENT
.UNINDENT
.sp
On host 192.168.122.236 start \fBovs\-l3ping\fP in client mode.  This command
will use 10.1.1.2/28 as the local inner IP address and will connect over the
L3 tunnel to the server’s inner IP address at 10.1.1.1:
.INDENT 0.0
.INDENT 3.5
.sp
.nf
.ft C
ovs\-l3ping \-c 192.168.122.220,10.1.1.2/28,10.1.1.1 \-t gre
.ft P
.fi
.UNINDENT
.UNINDENT
.SH SEE ALSO
.sp
\fBovs\-vswitchd(8)\fP, \fBovs\-ofctl(8)\fP, \fBovs\-vsctl(8)\fP,
\fBovs\-vlan\-test(8)\fP, \fBovs\-test(8)\fP, \fBethtool(8)\fP, \fBuname(1)\fP\&.
.SH AUTHOR
The Open vSwitch Development Community
.SH COPYRIGHT
2021, The Open vSwitch Development Community
.\" Generated by docutils manpage writer.
.