Bug 1847894

Summary: Describe qdiscs and tfilters in nm-settings manpage
Product: Red Hat Enterprise Linux 8 Reporter: Vladimir Benes <vbenes>
Component: NetworkManagerAssignee: Wen Liang <wenliang>
Status: CLOSED ERRATA QA Contact: Matej Berezny <mberezny>
Severity: medium Docs Contact:
Priority: medium    
Version: 8.3CC: acardace, atragler, bgalvani, fge, lrintel, rkhan, sukulkar, thaller, till
Target Milestone: rcKeywords: Triaged
Target Release: 8.0   
Hardware: Unspecified   
OS: Unspecified   
Whiteboard:
Fixed In Version: NetworkManager-1.32.2-1.el8 Doc Type: No Doc Update
Doc Text:
Story Points: ---
Clone Of: Environment:
Last Closed: 2021-11-09 19:28:55 UTC Type: Bug
Regression: --- Mount Type: ---
Documentation: --- CRM:
Verified Versions: Category: ---
oVirt Team: --- RHEL 7.3 requirements from Atomic Host:
Cloudforms Team: --- Target Upstream Version:
Embargoed:

Description Vladimir Benes 2020-06-17 10:00:00 UTC
Description of problem:
now we have only
   tc setting
       Linux Traffic Control Settings.

┌─────────┬──────────────────┬───────────────┬───────────────────────────────────┐
│Key Name │ Value Type       │ Default Value │ Value Description                 │
├─────────┼──────────────────┼───────────────┼───────────────────────────────────┤
│qdiscs   │ array of vardict │               │ Array of TC queueing disciplines. │
├─────────┼──────────────────┼───────────────┼───────────────────────────────────┤
│tfilters │ array of vardict │               │ Array of TC traffic filters.      │
└─────────┴──────────────────┴───────────────┴───────────────────────────────────┘

this seems a bit incomplete

Version-Release number of selected component (if applicable):
1.26

Steps to Reproduce:
1. man nm-settings

Comment 1 Till Maas 2020-08-31 18:56:57 UTC
*** Bug 1546803 has been marked as a duplicate of this bug. ***

Comment 3 Wen Liang 2021-03-01 01:04:44 UTC
since we are currently using the https://developer.gnome.org/NetworkManager/stable/manpages.html for NM documentation, which manual pages should I add the related documentation ? nm-settings-dbus, or nm-settings-nmcli, or nm-settings-ifcfg-rh ?

Comment 4 Thomas Haller 2021-03-01 07:56:05 UTC
(In reply to Wen Liang from comment #3)
> since we are currently using the
> https://developer.gnome.org/NetworkManager/stable/manpages.html for NM
> documentation, which manual pages should I add the related documentation ?
> nm-settings-dbus, or nm-settings-nmcli, or nm-settings-ifcfg-rh ?

all of them. These manual pages describe different aspects of the setting, and the setting is present in all three forms.

That is, you can configure TC settings via nmcli, dbus, ifcfg-rh and keyfile. And -- due to their nature -- the way how this is expressed in detail is not the same and requires (slightly different) documentation.

Comment 5 Wen Liang 2021-03-08 11:18:00 UTC
Upstream PR for fixing it, 
https://gitlab.freedesktop.org/NetworkManager/NetworkManager/-/merge_requests/774

Comment 12 errata-xmlrpc 2021-11-09 19:28:55 UTC
Since the problem described in this bug report should be
resolved in a recent advisory, it has been closed with a
resolution of ERRATA.

For information on the advisory (Moderate: NetworkManager security, bug fix, and enhancement update), and where to find the updated
files, follow the link below.

If the solution does not work for you, open a new bug report.

https://access.redhat.com/errata/RHSA-2021:4361