Bug 1628974

Summary:	nftables: man page missing info about vmap
Product:	Red Hat Enterprise Linux 7	Reporter:	Davide F Bragalone <dbragalo>
Component:	nftables	Assignee:	Phil Sutter <psutter>
Status:	CLOSED ERRATA	QA Contact:	Tomas Dolezal <todoleza>
Severity:	medium	Docs Contact:
Priority:	medium
Version:	7.4	CC:	jmaxwell, todoleza
Target Milestone:	rc	Keywords:	ManPageChange
Target Release:	---
Hardware:	x86_64
OS:	Linux
Whiteboard:
Fixed In Version:	nftables-0.8-14.el7	Doc Type:	If docs needed, set a value
Doc Text:		Story Points:	---
Clone Of:
Clones:	1711273 (view as bug list)		Environment:
Last Closed:	2019-08-06 13:06:14 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:
Bug Depends On:
Bug Blocks:	1711273

Description Davide F Bragalone 2018-09-14 14:33:21 UTC

Description of problem:
vmap is not documented in nft man page, there are just it is only in some examples).


Version-Release number of selected component (if applicable):
nftables-0.8-7.el7


Not sure if adding info in man pages is the best solution here. If not, I can ask the doc-team to elaborate more about nft usage in the next RHEL8 networking documentation.

Thanks,
Davide

Comment 2 Phil Sutter 2018-09-14 16:00:00 UTC

Hi Davide,

(In reply to Davide F Bragalone from comment #0)
> Description of problem:
> vmap is not documented in nft man page, there are just it is only in some
> examples).
> 
> 
> Version-Release number of selected component (if applicable):
> nftables-0.8-7.el7
> 
> 
> Not sure if adding info in man pages is the best solution here. If not, I
> can ask the doc-team to elaborate more about nft usage in the next RHEL8
> networking documentation.

Yes, lack of vmap statement is a deficit in nft man page and I think it is the best spot to document it.

Meanwhile you may point the customer at https://wiki.nftables.org/wiki-nftables/index.php/Dictionaries (wiki.nftables.org is a good resource in general).

Cheers, Phil

Comment 3 Phil Sutter 2018-09-28 17:04:44 UTC

Since this is a feature request, planning for this to be resolved in RHEL7.7.

Comment 7 Phil Sutter 2019-04-03 18:08:51 UTC

Upstream commit to backport:

commit 3b29acc8f29944c5cf34259f2e2b5b40b4d0ccdd (origin/master, origin/HEAD)
Author: Phil Sutter <phil>
Date:   Tue Apr 2 15:36:42 2019 +0200

    doc: Add minimal description of (v)map statements
    
    Although quite useful, these were missing in man page. Content loosely
    based on wiki documentation.
    
    Signed-off-by: Phil Sutter <phil>
    Signed-off-by: Pablo Neira Ayuso <pablo>

Comment 11 errata-xmlrpc 2019-08-06 13:06:14 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, 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-2019:2215