Bug 1786565

Summary: [RHEL-8/RDMA] No explanation for FILTER-NAME FILTER-VALUE in command 'rdma statistic OBJECT show link [ DEV/PORT_INDEX ] [ FILTER-NAME FILTER-VALUE ]'
Product: Red Hat Enterprise Linux 8 Reporter: zguo <zguo>
Component: iprouteAssignee: Andrea Claudi <aclaudi>
Status: CLOSED ERRATA QA Contact: zguo <zguo>
Severity: medium Docs Contact:
Priority: medium    
Version: 8.1CC: atragler
Target Milestone: rcKeywords: Documentation
Target Release: 8.0Flags: pm-rhel: mirror+
Hardware: x86_64   
OS: Linux   
Whiteboard:
Fixed In Version: iproute-5.3.0-2.el8 Doc Type: If docs needed, set a value
Doc Text:
Story Points: ---
Clone Of: Environment:
Last Closed: 2020-11-04 01:43:46 UTC Type: Enhancement
Regression: --- Mount Type: ---
Documentation: --- CRM:
Verified Versions: Category: ---
oVirt Team: --- RHEL 7.3 requirements from Atomic Host:
Cloudforms Team: --- Target Upstream Version:
Embargoed:

Description zguo 2019-12-26 09:32:40 UTC
Description of problem:


Version-Release number of selected component (if applicable):
iproute-5.3.0-1.el8.x86_64


How reproducible:
Always

Steps to Reproduce:
$ rdma statistic help
$ man rdma statistic


Actual results:
$ rdma statistic help | grep -i FILTER-NAME
       rdma statistic OBJECT show link [ DEV/PORT_INDEX ] [ FILTER-NAME FILTER-VALUE ]
$ man rdma statistic | grep  -i FILTER-NAME

Expected results:
1. I think it's helpful if it explains what's [ FILTER-NAME FILTER-VALUE ] here and the purpose of such a filter

2. There's no parameter [ FILTER-NAME FILTER-VALUE ] in the man page of 'rdma statistic'. Is it better to make help page and man page of 'rdma statistic' to be consistent?

Thanks.

Additional info:

Comment 1 Andrea Claudi 2020-02-28 17:38:43 UTC
Patch submitted upstream: https://patchwork.ozlabs.org/patch/1246756/

Comment 2 Andrea Claudi 2020-03-02 16:57:11 UTC
This is fixed upstream with commit 31824e2299bf5 ("man: rdma-statistic: Add filter description")

Comment 9 errata-xmlrpc 2020-11-04 01:43:46 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 (iproute 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/RHBA-2020:4478