mirror of https://lore.kernel.org/lkml/
 help / color / mirror / Atom feed
* [PATCH REPOST] docs: networking: Remove VLAN_TAG_PRESENT from openvswitch doc
@ 2025-02-03 11:30 Andreas Karis
  2025-02-03 13:29 ` Michał Mirosław
  0 siblings, 1 reply; 3+ messages in thread
From: Andreas Karis @ 2025-02-03 11:30 UTC (permalink / raw)
  To: linux-doc
  Cc: ak.karis, linux-kernel, davem, netdev, corbet, pshelar, dev,
	mirq-linux, i.maximets, edumazet, ovs-dev, pabeni, kuba

Since commit 0c4b2d370514 ("net: remove VLAN_TAG_PRESENT"), the kernel
no longer uses VLAN_TAG_PRESENT.
Update the openvswitch documentation which still contained an outdated
reference to VLAN_TAG_PRESENT.

Signed-off-by: Andreas Karis <ak.karis@gmail.com>
---
 Documentation/networking/openvswitch.rst | 5 ++---
 1 file changed, 2 insertions(+), 3 deletions(-)

diff --git a/Documentation/networking/openvswitch.rst b/Documentation/networking/openvswitch.rst
index 1a8353dbf1b6..8d2bbcb92286 100644
--- a/Documentation/networking/openvswitch.rst
+++ b/Documentation/networking/openvswitch.rst
@@ -230,9 +230,8 @@ an all-zero-bits vlan and an empty encap attribute, like this::
     eth(...), eth_type(0x8100), vlan(0), encap()
 
 Unlike a TCP packet with source and destination ports 0, an
-all-zero-bits VLAN TCI is not that rare, so the CFI bit (aka
-VLAN_TAG_PRESENT inside the kernel) is ordinarily set in a vlan
-attribute expressly to allow this situation to be distinguished.
+all-zero-bits VLAN TCI is not that rare, so the CFI bit is ordinarily set
+in a vlan attribute expressly to allow this situation to be distinguished.
 Thus, the flow key in this second example unambiguously indicates a
 missing or malformed VLAN TCI.
 
-- 
2.48.1


^ permalink raw reply	[flat|nested] 3+ messages in thread

* Re: [PATCH REPOST] docs: networking: Remove VLAN_TAG_PRESENT from openvswitch doc
  2025-02-03 11:30 [PATCH REPOST] docs: networking: Remove VLAN_TAG_PRESENT from openvswitch doc Andreas Karis
@ 2025-02-03 13:29 ` Michał Mirosław
  2025-02-03 13:41   ` Ilya Maximets
  0 siblings, 1 reply; 3+ messages in thread
From: Michał Mirosław @ 2025-02-03 13:29 UTC (permalink / raw)
  To: Andreas Karis
  Cc: linux-doc, linux-kernel, davem, netdev, corbet, pshelar, dev,
	i.maximets, edumazet, ovs-dev, pabeni, kuba

On Mon, Feb 03, 2025 at 12:30:12PM +0100, Andreas Karis wrote:
> Since commit 0c4b2d370514 ("net: remove VLAN_TAG_PRESENT"), the kernel
> no longer uses VLAN_TAG_PRESENT.
> Update the openvswitch documentation which still contained an outdated
> reference to VLAN_TAG_PRESENT.

Hi, it would be best to extend this doc saying that the CFI bit is not
usable in openvswitch (unlike in other parts of kernel).

Nevertheless,
Acked-by: Michał Mirosław <mirq-linux@rere.qmqm.pl>

> 
> Signed-off-by: Andreas Karis <ak.karis@gmail.com>
> ---
>  Documentation/networking/openvswitch.rst | 5 ++---
>  1 file changed, 2 insertions(+), 3 deletions(-)
> 
> diff --git a/Documentation/networking/openvswitch.rst b/Documentation/networking/openvswitch.rst
> index 1a8353dbf1b6..8d2bbcb92286 100644
> --- a/Documentation/networking/openvswitch.rst
> +++ b/Documentation/networking/openvswitch.rst
> @@ -230,9 +230,8 @@ an all-zero-bits vlan and an empty encap attribute, like this::
>      eth(...), eth_type(0x8100), vlan(0), encap()
>  
>  Unlike a TCP packet with source and destination ports 0, an
> -all-zero-bits VLAN TCI is not that rare, so the CFI bit (aka
> -VLAN_TAG_PRESENT inside the kernel) is ordinarily set in a vlan
> -attribute expressly to allow this situation to be distinguished.
> +all-zero-bits VLAN TCI is not that rare, so the CFI bit is ordinarily set
> +in a vlan attribute expressly to allow this situation to be distinguished.
>  Thus, the flow key in this second example unambiguously indicates a
>  missing or malformed VLAN TCI.
>  
> -- 
> 2.48.1
> 

-- 
Michał Mirosław

^ permalink raw reply	[flat|nested] 3+ messages in thread

* Re: [PATCH REPOST] docs: networking: Remove VLAN_TAG_PRESENT from openvswitch doc
  2025-02-03 13:29 ` Michał Mirosław
