Skip to content
Closed
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
9 changes: 3 additions & 6 deletions Documentation/admin-guide/hw-vuln/l1tf.rst
Original file line number Diff line number Diff line change
Expand Up @@ -239,9 +239,8 @@ Guest mitigation mechanisms
scenarios.

For further information about confining guests to a single or to a group
of cores consult the cpusets documentation:

https://www.kernel.org/doc/Documentation/admin-guide/cgroup-v1/cpusets.rst
of cores consult the :doc:`cgroup cpusets documentation
<../cgroup-v1/cpusets>`.

.. _interrupt_isolation:

Expand All @@ -266,9 +265,7 @@ Guest mitigation mechanisms

Interrupt affinity can be controlled by the administrator via the
/proc/irq/$NR/smp_affinity[_list] files. Limited documentation is
available at:

https://www.kernel.org/doc/Documentation/core-api/irq/irq-affinity.rst
available at Documentation/core-api/irq/irq-affinity.rst.

.. _smt_control:

Expand Down
2 changes: 1 addition & 1 deletion Documentation/admin-guide/mm/damon/reclaim.rst
Original file line number Diff line number Diff line change
Expand Up @@ -298,4 +298,4 @@ granularity reclamation. ::

.. [1] https://research.google/pubs/pub48551/
.. [2] https://lwn.net/Articles/787611/
.. [3] https://www.kernel.org/doc/html/latest/mm/free_page_reporting.html
.. [3] Documentation/mm/free_page_reporting.rst
2 changes: 1 addition & 1 deletion Documentation/admin-guide/perf-security.rst
Original file line number Diff line number Diff line change
Expand Up @@ -311,7 +311,7 @@ Bibliography
.. [2] `<http://man7.org/linux/man-pages/man2/perf_event_open.2.html>`_
.. [3] `<http://web.eece.maine.edu/~vweaver/projects/perf_events/>`_
.. [4] `<https://perf.wiki.kernel.org/index.php/Main_Page>`_
.. [5] `<https://www.kernel.org/doc/html/latest/security/credentials.html>`_
.. [5] Documentation/security/credentials.rst
.. [6] `<http://man7.org/linux/man-pages/man7/capabilities.7.html>`_
.. [7] `<http://man7.org/linux/man-pages/man2/ptrace.2.html>`_
.. [8] `<https://en.wikipedia.org/wiki/Hardware_performance_counter>`_
Expand Down
3 changes: 1 addition & 2 deletions Documentation/admin-guide/pm/amd-pstate.rst
Original file line number Diff line number Diff line change
Expand Up @@ -798,5 +798,4 @@ Reference
.. [3] Processor Programming Reference (PPR) for AMD Family 19h Model 51h, Revision A1 Processors
https://www.amd.com/system/files/TechDocs/56569-A1-PUB.zip

.. [4] Linux Kernel Selftests,
https://www.kernel.org/doc/html/latest/dev-tools/kselftest.html
.. [4] Documentation/dev-tools/kselftest.rst
23 changes: 11 additions & 12 deletions Documentation/block/blk-mq.rst
Original file line number Diff line number Diff line change
Expand Up @@ -87,17 +87,16 @@ IO Schedulers
There are several schedulers implemented by the block layer, each one following
a heuristic to improve the IO performance. They are "pluggable" (as in plug
and play), in the sense of they can be selected at run time using sysfs. You
can read more about Linux's IO schedulers `here
<https://www.kernel.org/doc/html/latest/block/index.html>`_. The scheduling
happens only between requests in the same queue, so it is not possible to merge
requests from different queues, otherwise there would be cache trashing and a
need to have a lock for each queue. After the scheduling, the requests are
eligible to be sent to the hardware. One of the possible schedulers to be
selected is the NONE scheduler, the most straightforward one. It will just
place requests on whatever software queue the process is running on, without
any reordering. When the device starts processing requests in the hardware
queue (a.k.a. run the hardware queue), the software queues mapped to that
hardware queue will be drained in sequence according to their mapping.
can read more about Linux's IO schedulers at Documentation/block/index.rst.
The scheduling happens only between requests in the same queue, so it is not
possible to merge requests from different queues, otherwise there would be
cache trashing and a need to have a lock for each queue. After the scheduling,
the requests are eligible to be sent to the hardware. One of the possible
schedulers to be selected is the NONE scheduler, the most straightforward one.
It will just place requests on whatever software queue the process is running
on, without any reordering. When the device starts processing requests in the
hardware queue (a.k.a. run the hardware queue), the software queues mapped to
that hardware queue will be drained in sequence according to their mapping.

Hardware dispatch queues
~~~~~~~~~~~~~~~~~~~~~~~~
Expand Down Expand Up @@ -143,7 +142,7 @@ Further reading

- `NOOP scheduler <https://en.wikipedia.org/wiki/Noop_scheduler>`_

- `Null block device driver <https://www.kernel.org/doc/html/latest/block/null_blk.html>`_
- Documentation/block/null_blk.rst

Source code documentation
=========================
Expand Down
3 changes: 1 addition & 2 deletions Documentation/bpf/bpf_iterators.rst
Original file line number Diff line number Diff line change
Expand Up @@ -123,8 +123,7 @@ which often takes time to publish upstream and release. The same is true for pop
tools like `ss <https://man7.org/linux/man-pages/man8/ss.8.html>`_ where any
additional information needs a kernel patch.

To solve this problem, the `drgn
<https://www.kernel.org/doc/html/latest/bpf/drgn.html>`_ tool is often used to
To solve this problem, the :doc:`drgn <drgn>` tool is often used to
dig out the kernel data with no kernel change. However, the main drawback for
drgn is performance, as it cannot do pointer tracing inside the kernel. In
addition, drgn cannot validate a pointer value and may read invalid data if the
Expand Down
5 changes: 2 additions & 3 deletions Documentation/bpf/map_xskmap.rst
Original file line number Diff line number Diff line change
Expand Up @@ -10,7 +10,7 @@ BPF_MAP_TYPE_XSKMAP

The ``BPF_MAP_TYPE_XSKMAP`` is used as a backend map for XDP BPF helper
call ``bpf_redirect_map()`` and ``XDP_REDIRECT`` action, like 'devmap' and 'cpumap'.
This map type redirects raw XDP frames to `AF_XDP`_ sockets (XSKs), a new type of
This map type redirects raw XDP frames to AF_XDP sockets (XSKs), a new type of
address family in the kernel that allows redirection of frames from a driver to
user space without having to traverse the full network stack. An AF_XDP socket
binds to a single netdev queue. A mapping of XSKs to queues is shown below:
Expand Down Expand Up @@ -181,12 +181,11 @@ AF_XDP-forwarding programs in the `bpf-examples`_ directory in the `libxdp`_ rep
For a detailed explanation of the AF_XDP interface please see:

- `libxdp-readme`_.
- `AF_XDP`_ kernel documentation.
- Documentation/networking/af_xdp.rst.

.. note::
The most comprehensive resource for using XSKMAPs and AF_XDP is `libxdp`_.

.. _libxdp: https://github.com/xdp-project/xdp-tools/tree/master/lib/libxdp
.. _AF_XDP: https://www.kernel.org/doc/html/latest/networking/af_xdp.html
.. _bpf-examples: https://github.com/xdp-project/bpf-examples
.. _libxdp-readme: https://github.com/xdp-project/xdp-tools/tree/master/lib/libxdp#using-af_xdp-sockets
Loading
Loading