mir/ovs
2
0
Fork 0
mirror of https://github.com/openvswitch/ovs synced 2025-08-22 01:51:26 +00:00
Code Issues Releases Wiki Activity
ovs/utilities/automake.mk

161 lines
4.6 KiB
Makefile
Raw Normal View History

Import from old repository commit 61ef2b42a9c4ba8e1600f15bb0236765edc2ad45.
2009-07-08 13:19:16 -07:00
bin_PROGRAMS += \
utilities/ovs-appctl \
test-controller: Rename to ovs-testcontroller, again install. mininet uses the Open vSwitch controller by default, for testing. CC: 757761@bugs.debian.org Reported-at: https://bugs.debian.org/757761 Requested-by: Tomasz Buchert <tomasz.buchert@inria.fr> Requested-by: Dariusz Dwornikowski <dariusz.dwornikowski@cs.put.poznan.pl> Signed-off-by: Ben Pfaff <blp@nicira.com> Acked-by: Justin Pettit <jpettit@nicira.com>
2014-08-15 10:32:50 -07:00
utilities/ovs-testcontroller \
Import from old repository commit 61ef2b42a9c4ba8e1600f15bb0236765edc2ad45.
2009-07-08 13:19:16 -07:00
utilities/ovs-dpctl \
utilities/ovs-ofctl \
Build ovs-wdt or nlmon utilities only on Linux. These utilities are Linux-specific.
2010-05-26 10:25:19 -07:00
utilities/ovs-vsctl
docker: Integrate docker containers with Open vSwitch. Open vSwitch does not have native integration with Docker. INSTALL.Docker explains how Open vSwitch can be integrated with docker non-natively. ovs-docker is a helper script to add network interfaces to docker containers and to attach them as ports to OVS bridge. This script can be further enhanced as we understand different use cases. Signed-off-by: Gurucharan Shetty <gshetty@nicira.com> Acked-by: Ben Pfaff <blp@nicira.com>
2014-10-14 00:51:52 -07:00
bin_SCRIPTS += utilities/ovs-docker \
Permit to build OVS with only Python3 installed This commit renames HAVE_PYTHON to HAVE_PYTHON2 and PYTHON to PYTHON2 and adds HAVE_PYTHON and PYTHON with a different semantics: - If PYTHON environment variable is set, use it as PYTHON - If a python2 interpreter is available, PYTHON became the python2 interpreter - If a python3 interpreter is available, PYTHON became the python3 interpreter PYTHON is only used to run the python scripts needed by the build system NOTE: Since currently most of the utilities and bugtool doesn't support Python3, they're installed only if python2 is available. This will be fixed in later commits. Signed-off-by: Timothy Redaelli <tredaelli@redhat.com> Signed-off-by: Ben Pfaff <blp@ovn.org>
2018-06-22 20:04:10 +02:00
utilities/ovs-pki \
utilities: Install ovs-tcp{dump, undump} also when only Python3 is enabled Since commit 793bdb6c0500 ("ovs-tcpdump: Fix incompatibilities with python3") and commit 227abb77d3d1 ("ovs-tcpundump: Fix incompatibilities with python3") ovs-tcpdump and ovs-tcpdump works with Python3 as well. This commit allows ovs-tcpdump and ovs-tcpundump to be installed also when only Python3 is enabled. Signed-off-by: Timothy Redaelli <tredaelli@redhat.com> Signed-off-by: Ben Pfaff <blp@ovn.org>
2018-08-03 20:28:08 +02:00
utilities/ovs-pcap \
utilities/ovs-tcpdump \
Require Python 3 and remove support for Python 2. Python 2 reaches end-of-life on January 1, 2020, which is only a few months away. This means that OVS needs to stop depending on in the next release that should occur roughly that same time. Therefore, this commit removes all support for Python 2. It also makes Python 3 a mandatory build dependency. Some of the interesting consequences: - HAVE_PYTHON, HAVE_PYTHON2, and HAVE_PYTHON3 conditionals have been removed, since we now know that Python3 is available. - $PYTHON and $PYTHON2 are removed, and $PYTHON3 is always available. - Many tests for Python 2 support have been removed, and the ones that depended on Python 3 now run unconditionally. This allowed several macros in the testsuite to be removed, making the code clearer. This does make some of the changes to the testsuite files large due to indentation level changes. - #! lines for Python now use /usr/bin/python3 instead of /usr/bin/python. - Packaging depends on Python 3 packages. Acked-by: Numan Siddique <nusiddiq@redhat.com> Tested-by: Numan Siddique <nusiddiq@redhat.com> Signed-off-by: Ben Pfaff <blp@ovn.org>
2019-09-20 08:30:42 -07:00
utilities/ovs-tcpundump \
utilities: a top like tool for ovs-dpctl dump-flows. This python script summarizes ovs-dpctl dump-flows content by aggregating the number of packets, total bytes and occurrence of the following fields: - Datapath in_port - Ethernet type - Source and destination MAC addresses - IP protocol - Source and destination IPv4 addresses - Source and destination IPv6 addresses - UDP and TCP destination port - Tunnel source and destination addresses Testing included confirming both mega-flows and non-megaflows are properly parsed. Bit masks are applied in the case of mega-flows prior to aggregation. Test --script parameter which runs in non-interactive mode. Tested syntax against python 2.4.3, 2.6 and 2.7. Confirmed script passes pep8 and pylint run as: pylint --disable=I0011 --include-id=y --reports=n This tool has been added to these distribution: - add ovs-dpctl-top to debian distribution - add ovs-dpctl-top to rpm distribution. - add ovs-dpctl-top to XenServer RPM. Signed-off-by: Mark Hamilton <mhamilton@nicira.com> Signed-off-by: Gurucharan Shetty <gshetty@nicira.com>
2013-09-13 15:50:48 -07:00
utilities/ovs-dpctl-top \
ovs-l3ping: A new test utility that allows to detect L3 tunneling issues ovs-l3ping is similar to ovs-test, but the main difference is that it does not require administrator to open firewall holes for the XML/RPC control connection. This is achieved by encapsulating the Control Connection over the L3 tunnel itself. This tool is not intended as a replacement for ovs-test, because ovs-test covers much broader set of test cases. Sample usage: Node1: ovs-l3ping -s 192.168.122.236,10.1.1.1 -t gre Node2: ovs-l3ping -c 192.168.122.220,10.1.1.2,10.1.1.1 -t gre Issue#11791 Signed-off-by: Ansis Atteka <aatteka@nicira.com>
2012-06-28 15:52:40 -07:00
utilities/ovs-l3ping \
utilities: New helper ovs-parse-backtrace. The new ovs-parse-backtrace utility makes the output of ovs-appctl backtrace more human readable by removing duplicate traces and converting addresses to function names. Signed-off-by: Ethan Jackson <ethan@nicira.com>
2012-10-15 12:42:48 -07:00
utilities/ovs-parse-backtrace \
ovs-test: A new tool that allows to diagnose connectivity and performance issues This tool will be a replacement for the current ovs-vlan-test utility. Besides from connectivity issues it will also be able to detect performance related issues in Open vSwitch setups. Currently it uses UDP and TCP protocols for stressing. Issue #6976
2011-10-31 14:56:08 -07:00
utilities/ovs-test \
utilities: Implement ovs-vlan-test script This patch implements a script which may be used to check for connectivity issues caused by bugs in Linux drivers relating to VLAN traffic.
2010-12-07 18:49:28 -08:00
utilities/ovs-vlan-test
ovs-ctl: Make "force-reload-kmod" warn when DHCP clients must be restarted. This should make it more obvious when the admin needs to restart a DHCP client (or other daemon). Without this, unless the admin carefully reads the documentation, the first notice he gets about a need to restart the DHCP client can easily be when the lease expires and the machine drops off the network. Bug #5391. Tested-by: Gurucharan Shetty <gshetty@nicira.com> Suggested-by: Duffie Cooley <dcooley@nicira.com> Signed-off-by: Ben Pfaff <blp@nicira.com>
2012-05-01 15:36:44 -07:00
scripts_SCRIPTS += \
utilities/ovs-check-dead-ifs \
utilities/ovs-ctl \
ovs-kmod-ctl: introduce a kernel module load script Currently, Open vSwitch on linux embeds the logic of loading and unloading kernel modules into the ovs-ctl and ovs-lib script files. This works, but it means that there is no way to leverage extended filesystem attributes to grant fine grain permissions relating to module loading. The split out utility 'ovs-kmod-ctl' will be used in an upcoming commit for RHEL-based distributions to have a separate transition domain that will allow module loading to be given to a separate selinux domain from the openvswitch_t domain. Acked-by: Ansis Atteka <aatteka@ovn.org> Acked-by: Timothy Redaelli <tredaelli@redhat.com> Signed-off-by: Aaron Conole <aconole@redhat.com>
2018-06-01 14:28:44 -04:00
utilities/ovs-kmod-ctl \
ovs-ctl: Make "force-reload-kmod" warn when DHCP clients must be restarted. This should make it more obvious when the admin needs to restart a DHCP client (or other daemon). Without this, unless the admin carefully reads the documentation, the first notice he gets about a need to restart the DHCP client can easily be when the lease expires and the machine drops off the network. Bug #5391. Tested-by: Gurucharan Shetty <gshetty@nicira.com> Suggested-by: Duffie Cooley <dcooley@nicira.com> Signed-off-by: Ben Pfaff <blp@nicira.com>
2012-05-01 15:36:44 -07:00
utilities/ovs-save
utilites: rename ovs-lib.sh to ovs-lib Rename this helper script to simply ovs-lib, since it's primarily a library of helper functions. Signed-off-by: Chris Wright <chrisw@sous-sol.org> Signed-off-by: Ben Pfaff <blp@nicira.com>
2011-12-08 23:36:05 -08:00
scripts_DATA += utilities/ovs-lib
Makefile: Add USDT scripts to make install and fedora/debian test rpm. This change will install all the USDT scripts to the {_datadir}/openvswitch/scripts/usdt directory with the make install command. In addition it will also add them to the Fedora and Debian openvswitch-test rpm. Signed-off-by: Eelco Chaudron <echaudro@redhat.com> Signed-off-by: Ilya Maximets <i.maximets@ovn.org>
2022-12-08 10:48:06 +01:00
usdt_SCRIPTS += \
utilities/usdt-scripts/bridge_loop.bt \
utilities: Updated dpif_nl_exec_monitor.py to debug all operations. Updated the dpif_nl_exec_monitor.py utility to also optionally monitor the other DPIF netlink operations, i.e., DPIF_OP_FLOW_PUT, DPIF_OP_FLOW_DEL and DPIF_OP_FLOW_GET Signed-off-by: Eelco Chaudron <echaudro@redhat.com> Signed-off-by: Aaron Conole <aconole@redhat.com>
2024-08-29 11:23:58 +02:00
utilities/usdt-scripts/dpif_op_nl_monitor.py \
revalidator: Add a USDT probe during flow deletion with purge reason. During normal operations, it is useful to understand when a particular flow gets removed from the system. This can be useful when debugging performance issues tied to ofproto flow changes, trying to determine deployed traffic patterns, or while debugging dynamic systems where ports come and go. Prior to this change, there was a lack of visibility around flow expiration. The existing debugging infrastructure could tell us when a flow was added to the datapath, but not when it was removed or why. This change introduces a USDT probe at the point where the revalidator determines that the flow should be removed. Additionally, we track the reason for the flow eviction and provide that information as well. With this change, we can track the complete flow lifecycle for the netlink datapath by hooking the upcall tracepoint in kernel, the flow put USDT, and the revalidator USDT, letting us watch as flows are added and removed from the kernel datapath. This change only enables this information via USDT probe, so it won't be possible to access this information any other way (see: Documentation/topics/usdt-probes.rst). Also included is a script (utilities/usdt-scripts/flow_reval_monitor.py) which serves as a demonstration of how the new USDT probe might be used going forward. Co-authored-by: Aaron Conole <aconole@redhat.com> Acked-by: Han Zhou <hzhou@ovn.org> Signed-off-by: Aaron Conole <aconole@redhat.com> Signed-off-by: Kevin Sprague <ksprague0711@gmail.com> Signed-off-by: Eelco Chaudron <echaudro@redhat.com>
2024-03-05 10:44:41 -05:00
utilities/usdt-scripts/flow_reval_monitor.py \
utilities: Add kernel_delay.py script to debug a busy Linux kernel. This patch adds an utility that can be used to determine if an issue is related to a lack of Linux kernel resources. This tool is also featured in a Red Hat developers blog article: https://developers.redhat.com/articles/2023/07/24/troubleshooting-open-vswitch-kernel-blame Reviewed-by: Adrian Moreno <amorenoz@redhat.com> Acked-by: Aaron Conole <aconole@redhat.com> Signed-off-by: Eelco Chaudron <echaudro@redhat.com>
2023-09-27 11:18:59 +02:00
utilities/usdt-scripts/kernel_delay.py \
utilities/usdt-scripts/kernel_delay.rst \
utilities: Add revalidator measurement script and needed USDT probes. This patch adds a Python script that can be used to analyze the revalidator runs by providing statistics (including some real time graphs). The USDT events can also be captured to a file and used for later offline analysis. The following blog explains the Open vSwitch revalidator implementation and how this tool can help you understand what is happening in your system. https://developers.redhat.com/articles/2022/10/19/open-vswitch-revalidator-process-explained Signed-off-by: Eelco Chaudron <echaudro@redhat.com> Acked-by: Adrian Moreno <amorenoz@redhat.com> Acked-by: Simon Horman <simon.horman@corigine.com> Signed-off-by: Ilya Maximets <i.maximets@ovn.org>
2023-01-23 12:03:29 +01:00
utilities/usdt-scripts/reval_monitor.py \
Makefile: Add USDT scripts to make install and fedora/debian test rpm. This change will install all the USDT scripts to the {_datadir}/openvswitch/scripts/usdt directory with the make install command. In addition it will also add them to the Fedora and Debian openvswitch-test rpm. Signed-off-by: Eelco Chaudron <echaudro@redhat.com> Signed-off-by: Ilya Maximets <i.maximets@ovn.org>
2022-12-08 10:48:06 +01:00
utilities/usdt-scripts/upcall_cost.py \
utilities: upcall_cost: Refactor port mapping cache. The upcall_cost.py script has a useful port mapping cache that can be very useful for other scripts. Move it into a library file (usdt_lib.py). While we're at it, refactor it into a class since setting attributes to functions and having it return different types depending on input is not very clean. This patch should not introduce any functional change. Signed-off-by: Adrian Moreno <amorenoz@redhat.com> Signed-off-by: Eelco Chaudron <echaudro@redhat.com>
2025-03-31 21:27:01 +02:00
utilities/usdt-scripts/upcall_monitor.py \
utilities/usdt-scripts/usdt_lib.py
Import from old repository commit 61ef2b42a9c4ba8e1600f15bb0236765edc2ad45.
2009-07-08 13:19:16 -07:00
bashcomp: Install and package completion scripts. This commit makes the bash completion scripts be installed to $(sysconfdir)/bash_completion.d/ through 'make install' and to /etc/bash_completion.d/ through package installation. This will make the scripts available for each bash session. An alternative is to put scripts to /usr/share/bash_completion/ directory. However, this is not supported by earlier version of bash completion. Signed-off-by: Alex Wang <alexw@nicira.com>
2015-03-18 14:32:23 -07:00
completion_SCRIPTS += \
utilities/ovs-appctl-bashcomp.bash \
utilities/ovs-vsctl-bashcomp.bash
ovs-vsctl-bashcomp: Documentation and unit tests. This commit includes the unit tests for ovs-vsctl-bashcomp and refines the ovs-command-bashcomp.INSTALL.md to introduce the bash completion for ovs-vsctl. Signed-off-by: Alex Wang <alexw@nicira.com> Acked-by: Ben Pfaff <blp@nicira.com>
2015-02-11 11:08:57 -08:00
check_SCRIPTS += \
utilities/ovs-appctl-bashcomp.bash \
utilities/ovs-vsctl-bashcomp.bash
ovs-command-completion: Autotest integration. This commit integrates the unit tests defined in utilities/ovs-command-compgen-test.bash into 'make check'. The tests will be skipped if the current shell is not bash. Signed-off-by: Alex Wang <alexw@nicira.com> Acked-by: Ben Pfaff <blp@nicira.com>
2014-11-24 11:15:45 -08:00
ovs-sim: Convert documentation to RST format. Signed-off-by: Ben Pfaff <blp@ovn.org> Acked-by: Justin Pettit <jpettit@ovn.org>
2018-05-17 12:31:45 -07:00
EXTRA_DIST += utilities/ovs-sim.in
ovs-sim: New utility for multi-node OVS and OVN simulation. Please see the examples in ovs-sim(1) for some examples of how this can be useful. Signed-off-by: Ben Pfaff <blp@nicira.com>
2015-06-16 08:38:46 -07:00
noinst_SCRIPTS += utilities/ovs-sim
utilities: Regenerate ovs-lib if configuration changes. Otherwise running "configure" twice with different --prefix (etc.) will fail to update ovs-lib, so that "make install" installs an ovs-lib with the wrong paths. Reported-by: Andy Zhou <azhou@nicira.com> Signed-off-by: Ben Pfaff <blp@nicira.com> Acked-by: Andy Zhou <azhou@nicira.com>
2013-11-19 11:02:08 -08:00
utilities/ovs-lib: $(top_builddir)/config.status
Import from old repository commit 61ef2b42a9c4ba8e1600f15bb0236765edc2ad45.
2009-07-08 13:19:16 -07:00
EXTRA_DIST += \
utilities: Add some GDB macros for ovs-vswitchd This commit adds basic GDB macro's for ovs-vswitchd: - ovs_dump_bridge [ports|wanted] - ovs_dump_bridge_ports <struct bridge *> - ovs_dump_dp_netdev [ports] - ovs_dump_dp_netdev_ports <struct dp_netdev *> - ovs_dump_netdev These dump functions show limited info, but you can simply cut/paste the address and get the full structure info. For example: (gdb) ovs_dump_netdev (struct netdev *) 0x555771ed89e0: name = ovs-netdev , auto_classified = false, netdev_class = 0x5557714413c0 <netdev_tap_class> (struct netdev *) 0x555771fc62a0: name = ovs_pvp_br0 , auto_classified = false, netdev_class = 0x5557714413c0 <netdev_tap_class> (struct netdev *) 0x555771fc9660: name = vnet0 , auto_classified = true , netdev_class = 0x555771445e00 <netdev_linux_class> (struct netdev *) 0x555771fc78d0: name = virbr0 , auto_classified = true , netdev_class = 0x555771445e00 <netdev_linux_class> (struct netdev *) 0x7fbefffb5540: name = dpdk0 , auto_classified = false, netdev_class = 0x5557714419e0 <dpdk_class> (struct netdev *) 0x555771fc98b0: name = em3 , auto_classified = true , netdev_class = 0x555771445e00 <netdev_linux_class> (struct netdev *) 0x7fbea0a31c40: name = vhost0 , auto_classified = false, netdev_class = 0x555771442040 <dpdk_vhost_client_class> (gdb) p *((struct netdev *) 0x7fbefffb5540) $1 = {name = 0x555771ecef70 "dpdk0", netdev_class = 0x5557714419e0 <dpdk_class>, auto_classified = false, mtu_user_config = true, ref_cnt = 2, change_seq = 12, reconfigure_seq = 0x555771ecf2e0, last_reconfigure_seq = 110, n_txq = 2, n_rxq = 1, node = 0x555771efafe0, saved_flags_list = {prev = 0x7fbefffb5580, next = 0x7fbefffb5580}} Signed-off-by: Eelco Chaudron <echaudro@redhat.com> Signed-off-by: Ben Pfaff <blp@ovn.org>
2018-05-09 13:47:26 +02:00
utilities/gdb/ovs_gdb.py \
ovs-appctl-bashcomp: Keep naming consistency. Before adding the completion script ovs-vsctl-bashcomp.bash for ovs-vsctl command, this commit renames the ovs-command-compgen.bash to ovs-appctl-bashcomp.bash to keep the script naming consistent. Signed-off-by: Alex Wang <alexw@nicira.com> Acked-by: Ben Pfaff <blp@nicira.com>
2015-02-10 11:06:11 -08:00
utilities/ovs-appctl-bashcomp.bash \
utilities: Add new pipeline generator script. When doing OVS performance testing, it's important to have both realistic traffic traces and OpenFlow pipelines on which to evaluate prospective changes. As a first step in this direction, this patch adds a python script which generates an OpenFlow pipeline intended to simulate typical network virtualization workloads. Signed-off-by: Ethan Jackson <ethan@nicira.com> Acked-by: Daniele Di Proietto <diproiettod@vmware.com>
2015-03-26 12:52:42 -07:00
utilities/ovs-check-dead-ifs.in \
Implement automatic dependency generation for manpages. This ensures that manpages actually get rebuilt if any of the lib/*.man fragments that they depend upon are modified.
2011-10-26 16:06:37 -07:00
utilities/ovs-ctl.in \
utilities: New helper script ovs-dev.py. ovs-dev.py is a script I've written to help perform common tasks necessary for developing Open vSwitch. It allows a developer to configure, build, and run the switch with a minimum of effort or knowledge of the various idiosyncrasies involved. Signed-off-by: Ethan Jackson <ethan@nicira.com>
2013-07-06 18:55:45 -07:00
utilities/ovs-dev.py \
docker: Integrate docker containers with Open vSwitch. Open vSwitch does not have native integration with Docker. INSTALL.Docker explains how Open vSwitch can be integrated with docker non-natively. ovs-docker is a helper script to add network interfaces to docker containers and to attach them as ports to OVS bridge. This script can be further enhanced as we understand different use cases. Signed-off-by: Gurucharan Shetty <gshetty@nicira.com> Acked-by: Ben Pfaff <blp@nicira.com>
2014-10-14 00:51:52 -07:00
utilities/ovs-docker \
utilities: a top like tool for ovs-dpctl dump-flows. This python script summarizes ovs-dpctl dump-flows content by aggregating the number of packets, total bytes and occurrence of the following fields: - Datapath in_port - Ethernet type - Source and destination MAC addresses - IP protocol - Source and destination IPv4 addresses - Source and destination IPv6 addresses - UDP and TCP destination port - Tunnel source and destination addresses Testing included confirming both mega-flows and non-megaflows are properly parsed. Bit masks are applied in the case of mega-flows prior to aggregation. Test --script parameter which runs in non-interactive mode. Tested syntax against python 2.4.3, 2.6 and 2.7. Confirmed script passes pep8 and pylint run as: pylint --disable=I0011 --include-id=y --reports=n This tool has been added to these distribution: - add ovs-dpctl-top to debian distribution - add ovs-dpctl-top to rpm distribution. - add ovs-dpctl-top to XenServer RPM. Signed-off-by: Mark Hamilton <mhamilton@nicira.com> Signed-off-by: Gurucharan Shetty <gshetty@nicira.com>
2013-09-13 15:50:48 -07:00
utilities/ovs-dpctl-top.in \
ovs-kmod-ctl: introduce a kernel module load script Currently, Open vSwitch on linux embeds the logic of loading and unloading kernel modules into the ovs-ctl and ovs-lib script files. This works, but it means that there is no way to leverage extended filesystem attributes to grant fine grain permissions relating to module loading. The split out utility 'ovs-kmod-ctl' will be used in an upcoming commit for RHEL-based distributions to have a separate transition domain that will allow module loading to be given to a separate selinux domain from the openvswitch_t domain. Acked-by: Ansis Atteka <aatteka@ovn.org> Acked-by: Timothy Redaelli <tredaelli@redhat.com> Signed-off-by: Aaron Conole <aconole@redhat.com>
2018-06-01 14:28:44 -04:00
utilities/ovs-kmod-ctl.in \
ovs-l3ping: A new test utility that allows to detect L3 tunneling issues ovs-l3ping is similar to ovs-test, but the main difference is that it does not require administrator to open firewall holes for the XML/RPC control connection. This is achieved by encapsulating the Control Connection over the L3 tunnel itself. This tool is not intended as a replacement for ovs-test, because ovs-test covers much broader set of test cases. Sample usage: Node1: ovs-l3ping -s 192.168.122.236,10.1.1.1 -t gre Node2: ovs-l3ping -c 192.168.122.220,10.1.1.2,10.1.1.1 -t gre Issue#11791 Signed-off-by: Ansis Atteka <aatteka@nicira.com>
2012-06-28 15:52:40 -07:00
utilities/ovs-l3ping.in \
utilites: rename ovs-lib.sh to ovs-lib Rename this helper script to simply ovs-lib, since it's primarily a library of helper functions. Signed-off-by: Chris Wright <chrisw@sous-sol.org> Signed-off-by: Ben Pfaff <blp@nicira.com>
2011-12-08 23:36:05 -08:00
utilities/ovs-lib.in \
utilities: New helper ovs-parse-backtrace. The new ovs-parse-backtrace utility makes the output of ovs-appctl backtrace more human readable by removing duplicate traces and converting addresses to function names. Signed-off-by: Ethan Jackson <ethan@nicira.com>
2012-10-15 12:42:48 -07:00
utilities/ovs-parse-backtrace.in \
Implement automatic dependency generation for manpages. This ensures that manpages actually get rebuilt if any of the lib/*.man fragments that they depend upon are modified.
2011-10-26 16:06:37 -07:00
utilities/ovs-pcap.in \
utilities: Add new pipeline generator script. When doing OVS performance testing, it's important to have both realistic traffic traces and OpenFlow pipelines on which to evaluate prospective changes. As a first step in this direction, this patch adds a python script which generates an OpenFlow pipeline intended to simulate typical network virtualization workloads. Signed-off-by: Ethan Jackson <ethan@nicira.com> Acked-by: Daniele Di Proietto <diproiettod@vmware.com>
2015-03-26 12:52:42 -07:00
utilities/ovs-pipegen.py \
Implement automatic dependency generation for manpages. This ensures that manpages actually get rebuilt if any of the lib/*.man fragments that they depend upon are modified.
2011-10-26 16:06:37 -07:00
utilities/ovs-pki.in \
utilities/ovs-save \
ovs-tcpdump: Add a tcpdump wrapper utility Currently, there is some documentation which describes setting up and using port mirrors for bridges. This documentation is helpful to setup a packet capture for specific ports. However, a utility to do such packet capture would be valuable, both as an exercise in documenting the steps an additional time, and as a way of providing an out-of-the-box experience for running a capture. This commit adds a tcpdump-wrapper utility for such purpose. It uses the Open vSwitch python library to add/remove ports and mirrors to/from the Open vSwitch database. It will create a tcpdump instance listening on the mirror port (allowing the user to specify additional arguments), and dump data to the screen (or otherwise). Signed-off-by: Aaron Conole <aconole@redhat.com> Signed-off-by: Ben Pfaff <blp@ovn.org> Acked-by: Flavio Leitner <fbl@sysclose.org>
2016-06-08 17:49:55 -04:00
utilities/ovs-tcpdump.in \
Implement automatic dependency generation for manpages. This ensures that manpages actually get rebuilt if any of the lib/*.man fragments that they depend upon are modified.
2011-10-26 16:06:37 -07:00
utilities/ovs-tcpundump.in \
ovs-test: A new tool that allows to diagnose connectivity and performance issues This tool will be a replacement for the current ovs-vlan-test utility. Besides from connectivity issues it will also be able to detect performance related issues in Open vSwitch setups. Currently it uses UDP and TCP protocols for stressing. Issue #6976
2011-10-31 14:56:08 -07:00
utilities/ovs-test.in \
netdev-dpdk: add dpdk vhost-cuse ports This patch adds support for a new port type to userspace datapath called dpdkvhost. This allows KVM (QEMU) to offload the servicing of virtio-net devices to its associated dpdkvhost port. Instructions for use are in INSTALL.DPDK. This has been tested on Intel multi-core platforms and with clients that have virtio-net interfaces. Signed-off-by: Ciara Loftus <ciara.loftus@intel.com> Signed-off-by: Kevin Traynor <kevin.traynor@intel.com> Signed-off-by: Maryam Tahhan <maryam.tahhan@intel.com> Signed-off-by: Pravin B Shelar <pshelar@nicira.com>
2015-03-05 13:42:04 -08:00
utilities/ovs-vlan-test.in \
utilities: Add new pipeline generator script. When doing OVS performance testing, it's important to have both realistic traffic traces and OpenFlow pipelines on which to evaluate prospective changes. As a first step in this direction, this patch adds a python script which generates an OpenFlow pipeline intended to simulate typical network virtualization workloads. Signed-off-by: Ethan Jackson <ethan@nicira.com> Acked-by: Daniele Di Proietto <diproiettod@vmware.com>
2015-03-26 12:52:42 -07:00
utilities/ovs-vsctl-bashcomp.bash \
OVS: Containerize components 1. Start OVS components in containers so that building and shipping of OVS components is easy. 2. Load OVS kernel modules on host from container to avoid installing ovs on host. 3. Update documentation about how to build/run ovs in docker. Acked-by: Numan Siddique <nusiddiq@redhat.com> Signed-off-by: aginwala <aginwala@ebay.com> Signed-off-by: Ben Pfaff <blp@ovn.org>
2019-08-17 00:21:45 -07:00
utilities/checkpatch.py \
checkpatch: Separate out the built-in spelling words. Checkpatch contains a large list of spelling words, currently 326. The in-built list is quite cumbersome, and includes duplicate entries ('netdev' and 'revalidation'). Managing this list will continue to grow difficult over time, and really shouldn't be so difficult. To make the maintenance of OVS specific spelling words easier, create a new file that will contain the spelling words and move the list into that file (sorted). This patch adds 'FreeBSD' and 'gcloud' to the list as it was tested against 80d723736b64 ("cirrus: Update to FreeBSD 14.3 and 13.5."). It also adds "apis", "enablement", "ifdef", and "tnl" after the patch proposed by Eelco at the referenced link. Link: https://patchwork.ozlabs.org/project/openvswitch/patch/d6fecfc9491893b852ff9de3ef8b7ef068535d6d.1750328980.git.echaudro@redhat.com/ Acked-by: Eelco Chaudron <echaudro@redhat.com> Acked-by: Ilya Maximets <i.maximets@ovn.org> Signed-off-by: Aaron Conole <aconole@redhat.com>
2025-07-15 09:41:02 -04:00
utilities/checkpatch_dict.txt \
Documentation: Add USDT documentation and bpftrace example. Add the USDT documentation and a bpftrace example using the bridge run USDT probes. Signed-off-by: Eelco Chaudron <echaudro@redhat.com> Acked-by: Paolo Valerio <pvalerio@redhat.com> Signed-off-by: Ilya Maximets <i.maximets@ovn.org>
2021-12-22 10:17:44 +01:00
utilities/docker/Makefile \
utilities/docker/ovs-override.conf \
utilities/docker/start-ovs \
utilities/docker/create_ovs_db.sh \
utilities/docker/debian/Dockerfile \
utilities/docker/debian/build-kernel-modules.sh \
utilities: Add upcall USDT probe and associated script. Added the dpif_recv:recv_upcall USDT probe, which is used by the included upcall_monitor.py script. This script receives all upcall packets sent by the kernel to ovs-vswitchd. By default, it will show all upcall events, which looks something like this: TIME CPU COMM PID DPIF_NAME TYPE PKT_LEN FLOW_KEY_LEN 5952147.003848809 2 handler4 1381158 system@ovs-system 0 98 132 5952147.003879643 2 handler4 1381158 system@ovs-system 0 70 160 5952147.003914924 2 handler4 1381158 system@ovs-system 0 98 152 It can also dump the packet and NetLink content, and if required, the packets can also be written to a pcap file. Signed-off-by: Eelco Chaudron <echaudro@redhat.com> Acked-by: Paolo Valerio <pvalerio@redhat.com> Signed-off-by: Ilya Maximets <i.maximets@ovn.org>
2021-12-22 10:18:23 +01:00
utilities/usdt-scripts/bridge_loop.bt \
utilities: Updated dpif_nl_exec_monitor.py to debug all operations. Updated the dpif_nl_exec_monitor.py utility to also optionally monitor the other DPIF netlink operations, i.e., DPIF_OP_FLOW_PUT, DPIF_OP_FLOW_DEL and DPIF_OP_FLOW_GET Signed-off-by: Eelco Chaudron <echaudro@redhat.com> Signed-off-by: Aaron Conole <aconole@redhat.com>
2024-08-29 11:23:58 +02:00
utilities/usdt-scripts/dpif_op_nl_monitor.py \
revalidator: Add a USDT probe during flow deletion with purge reason. During normal operations, it is useful to understand when a particular flow gets removed from the system. This can be useful when debugging performance issues tied to ofproto flow changes, trying to determine deployed traffic patterns, or while debugging dynamic systems where ports come and go. Prior to this change, there was a lack of visibility around flow expiration. The existing debugging infrastructure could tell us when a flow was added to the datapath, but not when it was removed or why. This change introduces a USDT probe at the point where the revalidator determines that the flow should be removed. Additionally, we track the reason for the flow eviction and provide that information as well. With this change, we can track the complete flow lifecycle for the netlink datapath by hooking the upcall tracepoint in kernel, the flow put USDT, and the revalidator USDT, letting us watch as flows are added and removed from the kernel datapath. This change only enables this information via USDT probe, so it won't be possible to access this information any other way (see: Documentation/topics/usdt-probes.rst). Also included is a script (utilities/usdt-scripts/flow_reval_monitor.py) which serves as a demonstration of how the new USDT probe might be used going forward. Co-authored-by: Aaron Conole <aconole@redhat.com> Acked-by: Han Zhou <hzhou@ovn.org> Signed-off-by: Aaron Conole <aconole@redhat.com> Signed-off-by: Kevin Sprague <ksprague0711@gmail.com> Signed-off-by: Eelco Chaudron <echaudro@redhat.com>
2024-03-05 10:44:41 -05:00
utilities/usdt-scripts/flow_reval_monitor.py \
utilities: Add kernel_delay.py script to debug a busy Linux kernel. This patch adds an utility that can be used to determine if an issue is related to a lack of Linux kernel resources. This tool is also featured in a Red Hat developers blog article: https://developers.redhat.com/articles/2023/07/24/troubleshooting-open-vswitch-kernel-blame Reviewed-by: Adrian Moreno <amorenoz@redhat.com> Acked-by: Aaron Conole <aconole@redhat.com> Signed-off-by: Eelco Chaudron <echaudro@redhat.com>
2023-09-27 11:18:59 +02:00
utilities/usdt-scripts/kernel_delay.py \
utilities/usdt-scripts/kernel_delay.rst \
utilities: Add revalidator measurement script and needed USDT probes. This patch adds a Python script that can be used to analyze the revalidator runs by providing statistics (including some real time graphs). The USDT events can also be captured to a file and used for later offline analysis. The following blog explains the Open vSwitch revalidator implementation and how this tool can help you understand what is happening in your system. https://developers.redhat.com/articles/2022/10/19/open-vswitch-revalidator-process-explained Signed-off-by: Eelco Chaudron <echaudro@redhat.com> Acked-by: Adrian Moreno <amorenoz@redhat.com> Acked-by: Simon Horman <simon.horman@corigine.com> Signed-off-by: Ilya Maximets <i.maximets@ovn.org>
2023-01-23 12:03:29 +01:00
utilities/usdt-scripts/reval_monitor.py \
utilities: Add netlink flow operation USDT probes and upcall_cost script. This patch adds a series of NetLink flow operation USDT probes. These probes are in turn used in the upcall_cost Python script, which in addition of some kernel tracepoints, give an insight into the time spent on processing upcall. Signed-off-by: Eelco Chaudron <echaudro@redhat.com> Acked-by: Paolo Valerio <pvalerio@redhat.com> Signed-off-by: Ilya Maximets <i.maximets@ovn.org>
2021-12-22 10:19:02 +01:00
utilities/usdt-scripts/upcall_cost.py \
utilities: upcall_cost: Refactor port mapping cache. The upcall_cost.py script has a useful port mapping cache that can be very useful for other scripts. Move it into a library file (usdt_lib.py). While we're at it, refactor it into a class since setting attributes to functions and having it return different types depending on input is not very clean. This patch should not introduce any functional change. Signed-off-by: Adrian Moreno <amorenoz@redhat.com> Signed-off-by: Eelco Chaudron <echaudro@redhat.com>
2025-03-31 21:27:01 +02:00
utilities/usdt-scripts/upcall_monitor.py \
utilities/usdt-scripts/usdt_lib.py
Implement automatic dependency generation for manpages. This ensures that manpages actually get rebuilt if any of the lib/*.man fragments that they depend upon are modified.
2011-10-26 16:06:37 -07:00
MAN_ROOTS += \
test-controller: Rename to ovs-testcontroller, again install. mininet uses the Open vSwitch controller by default, for testing. CC: 757761@bugs.debian.org Reported-at: https://bugs.debian.org/757761 Requested-by: Tomasz Buchert <tomasz.buchert@inria.fr> Requested-by: Dariusz Dwornikowski <dariusz.dwornikowski@cs.put.poznan.pl> Signed-off-by: Ben Pfaff <blp@nicira.com> Acked-by: Justin Pettit <jpettit@nicira.com>
2014-08-15 10:32:50 -07:00
utilities/ovs-testcontroller.8.in \
Import from old repository commit 61ef2b42a9c4ba8e1600f15bb0236765edc2ad45.
2009-07-08 13:19:16 -07:00
utilities/ovs-dpctl.8.in \
utilities: a top like tool for ovs-dpctl dump-flows. This python script summarizes ovs-dpctl dump-flows content by aggregating the number of packets, total bytes and occurrence of the following fields: - Datapath in_port - Ethernet type - Source and destination MAC addresses - IP protocol - Source and destination IPv4 addresses - Source and destination IPv6 addresses - UDP and TCP destination port - Tunnel source and destination addresses Testing included confirming both mega-flows and non-megaflows are properly parsed. Bit masks are applied in the case of mega-flows prior to aggregation. Test --script parameter which runs in non-interactive mode. Tested syntax against python 2.4.3, 2.6 and 2.7. Confirmed script passes pep8 and pylint run as: pylint --disable=I0011 --include-id=y --reports=n This tool has been added to these distribution: - add ovs-dpctl-top to debian distribution - add ovs-dpctl-top to rpm distribution. - add ovs-dpctl-top to XenServer RPM. Signed-off-by: Mark Hamilton <mhamilton@nicira.com> Signed-off-by: Gurucharan Shetty <gshetty@nicira.com>
2013-09-13 15:50:48 -07:00
utilities/ovs-dpctl-top.8.in \
ovs-kmod-ctl: introduce a kernel module load script Currently, Open vSwitch on linux embeds the logic of loading and unloading kernel modules into the ovs-ctl and ovs-lib script files. This works, but it means that there is no way to leverage extended filesystem attributes to grant fine grain permissions relating to module loading. The split out utility 'ovs-kmod-ctl' will be used in an upcoming commit for RHEL-based distributions to have a separate transition domain that will allow module loading to be given to a separate selinux domain from the openvswitch_t domain. Acked-by: Ansis Atteka <aatteka@ovn.org> Acked-by: Timothy Redaelli <tredaelli@redhat.com> Signed-off-by: Aaron Conole <aconole@redhat.com>
2018-06-01 14:28:44 -04:00
utilities/ovs-kmod-ctl.8 \
Import from old repository commit 61ef2b42a9c4ba8e1600f15bb0236765edc2ad45.
2009-07-08 13:19:16 -07:00
utilities/ovs-ofctl.8.in \
ofproto: Add "ofproto/trace" command to help debugging flow tables. With an appropriate flow table, output from a command like this: ovs-appctl ofproto/trace system@dp0 0 0 ffffffffffff000c29f49d5c080600010 80006040001000c29f49d5cac10008a000000000000ac1004df00000000000000000000000000000 0000000 resembles the following: Packet: -8:00:00.000000 00:0c:29:f4:9d:5c > ff:ff:ff:ff:ff:ff, ethertype ARP (0x 0806), length 60: arp who-has 172.16.4.223 tell 172.16.0.138 Flow: tunnel0:in_port0000:tci(0) mac00:0c:29:f4:9d:5c->ff:ff:ff:ff:ff:ff type080 6 proto1 tos0 ip172.16.0.138->172.16.4.223 port0->0 Rule: cookie=0 in_port=65534 OpenFlow actions=resubmit:1,mod_vlan_vid:5,resubmit:2,mod_vlan_pcp:6,strip_vlan Resubmitted flow: unchanged Rule: cookie=0 in_port=1 OpenFlow actions=resubmit:3,resubmit:4 Resubmitted flow: unchanged No match Resubmitted flow: unchanged No match Resubmitted flow: tunnel0:in_port0000:tci(vlan5,pcp0) mac00:0c:29:f4:9d: 5c->ff:ff:ff:ff:ff:ff type0806 proto1 tos0 ip172.16.0.138->172.16.4.223 port0->0 No match Final flow: tunnel0:in_port0000:tci(0) mac00:0c:29:f4:9d:5c->ff:ff:ff:ff:ff:ff t ype0806 proto1 tos0 ip172.16.0.138->172.16.4.223 port0->0 Datapath actions: set_tci(vid=5,pcp=0),set_tci(vid=5,pcp=6),strip_vlan
2010-12-09 15:00:36 -08:00
utilities/ovs-pcap.1.in \
vsctl: Start making it work with ovsdb. This passes at least one test (the one named "add-br a"). It probably doesn't pass any more than that. This is *way* not up to my quality standards, but we are in a super hurry so I'm pushing it anyhow.
2009-12-08 17:18:12 -08:00
utilities/ovs-vsctl.8.in
Remove build-time generated files when "make clean" is run. "make clean" should remove all files generated by building a program, while "make distclean" should also remove files generated by configuring the program. Previously some generated files during the build process, such as man pages, were left behind when "make clean" was run. This commit only leaves configuration files after "make clean" is run, and removes all other generated files. Signed-off-by: Justin Pettit <jpettit@ovn.org> Acked-by: Ben Pfaff <blp@ovn.org>
2017-02-13 17:20:56 -08:00
CLEANFILES += \
Refactor initscripts into distro-independent and distro-specific pieces. This should make it easier to add OVS support to new distributions.
2011-06-17 12:24:31 -07:00
utilities/ovs-ctl \
Fix "make distcheck" failure since we weren't cleaning up a generated file. Signed-off-by: Ben Pfaff <blp@nicira.com>
2012-05-10 09:37:11 -07:00
utilities/ovs-check-dead-ifs \
test-controller: Rename to ovs-testcontroller, again install. mininet uses the Open vSwitch controller by default, for testing. CC: 757761@bugs.debian.org Reported-at: https://bugs.debian.org/757761 Requested-by: Tomasz Buchert <tomasz.buchert@inria.fr> Requested-by: Dariusz Dwornikowski <dariusz.dwornikowski@cs.put.poznan.pl> Signed-off-by: Ben Pfaff <blp@nicira.com> Acked-by: Justin Pettit <jpettit@nicira.com>
2014-08-15 10:32:50 -07:00
utilities/ovs-testcontroller.8 \
Import from old repository commit 61ef2b42a9c4ba8e1600f15bb0236765edc2ad45.
2009-07-08 13:19:16 -07:00
utilities/ovs-dpctl.8 \
utilities: a top like tool for ovs-dpctl dump-flows. This python script summarizes ovs-dpctl dump-flows content by aggregating the number of packets, total bytes and occurrence of the following fields: - Datapath in_port - Ethernet type - Source and destination MAC addresses - IP protocol - Source and destination IPv4 addresses - Source and destination IPv6 addresses - UDP and TCP destination port - Tunnel source and destination addresses Testing included confirming both mega-flows and non-megaflows are properly parsed. Bit masks are applied in the case of mega-flows prior to aggregation. Test --script parameter which runs in non-interactive mode. Tested syntax against python 2.4.3, 2.6 and 2.7. Confirmed script passes pep8 and pylint run as: pylint --disable=I0011 --include-id=y --reports=n This tool has been added to these distribution: - add ovs-dpctl-top to debian distribution - add ovs-dpctl-top to rpm distribution. - add ovs-dpctl-top to XenServer RPM. Signed-off-by: Mark Hamilton <mhamilton@nicira.com> Signed-off-by: Gurucharan Shetty <gshetty@nicira.com>
2013-09-13 15:50:48 -07:00
utilities/ovs-dpctl-top \
utilities/ovs-dpctl-top.8 \
ovs-kmod-ctl: introduce a kernel module load script Currently, Open vSwitch on linux embeds the logic of loading and unloading kernel modules into the ovs-ctl and ovs-lib script files. This works, but it means that there is no way to leverage extended filesystem attributes to grant fine grain permissions relating to module loading. The split out utility 'ovs-kmod-ctl' will be used in an upcoming commit for RHEL-based distributions to have a separate transition domain that will allow module loading to be given to a separate selinux domain from the openvswitch_t domain. Acked-by: Ansis Atteka <aatteka@ovn.org> Acked-by: Timothy Redaelli <tredaelli@redhat.com> Signed-off-by: Aaron Conole <aconole@redhat.com>
2018-06-01 14:28:44 -04:00
utilities/ovs-kmod-ctl \
ovs-l3ping: A new test utility that allows to detect L3 tunneling issues ovs-l3ping is similar to ovs-test, but the main difference is that it does not require administrator to open firewall holes for the XML/RPC control connection. This is achieved by encapsulating the Control Connection over the L3 tunnel itself. This tool is not intended as a replacement for ovs-test, because ovs-test covers much broader set of test cases. Sample usage: Node1: ovs-l3ping -s 192.168.122.236,10.1.1.1 -t gre Node2: ovs-l3ping -c 192.168.122.220,10.1.1.2,10.1.1.1 -t gre Issue#11791 Signed-off-by: Ansis Atteka <aatteka@nicira.com>
2012-06-28 15:52:40 -07:00
utilities/ovs-l3ping \
utilites: rename ovs-lib.sh to ovs-lib Rename this helper script to simply ovs-lib, since it's primarily a library of helper functions. Signed-off-by: Chris Wright <chrisw@sous-sol.org> Signed-off-by: Ben Pfaff <blp@nicira.com>
2011-12-08 23:36:05 -08:00
utilities/ovs-lib \
Import from old repository commit 61ef2b42a9c4ba8e1600f15bb0236765edc2ad45.
2009-07-08 13:19:16 -07:00
utilities/ovs-ofctl.8 \
utilities: New helper ovs-parse-backtrace. The new ovs-parse-backtrace utility makes the output of ovs-appctl backtrace more human readable by removing duplicate traces and converting addresses to function names. Signed-off-by: Ethan Jackson <ethan@nicira.com>
2012-10-15 12:42:48 -07:00
utilities/ovs-parse-backtrace \
ofproto: Add "ofproto/trace" command to help debugging flow tables. With an appropriate flow table, output from a command like this: ovs-appctl ofproto/trace system@dp0 0 0 ffffffffffff000c29f49d5c080600010 80006040001000c29f49d5cac10008a000000000000ac1004df00000000000000000000000000000 0000000 resembles the following: Packet: -8:00:00.000000 00:0c:29:f4:9d:5c > ff:ff:ff:ff:ff:ff, ethertype ARP (0x 0806), length 60: arp who-has 172.16.4.223 tell 172.16.0.138 Flow: tunnel0:in_port0000:tci(0) mac00:0c:29:f4:9d:5c->ff:ff:ff:ff:ff:ff type080 6 proto1 tos0 ip172.16.0.138->172.16.4.223 port0->0 Rule: cookie=0 in_port=65534 OpenFlow actions=resubmit:1,mod_vlan_vid:5,resubmit:2,mod_vlan_pcp:6,strip_vlan Resubmitted flow: unchanged Rule: cookie=0 in_port=1 OpenFlow actions=resubmit:3,resubmit:4 Resubmitted flow: unchanged No match Resubmitted flow: unchanged No match Resubmitted flow: tunnel0:in_port0000:tci(vlan5,pcp0) mac00:0c:29:f4:9d: 5c->ff:ff:ff:ff:ff:ff type0806 proto1 tos0 ip172.16.0.138->172.16.4.223 port0->0 No match Final flow: tunnel0:in_port0000:tci(0) mac00:0c:29:f4:9d:5c->ff:ff:ff:ff:ff:ff t ype0806 proto1 tos0 ip172.16.0.138->172.16.4.223 port0->0 Datapath actions: set_tci(vid=5,pcp=0),set_tci(vid=5,pcp=6),strip_vlan
2010-12-09 15:00:36 -08:00
utilities/ovs-pcap \
utilities/ovs-pcap.1 \
Import from old repository commit 61ef2b42a9c4ba8e1600f15bb0236765edc2ad45.
2009-07-08 13:19:16 -07:00
utilities/ovs-pki \
Add a few OVN files as part of DISTCLEANFILES. Reported-by: Ian Stokes <ian.stokes@intel.com> Signed-off-by: Gurucharan Shetty <gshetty@nicira.com> Tested-by: Ian Stokes <ian.stokes@intel.com> Acked-by: Russell Bryant <rbryant@redhat.com>
2015-06-23 07:31:41 -07:00
utilities/ovs-sim \
ovs-tcpdump: Add a tcpdump wrapper utility Currently, there is some documentation which describes setting up and using port mirrors for bridges. This documentation is helpful to setup a packet capture for specific ports. However, a utility to do such packet capture would be valuable, both as an exercise in documenting the steps an additional time, and as a way of providing an out-of-the-box experience for running a capture. This commit adds a tcpdump-wrapper utility for such purpose. It uses the Open vSwitch python library to add/remove ports and mirrors to/from the Open vSwitch database. It will create a tcpdump instance listening on the mirror port (allowing the user to specify additional arguments), and dump data to the screen (or otherwise). Signed-off-by: Aaron Conole <aconole@redhat.com> Signed-off-by: Ben Pfaff <blp@ovn.org> Acked-by: Flavio Leitner <fbl@sysclose.org>
2016-06-08 17:49:55 -04:00
utilities/ovs-tcpdump \
ofproto: Add "ofproto/trace" command to help debugging flow tables. With an appropriate flow table, output from a command like this: ovs-appctl ofproto/trace system@dp0 0 0 ffffffffffff000c29f49d5c080600010 80006040001000c29f49d5cac10008a000000000000ac1004df00000000000000000000000000000 0000000 resembles the following: Packet: -8:00:00.000000 00:0c:29:f4:9d:5c > ff:ff:ff:ff:ff:ff, ethertype ARP (0x 0806), length 60: arp who-has 172.16.4.223 tell 172.16.0.138 Flow: tunnel0:in_port0000:tci(0) mac00:0c:29:f4:9d:5c->ff:ff:ff:ff:ff:ff type080 6 proto1 tos0 ip172.16.0.138->172.16.4.223 port0->0 Rule: cookie=0 in_port=65534 OpenFlow actions=resubmit:1,mod_vlan_vid:5,resubmit:2,mod_vlan_pcp:6,strip_vlan Resubmitted flow: unchanged Rule: cookie=0 in_port=1 OpenFlow actions=resubmit:3,resubmit:4 Resubmitted flow: unchanged No match Resubmitted flow: unchanged No match Resubmitted flow: tunnel0:in_port0000:tci(vlan5,pcp0) mac00:0c:29:f4:9d: 5c->ff:ff:ff:ff:ff:ff type0806 proto1 tos0 ip172.16.0.138->172.16.4.223 port0->0 No match Final flow: tunnel0:in_port0000:tci(0) mac00:0c:29:f4:9d:5c->ff:ff:ff:ff:ff:ff t ype0806 proto1 tos0 ip172.16.0.138->172.16.4.223 port0->0 Datapath actions: set_tci(vid=5,pcp=0),set_tci(vid=5,pcp=6),strip_vlan
2010-12-09 15:00:36 -08:00
utilities/ovs-tcpundump \
ovs-test: A new tool that allows to diagnose connectivity and performance issues This tool will be a replacement for the current ovs-vlan-test utility. Besides from connectivity issues it will also be able to detect performance related issues in Open vSwitch setups. Currently it uses UDP and TCP protocols for stressing. Issue #6976
2011-10-31 14:56:08 -07:00
utilities/ovs-test \
utilities: Implement ovs-vlan-test script This patch implements a script which may be used to check for connectivity issues caused by bugs in Linux drivers relating to VLAN traffic.
2010-12-07 18:49:28 -08:00
utilities/ovs-vlan-test \
New utility ovs-vsctl.
2009-09-14 10:05:13 -07:00
utilities/ovs-vsctl.8
Import from old repository commit 61ef2b42a9c4ba8e1600f15bb0236765edc2ad45.
2009-07-08 13:19:16 -07:00
man_MANS += \
test-controller: Rename to ovs-testcontroller, again install. mininet uses the Open vSwitch controller by default, for testing. CC: 757761@bugs.debian.org Reported-at: https://bugs.debian.org/757761 Requested-by: Tomasz Buchert <tomasz.buchert@inria.fr> Requested-by: Dariusz Dwornikowski <dariusz.dwornikowski@cs.put.poznan.pl> Signed-off-by: Ben Pfaff <blp@nicira.com> Acked-by: Justin Pettit <jpettit@nicira.com>
2014-08-15 10:32:50 -07:00
utilities/ovs-testcontroller.8 \
Import from old repository commit 61ef2b42a9c4ba8e1600f15bb0236765edc2ad45.
2009-07-08 13:19:16 -07:00
utilities/ovs-dpctl.8 \
utilities: a top like tool for ovs-dpctl dump-flows. This python script summarizes ovs-dpctl dump-flows content by aggregating the number of packets, total bytes and occurrence of the following fields: - Datapath in_port - Ethernet type - Source and destination MAC addresses - IP protocol - Source and destination IPv4 addresses - Source and destination IPv6 addresses - UDP and TCP destination port - Tunnel source and destination addresses Testing included confirming both mega-flows and non-megaflows are properly parsed. Bit masks are applied in the case of mega-flows prior to aggregation. Test --script parameter which runs in non-interactive mode. Tested syntax against python 2.4.3, 2.6 and 2.7. Confirmed script passes pep8 and pylint run as: pylint --disable=I0011 --include-id=y --reports=n This tool has been added to these distribution: - add ovs-dpctl-top to debian distribution - add ovs-dpctl-top to rpm distribution. - add ovs-dpctl-top to XenServer RPM. Signed-off-by: Mark Hamilton <mhamilton@nicira.com> Signed-off-by: Gurucharan Shetty <gshetty@nicira.com>
2013-09-13 15:50:48 -07:00
utilities/ovs-dpctl-top.8 \
ovs-kmod-ctl: introduce a kernel module load script Currently, Open vSwitch on linux embeds the logic of loading and unloading kernel modules into the ovs-ctl and ovs-lib script files. This works, but it means that there is no way to leverage extended filesystem attributes to grant fine grain permissions relating to module loading. The split out utility 'ovs-kmod-ctl' will be used in an upcoming commit for RHEL-based distributions to have a separate transition domain that will allow module loading to be given to a separate selinux domain from the openvswitch_t domain. Acked-by: Ansis Atteka <aatteka@ovn.org> Acked-by: Timothy Redaelli <tredaelli@redhat.com> Signed-off-by: Aaron Conole <aconole@redhat.com>
2018-06-01 14:28:44 -04:00
utilities/ovs-kmod-ctl.8 \
Import from old repository commit 61ef2b42a9c4ba8e1600f15bb0236765edc2ad45.
2009-07-08 13:19:16 -07:00
utilities/ovs-ofctl.8 \
ofproto: Add "ofproto/trace" command to help debugging flow tables. With an appropriate flow table, output from a command like this: ovs-appctl ofproto/trace system@dp0 0 0 ffffffffffff000c29f49d5c080600010 80006040001000c29f49d5cac10008a000000000000ac1004df00000000000000000000000000000 0000000 resembles the following: Packet: -8:00:00.000000 00:0c:29:f4:9d:5c > ff:ff:ff:ff:ff:ff, ethertype ARP (0x 0806), length 60: arp who-has 172.16.4.223 tell 172.16.0.138 Flow: tunnel0:in_port0000:tci(0) mac00:0c:29:f4:9d:5c->ff:ff:ff:ff:ff:ff type080 6 proto1 tos0 ip172.16.0.138->172.16.4.223 port0->0 Rule: cookie=0 in_port=65534 OpenFlow actions=resubmit:1,mod_vlan_vid:5,resubmit:2,mod_vlan_pcp:6,strip_vlan Resubmitted flow: unchanged Rule: cookie=0 in_port=1 OpenFlow actions=resubmit:3,resubmit:4 Resubmitted flow: unchanged No match Resubmitted flow: unchanged No match Resubmitted flow: tunnel0:in_port0000:tci(vlan5,pcp0) mac00:0c:29:f4:9d: 5c->ff:ff:ff:ff:ff:ff type0806 proto1 tos0 ip172.16.0.138->172.16.4.223 port0->0 No match Final flow: tunnel0:in_port0000:tci(0) mac00:0c:29:f4:9d:5c->ff:ff:ff:ff:ff:ff t ype0806 proto1 tos0 ip172.16.0.138->172.16.4.223 port0->0 Datapath actions: set_tci(vid=5,pcp=0),set_tci(vid=5,pcp=6),strip_vlan
2010-12-09 15:00:36 -08:00
utilities/ovs-pcap.1 \
New utility ovs-vsctl.
2009-09-14 10:05:13 -07:00
utilities/ovs-vsctl.8
Import from old repository commit 61ef2b42a9c4ba8e1600f15bb0236765edc2ad45.
2009-07-08 13:19:16 -07:00
utilities_ovs_appctl_SOURCES = utilities/ovs-appctl.c
Makefile: Remove unnecessary includes of SSL_LIBS. SSL_LIBS are needed for libopenvswitch and we include that in lib/automake.mk. It is not necessary to include it for every executable. Signed-off-by: Gurucharan Shetty <gshetty@nicira.com> Acked-by: Ben Pfaff <blp@nicira.com>
2014-03-04 13:23:53 -08:00
utilities_ovs_appctl_LDADD = lib/libopenvswitch.la
Import from old repository commit 61ef2b42a9c4ba8e1600f15bb0236765edc2ad45.
2009-07-08 13:19:16 -07:00
test-controller: Rename to ovs-testcontroller, again install. mininet uses the Open vSwitch controller by default, for testing. CC: 757761@bugs.debian.org Reported-at: https://bugs.debian.org/757761 Requested-by: Tomasz Buchert <tomasz.buchert@inria.fr> Requested-by: Dariusz Dwornikowski <dariusz.dwornikowski@cs.put.poznan.pl> Signed-off-by: Ben Pfaff <blp@nicira.com> Acked-by: Justin Pettit <jpettit@nicira.com>
2014-08-15 10:32:50 -07:00
utilities_ovs_testcontroller_SOURCES = utilities/ovs-testcontroller.c
utilities_ovs_testcontroller_LDADD = lib/libopenvswitch.la $(SSL_LIBS)
Import from old repository commit 61ef2b42a9c4ba8e1600f15bb0236765edc2ad45.
2009-07-08 13:19:16 -07:00
utilities_ovs_dpctl_SOURCES = utilities/ovs-dpctl.c
Makefile: Remove unnecessary includes of SSL_LIBS. SSL_LIBS are needed for libopenvswitch and we include that in lib/automake.mk. It is not necessary to include it for every executable. Signed-off-by: Gurucharan Shetty <gshetty@nicira.com> Acked-by: Ben Pfaff <blp@nicira.com>
2014-03-04 13:23:53 -08:00
utilities_ovs_dpctl_LDADD = lib/libopenvswitch.la
Import from old repository commit 61ef2b42a9c4ba8e1600f15bb0236765edc2ad45.
2009-07-08 13:19:16 -07:00
utilities_ovs_ofctl_SOURCES = utilities/ovs-ofctl.c
ofproto: Improve abstraction by adding function ofproto_parse_name(). This means that ovs-ofctl and ovs-openflowd don't have to use the dpif layer at all, making it easier to change the ofproto implementation.
2011-04-11 15:08:19 -07:00
utilities_ovs_ofctl_LDADD = \
openvswitch: Use libtool and allow building shared libs Currently openvswitch builds all libraries static only. However, libopenvswitch is linked into nearly all openvswitch executables making it hardly possible to run openvswitch on embedded devices (for example running OpenWrt). Convert openvswitch to use libtool for building its internal libs. This allows "--enable-shared" and "--enable-static" as configure arguments. Default is "--disable-shared" thus keeping the current behavior with the only change that static libs are installed by "make install". Since the openvswitch library interfaces are internal and thus not stable (yet) encode the openvswitch version into the library name: libopenvswitch-2.0.90.so Binary size is reduced to around 1/3 when using shared libs. Signed-off-by: Helmut Schaa <helmut.schaa@googlemail.com> Signed-off-by: Ben Pfaff <blp@nicira.com>
2013-12-13 18:54:28 +01:00
ofproto/libofproto.la \
Makefile: Remove unnecessary includes of SSL_LIBS. SSL_LIBS are needed for libopenvswitch and we include that in lib/automake.mk. It is not necessary to include it for every executable. Signed-off-by: Gurucharan Shetty <gshetty@nicira.com> Acked-by: Ben Pfaff <blp@nicira.com>
2014-03-04 13:23:53 -08:00
lib/libopenvswitch.la
Import from old repository commit 61ef2b42a9c4ba8e1600f15bb0236765edc2ad45.
2009-07-08 13:19:16 -07:00
idl: Move vswitch-idl to libopenvswitch. This is cleaner then having multiple programs build the idl independently. Signed-off-by: Ethan Jackson <ethan@nicira.com>
2012-03-15 17:10:41 -07:00
utilities_ovs_vsctl_SOURCES = utilities/ovs-vsctl.c
Makefile: Remove unnecessary includes of SSL_LIBS. SSL_LIBS are needed for libopenvswitch and we include that in lib/automake.mk. It is not necessary to include it for every executable. Signed-off-by: Gurucharan Shetty <gshetty@nicira.com> Acked-by: Ben Pfaff <blp@nicira.com>
2014-03-04 13:23:53 -08:00
utilities_ovs_vsctl_LDADD = lib/libopenvswitch.la
vsctl: Start making it work with ovsdb. This passes at least one test (the one named "add-br a"). It probably doesn't pass any more than that. This is *way* not up to my quality standards, but we are in a super hurry so I'm pushing it anyhow.
2009-12-08 17:18:12 -08:00
Makefile: Compile Linux-specific files based on __linux__ macro. We want to conditionally compile several files based on whether we're building for a Linux host, so we need some Automake conditional for that. Previously this was based on whether Netlink is available and we're not on ESX (since ESX has Netlink but isn't Linux), but it's more straightforward to just test for Linux directly. CC: Luigi Rizzo <rizzo@iet.unipi.it> Signed-off-by: Ben Pfaff <blp@nicira.com>
2014-01-23 15:35:22 -08:00
if LINUX
Build ovs-wdt or nlmon utilities only on Linux. These utilities are Linux-specific.
2010-05-26 10:25:19 -07:00
noinst_PROGRAMS += utilities/nlmon
Import from old repository commit 61ef2b42a9c4ba8e1600f15bb0236765edc2ad45.
2009-07-08 13:19:16 -07:00
utilities_nlmon_SOURCES = utilities/nlmon.c
Makefile: Remove unnecessary includes of SSL_LIBS. SSL_LIBS are needed for libopenvswitch and we include that in lib/automake.mk. It is not necessary to include it for every executable. Signed-off-by: Gurucharan Shetty <gshetty@nicira.com> Acked-by: Ben Pfaff <blp@nicira.com>
2014-03-04 13:23:53 -08:00
utilities_nlmon_LDADD = lib/libopenvswitch.la
Build ovs-wdt or nlmon utilities only on Linux. These utilities are Linux-specific.
2010-05-26 10:25:19 -07:00
endif
ovs-bugtool: Add plugins previously used only under XenServer. All of the xen-bugtool plugins that OVS has previously installed only under XenServer are equally useful with Debian and other distributions, so this commit installs and uses them everywhere.
2011-07-06 10:43:03 -07:00
checkpatch.py: A simple script for finding patch issues Most projects have a checkpatch facility, which can be used as a pre-commit sanity check. This introduces such a mechanism to the Open vSwitch project to catch some of the more silly formatting mistakes which can occur. It is not meant to replace good code review practices, but it can help eliminate the silly code review issues which get added. Suggested-by: Mauricio Vásquez <mauricio.vasquezbernal@studenti.polito.it> Signed-off-by: Aaron Conole <aconole@redhat.com> [blp@ovn.org adjusted long line threshold and treatment of terminal] Signed-off-by: Ben Pfaff <blp@ovn.org>
2016-03-31 10:45:35 -04:00
FLAKE8_PYFILES += utilities/ovs-pcap.in \
ovs-tcpdump: Add a tcpdump wrapper utility Currently, there is some documentation which describes setting up and using port mirrors for bridges. This documentation is helpful to setup a packet capture for specific ports. However, a utility to do such packet capture would be valuable, both as an exercise in documenting the steps an additional time, and as a way of providing an out-of-the-box experience for running a capture. This commit adds a tcpdump-wrapper utility for such purpose. It uses the Open vSwitch python library to add/remove ports and mirrors to/from the Open vSwitch database. It will create a tcpdump instance listening on the mirror port (allowing the user to specify additional arguments), and dump data to the screen (or otherwise). Signed-off-by: Aaron Conole <aconole@redhat.com> Signed-off-by: Ben Pfaff <blp@ovn.org> Acked-by: Flavio Leitner <fbl@sysclose.org>
2016-06-08 17:49:55 -04:00
utilities/checkpatch.py utilities/ovs-dev.py \
utilities: Add another GDB macro for ovs-vswitchd. This commit adds a basic packet metadata macro to the already existing macros in ovs_gdb.py, ovs_dump_packets will print out information about one or more packets. It feeds packets into tcpdump, and the user can pass in tcpdump options to modify how packets are parsed or even write out packets to a pcap file. Example usage: (gdb) break fast_path_processing (gdb) commands ovs_dump_packets packets_ continue end (gdb) continue Thread 1 "ovs-vswitchd" hit Breakpoint 2, fast_path_processing ... 12:01:05.962485 ARP, Ethernet (len 6), IPv4 (len 4), Request who-has 10.1.1.1 tell 10.1.1.2, length 28 Thread 1 "ovs-vswitchd" hit Breakpoint 1, fast_path_processing ... 12:01:05.981214 ARP, Ethernet (len 6), IPv4 (len 4), Reply 10.1.1.1 is-at a6:0f:c3:f0:5f:bd (oui Unknown), length 28 Signed-off-by: Mike Pattrick <mkp@redhat.com> Acked-by: Eelco Chaudron <echaudro@redhat.com> Signed-off-by: Ilya Maximets <i.maximets@ovn.org>
2021-12-17 09:09:17 -05:00
utilities/gdb/ovs_gdb.py \
flake8: also check the ovs-check-dead-ifs script Acked-by: William Tu <u9012063@gmail.com> Signed-off-by: Aaron Conole <aconole@redhat.com> Signed-off-by: Ben Pfaff <blp@ovn.org>
2019-09-13 13:29:03 -04:00
utilities/ovs-check-dead-ifs.in \
python: Enable flake8 checking of ovs-pipegen.py. Signed-off-by: Russell Bryant <russell@ovn.org> Acked-by: Ben Pfaff <blp@ovn.org>
2018-03-13 15:58:59 -04:00
utilities/ovs-tcpdump.in \
utilities: Add upcall USDT probe and associated script. Added the dpif_recv:recv_upcall USDT probe, which is used by the included upcall_monitor.py script. This script receives all upcall packets sent by the kernel to ovs-vswitchd. By default, it will show all upcall events, which looks something like this: TIME CPU COMM PID DPIF_NAME TYPE PKT_LEN FLOW_KEY_LEN 5952147.003848809 2 handler4 1381158 system@ovs-system 0 98 132 5952147.003879643 2 handler4 1381158 system@ovs-system 0 70 160 5952147.003914924 2 handler4 1381158 system@ovs-system 0 98 152 It can also dump the packet and NetLink content, and if required, the packets can also be written to a pcap file. Signed-off-by: Eelco Chaudron <echaudro@redhat.com> Acked-by: Paolo Valerio <pvalerio@redhat.com> Signed-off-by: Ilya Maximets <i.maximets@ovn.org>
2021-12-22 10:18:23 +01:00
utilities/ovs-pipegen.py \
utilities: Updated dpif_nl_exec_monitor.py to debug all operations. Updated the dpif_nl_exec_monitor.py utility to also optionally monitor the other DPIF netlink operations, i.e., DPIF_OP_FLOW_PUT, DPIF_OP_FLOW_DEL and DPIF_OP_FLOW_GET Signed-off-by: Eelco Chaudron <echaudro@redhat.com> Signed-off-by: Aaron Conole <aconole@redhat.com>
2024-08-29 11:23:58 +02:00
utilities/usdt-scripts/dpif_op_nl_monitor.py \
revalidator: Add a USDT probe during flow deletion with purge reason. During normal operations, it is useful to understand when a particular flow gets removed from the system. This can be useful when debugging performance issues tied to ofproto flow changes, trying to determine deployed traffic patterns, or while debugging dynamic systems where ports come and go. Prior to this change, there was a lack of visibility around flow expiration. The existing debugging infrastructure could tell us when a flow was added to the datapath, but not when it was removed or why. This change introduces a USDT probe at the point where the revalidator determines that the flow should be removed. Additionally, we track the reason for the flow eviction and provide that information as well. With this change, we can track the complete flow lifecycle for the netlink datapath by hooking the upcall tracepoint in kernel, the flow put USDT, and the revalidator USDT, letting us watch as flows are added and removed from the kernel datapath. This change only enables this information via USDT probe, so it won't be possible to access this information any other way (see: Documentation/topics/usdt-probes.rst). Also included is a script (utilities/usdt-scripts/flow_reval_monitor.py) which serves as a demonstration of how the new USDT probe might be used going forward. Co-authored-by: Aaron Conole <aconole@redhat.com> Acked-by: Han Zhou <hzhou@ovn.org> Signed-off-by: Aaron Conole <aconole@redhat.com> Signed-off-by: Kevin Sprague <ksprague0711@gmail.com> Signed-off-by: Eelco Chaudron <echaudro@redhat.com>
2024-03-05 10:44:41 -05:00
utilities/usdt-scripts/flow_reval_monitor.py \
utilities: Add upcall statistics to the kernel_delay.py script. This patch installs a kernel return probe on ovs_dp_upcall() to record all successful and failed calls per CPU. The statistics are reported when the script exits, providing insights into the upcall behavior. This is an example output: # UPCALL STATISTICS (TOTAL [CPU_ID: N_UPCALLS_PER_CPU, ...]): Total upcalls : 183247 [0: 8937, 2: 14464, 4: 10372, 6: 4254, ...] Successfull upcalls : 120195 [0: 5945, 2: 6379, 4: 5966, 6: 4254, ...] Failed upcalls : 63052 [0: 2992, 2: 8085, 4: 4406, 8: 2275, ...] 11, EAGAIN : 63052 [0: 2992, 2: 8085, 4: 4406, 8: 2275, ...] Tested-by: Adrian Moreno <amoreno@redhat.com> Reviewed-by: Adrian Moreno <amoreno@redhat.com> Signed-off-by: Eelco Chaudron <echaudro@redhat.com>
2024-12-19 15:29:43 +01:00
utilities/usdt-scripts/kernel_delay.py \
utilities: Add netlink flow operation USDT probes and upcall_cost script. This patch adds a series of NetLink flow operation USDT probes. These probes are in turn used in the upcall_cost Python script, which in addition of some kernel tracepoints, give an insight into the time spent on processing upcall. Signed-off-by: Eelco Chaudron <echaudro@redhat.com> Acked-by: Paolo Valerio <pvalerio@redhat.com> Signed-off-by: Ilya Maximets <i.maximets@ovn.org>
2021-12-22 10:19:02 +01:00
utilities/usdt-scripts/upcall_monitor.py \
utilities/usdt-scripts/upcall_cost.py
python: Run flake8 at build time. If flake8 is installed, run it at build time. Similar to most Makefile targets, run it once and then only run again if the files change. flake8 is set to ignore all error and warning types that currently occur. Future patches will remove items from the ignore list as they are resolved. Signed-off-by: Russell Bryant <russell@ovn.org> Acked-by: Ben Pfaff <blp@ovn.org>
2015-12-21 20:24:34 -05:00
ovs-bugtool: Add plugins previously used only under XenServer. All of the xen-bugtool plugins that OVS has previously installed only under XenServer are equally useful with Debian and other distributions, so this commit installs and uses them everywhere.
2011-07-06 10:43:03 -07:00
include utilities/bugtool/automake.mk
Reference in New Issue Copy Permalink