summaryrefslogtreecommitdiff
path: root/Documentation/intro
diff options
context:
space:
mode:
authorGreg Rose <gvrose8192@gmail.com>2022-07-14 14:23:31 -0700
committerIlya Maximets <i.maximets@ovn.org>2022-07-15 13:45:55 +0200
commit3476bd3932b01767fc0b2a564d9d8bf117726e3a (patch)
tree0844be89a8b43bd7083ba638af99a7bac346c6f4 /Documentation/intro
parentdc433e25ee422fc4b7f062735fbfe12f644e7895 (diff)
downloadopenvswitch-3476bd3932b01767fc0b2a564d9d8bf117726e3a.tar.gz
Documentation: Remove kernel module documentation.
As of Open vSwitch release 2.18 the OVS kernel module is no longer supported. Pull the documentation references. Reviewed-by: David Marchand <david.marchand@redhat.com> Signed-off-by: Greg Rose <gvrose8192@gmail.com> Signed-off-by: Ilya Maximets <i.maximets@ovn.org>
Diffstat (limited to 'Documentation/intro')
-rw-r--r--Documentation/intro/install/fedora.rst24
-rw-r--r--Documentation/intro/install/general.rst63
2 files changed, 0 insertions, 87 deletions
diff --git a/Documentation/intro/install/fedora.rst b/Documentation/intro/install/fedora.rst
index 06a0bd3d5..02481597f 100644
--- a/Documentation/intro/install/fedora.rst
+++ b/Documentation/intro/install/fedora.rst
@@ -132,36 +132,12 @@ tests. This can take several minutes.
$ make rpm-fedora RPMBUILD_OPT="--with check"
-Kernel OVS Tree Datapath RPM
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-
-To build the Open vSwitch kernel module for the currently running kernel
-version, run:
-
-::
-
- $ make rpm-fedora-kmod
-
-To build the Open vSwitch kernel module for another kernel version, the desired
-kernel version can be specified via the `kversion` macro. For example:
-
-::
-
- $ make rpm-fedora-kmod \
- RPMBUILD_OPT='-D "kversion 4.3.4-300.fc23.x86_64"'
-
Installing
----------
RPM packages can be installed by using the command ``rpm -i``. Package
installation requires superuser privileges.
-The `openvswitch-kmod` RPM should be installed first if the Linux OVS tree
-datapath module is to be used. The `openvswitch-kmod` RPM should not be
-installed if only the in-tree Linux datapath or user-space datapath is needed.
-Refer to the :doc:`/faq/index` for more information about the various Open
-vSwitch datapath options.
-
In most cases only the `openvswitch` RPM will need to be installed. The
`python3-openvswitch`, `openvswitch-test`, `openvswitch-devel`, and
`openvswitch-debuginfo` RPMs are optional unless required for a specific
diff --git a/Documentation/intro/install/general.rst b/Documentation/intro/install/general.rst
index a297aadac..c2208bbed 100644
--- a/Documentation/intro/install/general.rst
+++ b/Documentation/intro/install/general.rst
@@ -302,24 +302,6 @@ example::
$ ./configure CFLAGS="-g -O2 -fsanitize=address -fno-omit-frame-pointer -fno-common"
-To build the Linux kernel module, so that you can run the kernel-based switch,
-pass the location of the kernel build directory on ``--with-linux``. For
-example, to build for a running instance of Linux::
-
- $ ./configure --with-linux=/lib/modules/$(uname -r)/build
-
-.. note::
- If ``--with-linux`` requests building for an unsupported version of Linux,
- then ``configure`` will fail with an error message. Refer to the
- :doc:`/faq/index` for advice in that case.
-
-If you wish to build the kernel module for an architecture other than the
-architecture of the machine used for the build, you may specify the kernel
-architecture string using the KARCH variable when invoking the configure
-script. For example, to build for MIPS with Linux::
-
- $ ./configure --with-linux=/path/to/linux KARCH=mips
-
If you plan to do much Open vSwitch development, you might want to add
``--enable-Werror``, which adds the ``-Werror`` option to the compiler command
line, turning warnings into errors. That makes it impossible to miss warnings
@@ -390,51 +372,6 @@ Building
$ make install
-5. If you built kernel modules, you may install them, e.g.::
-
- $ make modules_install
-
- It is possible that you already had a Open vSwitch kernel module installed
- on your machine that came from upstream Linux (in a different directory). To
- make sure that you load the Open vSwitch kernel module you built from this
- repository, you should create a ``depmod.d`` file that prefers your newly
- installed kernel modules over the kernel modules from upstream Linux. The
- following snippet of code achieves the same::
-
- $ config_file="/etc/depmod.d/openvswitch.conf"
- $ for module in datapath/linux/*.ko; do
- modname="$(basename ${module})"
- echo "override ${modname%.ko} * extra" >> "$config_file"
- echo "override ${modname%.ko} * weak-updates" >> "$config_file"
- done
- $ depmod -a
-
- Finally, load the kernel modules that you need. e.g.::
-
- $ /sbin/modprobe openvswitch
-
- To verify that the modules have been loaded, run ``/sbin/lsmod`` and check
- that openvswitch is listed::
-
- $ /sbin/lsmod | grep openvswitch
-
- .. note::
- If the ``modprobe`` operation fails, look at the last few kernel log
- messages (e.g. with ``dmesg | tail``). Generally, issues like this occur
- when Open vSwitch is built for a kernel different from the one into which
- you are trying to load it. Run ``modinfo`` on ``openvswitch.ko`` and on a
- module built for the running kernel, e.g.::
-
- $ /sbin/modinfo openvswitch.ko
- $ /sbin/modinfo /lib/modules/$(uname -r)/kernel/net/bridge/bridge.ko
-
- Compare the "vermagic" lines output by the two commands. If they differ,
- then Open vSwitch was built for the wrong kernel.
-
- If you decide to report a bug or ask a question related to module loading,
- include the output from the ``dmesg`` and ``modinfo`` commands mentioned
- above.
-
.. _general-starting:
Starting