qemu-devel.nongnu.org archive mirror
 help / color / mirror / Atom feed
From: Peter Maydell <peter.maydell@linaro.org>
To: qemu-devel@nongnu.org
Subject: [PULL 09/21] docs/devel/ebpf_rss.rst: Format literals correctly
Date: Mon,  2 Aug 2021 12:58:00 +0100	[thread overview]
Message-ID: <20210802115812.10731-10-peter.maydell@linaro.org> (raw)
In-Reply-To: <20210802115812.10731-1-peter.maydell@linaro.org>

In rST markup, single backticks `like this` represent "interpreted
text", which can be handled as a bunch of different things if tagged
with a specific "role":
https://docutils.sourceforge.io/docs/ref/rst/restructuredtext.html#interpreted-text
(the most common one for us is "reference to a URL, which gets
hyperlinked").

The default "role" if none is specified is "title_reference",
intended for references to book or article titles, and it renders
into the HTML as <cite>...</cite> (usually comes out as italics).

To format a literal (generally rendered as fixed-width font),
double-backticks are required.

ebpf_rss.rst gets this wrong in a few places; correct them.

Signed-off-by: Peter Maydell <peter.maydell@linaro.org>
Reviewed-by: Richard Henderson <richard.henderson@linaro.org>
Reviewed-by: Philippe Mathieu-Daudé <philmd@redhat.com>
Message-id: 20210726142338.31872-4-peter.maydell@linaro.org
---
 docs/devel/ebpf_rss.rst | 18 +++++++++---------
 1 file changed, 9 insertions(+), 9 deletions(-)

diff --git a/docs/devel/ebpf_rss.rst b/docs/devel/ebpf_rss.rst
index e00962577ad..4a68682b31a 100644
--- a/docs/devel/ebpf_rss.rst
+++ b/docs/devel/ebpf_rss.rst
@@ -72,7 +72,7 @@ eBPF RSS implementation
 
 eBPF RSS loading functionality located in ebpf/ebpf_rss.c and ebpf/ebpf_rss.h.
 
-The `struct EBPFRSSContext` structure that holds 4 file descriptors:
+The ``struct EBPFRSSContext`` structure that holds 4 file descriptors:
 
 - ctx - pointer of the libbpf context.
 - program_fd - file descriptor of the eBPF RSS program.
@@ -80,20 +80,20 @@ The `struct EBPFRSSContext` structure that holds 4 file descriptors:
 - map_toeplitz_key - file descriptor of the 'Toeplitz key' map. One element of the 40byte key prepared for the hashing algorithm.
 - map_indirections_table - 128 elements of queue indexes.
 
-`struct EBPFRSSConfig` fields:
+``struct EBPFRSSConfig`` fields:
 
-- redirect - "boolean" value, should the hash be calculated, on false  - `default_queue` would be used as the final decision.
+- redirect - "boolean" value, should the hash be calculated, on false  - ``default_queue`` would be used as the final decision.
 - populate_hash - for now, not used. eBPF RSS doesn't support hash reporting.
-- hash_types - binary mask of different hash types. See `VIRTIO_NET_RSS_HASH_TYPE_*` defines. If for packet hash should not be calculated - `default_queue` would be used.
+- hash_types - binary mask of different hash types. See ``VIRTIO_NET_RSS_HASH_TYPE_*`` defines. If for packet hash should not be calculated - ``default_queue`` would be used.
 - indirections_len - length of the indirections table, maximum 128.
 - default_queue - the queue index that used for packet that shouldn't be hashed. For some packets, the hash can't be calculated(g.e ARP).
 
 Functions:
 
-- `ebpf_rss_init()` - sets ctx to NULL, which indicates that EBPFRSSContext is not loaded.
-- `ebpf_rss_load()` - creates 3 maps and loads eBPF program from the rss.bpf.skeleton.h. Returns 'true' on success. After that, program_fd can be used to set steering for TAP.
-- `ebpf_rss_set_all()` - sets values for eBPF maps. `indirections_table` length is in EBPFRSSConfig. `toeplitz_key` is VIRTIO_NET_RSS_MAX_KEY_SIZE aka 40 bytes array.
-- `ebpf_rss_unload()` - close all file descriptors and set ctx to NULL.
+- ``ebpf_rss_init()`` - sets ctx to NULL, which indicates that EBPFRSSContext is not loaded.
+- ``ebpf_rss_load()`` - creates 3 maps and loads eBPF program from the rss.bpf.skeleton.h. Returns 'true' on success. After that, program_fd can be used to set steering for TAP.
+- ``ebpf_rss_set_all()`` - sets values for eBPF maps. ``indirections_table`` length is in EBPFRSSConfig. ``toeplitz_key`` is VIRTIO_NET_RSS_MAX_KEY_SIZE aka 40 bytes array.
+- ``ebpf_rss_unload()`` - close all file descriptors and set ctx to NULL.
 
 Simplified eBPF RSS workflow:
 
@@ -122,4 +122,4 @@ Simplified eBPF RSS workflow:
 NetClientState SetSteeringEBPF()
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
-For now, `set_steering_ebpf()` method supported by Linux TAP NetClientState. The method requires an eBPF program file descriptor as an argument.
+For now, ``set_steering_ebpf()`` method supported by Linux TAP NetClientState. The method requires an eBPF program file descriptor as an argument.
-- 
2.20.1



  parent reply	other threads:[~2021-08-02 11:59 UTC|newest]

Thread overview: 23+ messages / expand[flat|nested]  mbox.gz  Atom feed  top
2021-08-02 11:57 [PULL 00/21] target-arm queue Peter Maydell
2021-08-02 11:57 ` [PULL 01/21] docs: Add documentation of Arm 'mainstone' board Peter Maydell
2021-08-02 11:57 ` [PULL 02/21] docs: Add documentation of Arm 'kzm' board Peter Maydell
2021-08-02 11:57 ` [PULL 03/21] docs: Add documentation of Arm 'imx25-pdk' board Peter Maydell
2021-08-02 11:57 ` [PULL 04/21] MAINTAINERS: Don't list Andrzej Zaborowski for various components Peter Maydell
2021-08-02 11:57 ` [PULL 05/21] docs: Remove stale TODO comments about license and version Peter Maydell
2021-08-02 11:57 ` [PULL 06/21] docs: Move licence/copyright from HTML output to rST comments Peter Maydell
2021-08-02 11:57 ` [PULL 07/21] docs/devel/build-system.rst: Format literals correctly Peter Maydell
2021-08-02 11:57 ` [PULL 08/21] docs/devel/build-system.rst: Correct typo in example code Peter Maydell
2021-08-02 11:58 ` Peter Maydell [this message]
2021-08-02 11:58 ` [PULL 10/21] docs/devel/migration.rst: Format literals correctly Peter Maydell
2021-08-02 11:58 ` [PULL 11/21] docs/devel: " Peter Maydell
2021-08-02 11:58 ` [PULL 12/21] docs/system/s390x/protvirt.rst: " Peter Maydell
2021-08-02 11:58 ` [PULL 13/21] docs/system/arm/cpu-features.rst: " Peter Maydell
2021-08-02 11:58 ` [PULL 14/21] docs: " Peter Maydell
2021-08-02 11:58 ` [PULL 15/21] docs/about/removed-features: Fix markup error Peter Maydell
2021-08-02 11:58 ` [PULL 16/21] docs/tools/virtiofsd.rst: Delete stray backtick Peter Maydell
2021-08-02 11:58 ` [PULL 17/21] hw/arm/boot: Report error if there is no fw_cfg device in the machine Peter Maydell
2021-08-02 11:58 ` [PULL 18/21] docs: Move bootindex.txt into system section and rstify Peter Maydell
2021-08-02 11:58 ` [PULL 19/21] docs: Move the protocol part of barrier.txt into interop Peter Maydell
2021-08-02 11:58 ` [PULL 20/21] ui/input-barrier: Move TODOs from barrier.txt to a comment Peter Maydell
2021-08-02 11:58 ` [PULL 21/21] docs: Move user-facing barrier docs into system manual Peter Maydell
2021-08-02 13:51 ` [PULL 00/21] target-arm queue Peter Maydell

Reply instructions:

You may reply publicly to this message via plain-text email
using any one of the following methods:

* Save the following mbox file, import it into your mail client,
  and reply-to-all from there: mbox

  Avoid top-posting and favor interleaved quoting:
  https://en.wikipedia.org/wiki/Posting_style#Interleaved_style

* Reply using the --to, --cc, and --in-reply-to
  switches of git-send-email(1):

  git send-email \
    --in-reply-to=20210802115812.10731-10-peter.maydell@linaro.org \
    --to=peter.maydell@linaro.org \
    --cc=qemu-devel@nongnu.org \
    /path/to/YOUR_REPLY

  https://kernel.org/pub/software/scm/git/docs/git-send-email.html

* If your mail client supports setting the In-Reply-To header
  via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line before the message body.
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for NNTP newsgroup(s).