Skip to content

Commit c84f6f6

Browse files
bagasmedavem330
authored andcommitted
Documentation: devlink: Add blank line padding on numbered lists in Devlink Port documentation
kernel test robot reported indentation warnings: Documentation/networking/devlink/devlink-port.rst:220: WARNING: Unexpected indentation. Documentation/networking/devlink/devlink-port.rst:222: WARNING: Block quote ends without a blank line; unexpected unindent. These warnings cause lists (arbitration flow for which the warnings blame to and 3-step subfunction setup) to be rendered inline instead. Also, for the former list, automatic list numbering is messed up. Fix these warnings by adding missing blank line padding. Link: https://lore.kernel.org/linux-doc/[email protected]/ Fixes: 242dd64 ("Documentation: Add documentation for new devlink-rate attributes") Reported-by: kernel test robot <[email protected]> Signed-off-by: Bagas Sanjaya <[email protected]> Signed-off-by: David S. Miller <[email protected]>
1 parent af42736 commit c84f6f6

File tree

1 file changed

+9
-4
lines changed

1 file changed

+9
-4
lines changed

Documentation/networking/devlink/devlink-port.rst

Lines changed: 9 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -130,10 +130,11 @@ it is deployed. Subfunction is created and deployed in unit of 1. Unlike
130130
SRIOV VFs, a subfunction doesn't require its own PCI virtual function.
131131
A subfunction communicates with the hardware through the parent PCI function.
132132

133-
To use a subfunction, 3 steps setup sequence is followed.
134-
(1) create - create a subfunction;
135-
(2) configure - configure subfunction attributes;
136-
(3) deploy - deploy the subfunction;
133+
To use a subfunction, 3 steps setup sequence is followed:
134+
135+
1) create - create a subfunction;
136+
2) configure - configure subfunction attributes;
137+
3) deploy - deploy the subfunction;
137138

138139
Subfunction management is done using devlink port user interface.
139140
User performs setup on the subfunction management device.
@@ -216,13 +217,17 @@ nodes with the same priority form a WFQ subgroup in the sibling group
216217
and arbitration among them is based on assigned weights.
217218

218219
Arbitration flow from the high level:
220+
219221
#. Choose a node, or group of nodes with the highest priority that stays
220222
within the BW limit and are not blocked. Use ``tx_priority`` as a
221223
parameter for this arbitration.
224+
222225
#. If group of nodes have the same priority perform WFQ arbitration on
223226
that subgroup. Use ``tx_weight`` as a parameter for this arbitration.
227+
224228
#. Select the winner node, and continue arbitration flow among it's children,
225229
until leaf node is reached, and the winner is established.
230+
226231
#. If all the nodes from the highest priority sub-group are satisfied, or
227232
overused their assigned BW, move to the lower priority nodes.
228233

0 commit comments

Comments
 (0)