The FDP team is no longer accepting new bugs in Bugzilla. Please report your issues under FDP project in Jira. Thanks.
Bug 1842032 - Bad description of the MPLS BOS field in ovs-fields(7)
Summary: Bad description of the MPLS BOS field in ovs-fields(7)
Keywords:
Status: CLOSED ERRATA
Alias: None
Product: Red Hat Enterprise Linux Fast Datapath
Classification: Red Hat
Component: openvswitch2.13
Version: RHEL 8.0
Hardware: All
OS: Linux
unspecified
unspecified
Target Milestone: ---
: ---
Assignee: Timothy Redaelli
QA Contact: Hekai Wang
URL: https://mail.openvswitch.org/pipermai...
Whiteboard:
Depends On:
Blocks:
TreeView+ depends on / blocked
 
Reported: 2020-05-30 11:17 UTC by Guillaume Nault
Modified: 2020-12-01 15:08 UTC (History)
6 users (show)

Fixed In Version: openvswitch2.13-2.13.0-58
Doc Type: If docs needed, set a value
Doc Text:
Clone Of:
Environment:
Last Closed: 2020-12-01 15:07:43 UTC
Target Upstream Version:
Embargoed:


Attachments (Terms of Use)


Links
System ID Private Priority Status Summary Last Updated
Red Hat Product Errata RHBA-2020:5310 0 None None None 2020-12-01 15:08:09 UTC

Description Guillaume Nault 2020-05-30 11:17:00 UTC
In the ovs-fields.7 manual page, the "MPLS Bottom of Stack Field" paragraph says:
"""
 * When mpls_bos is 1, there is another MPLS label following this one, so the Ethertype passed to pop_mpls should be an MPLS Ethertype. For example: table=0, dl_type=0x8847, mpls_bos=1,actions=pop_mpls:0x8847, goto_table:1"

 * When mpls_bos is 0, this MPLS label is the last one, so the Ethertype passed to pop_mpls should be a non-MPLS Ethertype such as IPv4. For example: table=1, dl_type=0x8847,mpls_bos=0, actions=pop_mpls:0x0800, goto_table:2
 """

The values 0 and 1 have been swapped: when BOS is 1, then no more label stack entries follows. Therefore, the manual page should say:
"""
 * When mpls_bos is 0, there is another MPLS label following this one, so the Ethertype passed to pop_mpls should be an MPLS Ethertype. For example: table=0, dl_type=0x8847, mpls_bos=0,actions=pop_mpls:0x8847, goto_table:1"

 * When mpls_bos is 1, this MPLS label is the last one, so the Ethertype passed to pop_mpls should be a non-MPLS Ethertype such as IPv4. For example: table=1, dl_type=0x8847,mpls_bos=1, actions=pop_mpls:0x0800, goto_table:2
"""

The problem was originally found on RHEL 8, but is also present in the latest git tree, currently at commit 89b522aee379 ("ovsdb-idl: Add function to reset min_index.").

Comment 1 Timothy Redaelli 2020-08-06 16:35:46 UTC
Patch sent upstream

Comment 6 errata-xmlrpc 2020-12-01 15:07:43 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 (openvswitch2.13 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:5310


Note You need to log in before you can comment on or make changes to this bug.