Add path to kernel source headers (#1092)

Add the path to kernel source headers in kernel module documentation for reference.
This commit is contained in:
puneetse
2020-03-24 11:25:42 -07:00
committed by GitHub
parent 1e048709b1
commit 6c1d61b9d2
2 changed files with 20 additions and 14 deletions
+3 -2
View File
@@ -39,8 +39,9 @@ Install DKMS
.. _kernel-modules-dkms-install-begin:
The :command:`kernel-native-dkms` bundle provides the DKMS program and
Linux kernel headers, which are required for compiling kernel modules.
The :command:`kernel-native-dkms` bundle provides the DKMS program and Linux
kernel headers, which are placed under :file:`/usr/lib/modules/$(uname
-r)/build/include/` and are required to compile kernel modules.
The :command:`kernel-native-dkms` bundle also:
+17 -12
View File
@@ -56,11 +56,12 @@ following example. See :ref:`swupd-guide` for more information.
Submit a request to add the module
==================================
If the kernel module you need is already open source (for example, in the Linux
upstream) and likely to be useful to others, consider submitting a request to
add or enable it in the |CL| kernel.
If the kernel module you need is already open source (for example, in the
Linux kernel upstream) and likely to be useful to others, consider submitting
a request to add or enable it in the |CL| kernel.
Make enhancement requests to the |CL| 'Distribution Project'_ on GitHub.
Make enhancement requests to the |CL| `Distribution Project on GitHub
<https://github.com/clearlinux/distribution>`_.
.. _kernel-modules-availability-end:
@@ -102,8 +103,9 @@ Build and install kernel module
5.XX.YY-ZZZZ.native
#. Install the kernel dev bundle corresponding to the installed kernel. The
kernel dev bundle contains the kernel headers, which are required for
compiling kernel modules. For example:
kernel dev bundle contains the kernel headers, which are placed under
:file:`/usr/lib/modules/$(uname -r)/build/include/` and are required to
compile kernel modules. For example:
* :command:`linux-dev` for developing against the native kernel.
* :command:`linux-lts-dev` for developing against the LTS kernel.
@@ -112,6 +114,8 @@ Build and install kernel module
sudo swupd bundle-add linux-dev
#. Follow instructions from the kernel module source code to compile the
kernel module. For example:
@@ -174,17 +178,19 @@ Optional: Specify module options and aliases
Use the :command:`modprobe` command to load a module and set options.
:command:`modprobe` may add or remove more than one module due to module
interdependencies. You can specify which options to use with individual modules,
by using configuration files under the :file:`/etc/modprobe.d` directory.
interdependencies. You can specify which options to use with individual
modules, by using configuration files under the :file:`/etc/modprobe.d`
directory.
.. code-block:: bash
sudo mkdir /etc/modprobe.d
All files underneath the :file:`/etc/modprobe.d` directory that end with the
:file:`.conf` extension specify module options to use when loading. You can use
:file:`.conf` files to create convenient aliases for modules or to override the
normal loading behavior altogether for those with special requirements.
:file:`.conf` extension specify module options to use when loading. You can
use :file:`.conf` files to create convenient aliases for modules or to
override the normal loading behavior altogether for those with special
requirements.
Learn more about :command:`modprobe` on the modprobe.d manual page:
@@ -220,4 +226,3 @@ Related topic
* :ref:`kernel-modules-dkms`
.. _`Distribution Project`: https://github.com/clearlinux/distribution