@ 2025-02-03 13:41   ` Ilya Maximets
  0 siblings, 0 replies; 3+ messages in thread
From: Ilya Maximets @ 2025-02-03 13:41 UTC (permalink / raw)
  To: Michał Mirosław, Andreas Karis
  Cc: i.maximets, linux-doc, linux-kernel, davem, netdev, corbet,
	pshelar, dev, edumazet, ovs-dev, pabeni, kuba

On 2/3/25 14:29, Michał Mirosław wrote:
> On Mon, Feb 03, 2025 at 12:30:12PM +0100, Andreas Karis wrote:
>> Since commit 0c4b2d370514 ("net: remove VLAN_TAG_PRESENT"), the kernel
>> no longer uses VLAN_TAG_PRESENT.
>> Update the openvswitch documentation which still contained an outdated
>> reference to VLAN_TAG_PRESENT.
> 
> Hi, it would be best to extend this doc saying that the CFI bit is not
> usable in openvswitch (unlike in other parts of kernel).

FWIW, sch_frag does the same thing.  So, it's not only openvswitch.
Though, yes, sch_frag is probably doing that because TC mimics what
OVS does.

> 
> Nevertheless,
> Acked-by: Michał Mirosław <mirq-linux@rere.qmqm.pl>
> 
>>
>> Signed-off-by: Andreas Karis <ak.karis@gmail.com>
>> ---
>>  Documentation/networking/openvswitch.rst | 5 ++---
>>  1 file changed, 2 insertions(+), 3 deletions(-)
>>
>> diff --git a/Documentation/networking/openvswitch.rst b/Documentation/networking/openvswitch.rst
>> index 1a8353dbf1b6..8d2bbcb92286 100644
>> --- a/Documentation/networking/openvswitch.rst
>> +++ b/Documentation/networking/openvswitch.rst
>> @@ -230,9 +230,8 @@ an all-zero-bits vlan and an empty encap attribute, like this::
>>      eth(...), eth_type(0x8100), vlan(0), encap()
>>  
>>  Unlike a TCP packet with source and destination ports 0, an
>> -all-zero-bits VLAN TCI is not that rare, so the CFI bit (aka
>> -VLAN_TAG_PRESENT inside the kernel) is ordinarily set in a vlan
>> -attribute expressly to allow this situation to be distinguished.
>> +all-zero-bits VLAN TCI is not that rare, so the CFI bit is ordinarily set
>> +in a vlan attribute expressly to allow this situation to be distinguished.
>>  Thus, the flow key in this second example unambiguously indicates a
>>  missing or malformed VLAN TCI.
>>  
>> -- 
>> 2.48.1
>>
> 


^ permalink raw reply	[flat|nested] 3+ messages in thread

end of thread, other threads:[~2025-02-03 13:41 UTC | newest]

Thread overview: 3+ messages (download: mbox.gz / follow: Atom feed)
-- links below jump to the message on this page --
2025-02-03 11:30 [PATCH REPOST] docs: networking: Remove VLAN_TAG_PRESENT from openvswitch doc Andreas Karis
2025-02-03 13:29 ` Michał Mirosław
2025-02-03 13:41   ` Ilya Maximets

This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox

all inboxes | Powered by JetHome®