Skip to content

VLAN filtering design document#7102

Merged
psafont merged 1 commit into
xapi-project:masterfrom
semarie:srt-wip/design/vlan-filtering
Jun 3, 2026
Merged

VLAN filtering design document#7102
psafont merged 1 commit into
xapi-project:masterfrom
semarie:srt-wip/design/vlan-filtering

Conversation

@semarie
Copy link
Copy Markdown
Contributor

@semarie semarie commented May 28, 2026

I would like to discuss the following design document before proposing the related implementation.

Comment thread doc/content/design/vlan-filtering.md Outdated
Comment thread doc/content/design/vlan-filtering.md
Comment thread doc/content/design/vlan-filtering.md
Comment thread doc/content/design/vlan-filtering.md Outdated

* VIF.set_trunks
* self (ref VIF): reference to a valid VIF;
* tags (set int): The 802.1Q VLANs which will be associated with the VIF.
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Generally good. I agree with adding it to VIF object.
Two tiny points:

  • How about replace the param name tag/tags to vlan/vlans. I think tag is used in the access port, while vlan is more explicit.
  • Could you mention the impact of the new added filed on different cases like VM start, live-migrate, XAPI restart and update from the older version etc.

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

  1. No problem for vlan/vlans renaming.

  2. Regarding impact's mention, I will try to do it but I am unsure I will be able to be exhaustive on all events that could occurs on VIF. In behavior change it tried to explain that the purpose is to synchronize the new trunks attribute on VIF to trunks attribute on Port table in OpenvSwitch. Rereading the paragraph, I added a mention that it isn't only "when a VIF is created" but during the whole lifecycle of the port.

I have mentioned:

  • Update from older version
  • VM start
  • VM migration
  • VIF attribute changes

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

How about replace the param name tag/tags to vlan/vlans. I think tag is used in the access port, while vlan is more explicit.

The usual convention for a parameter name like this is value, which is used for all generated setters.

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I changed the parameters name to follow the usual convention.
thanks.

Copy link
Copy Markdown
Contributor

@changlei-li changlei-li left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

nit: some typos below

Comment thread doc/content/design/vlan-filtering.md Outdated
Comment thread doc/content/design/vlan-filtering.md Outdated
@robhoes
Copy link
Copy Markdown
Member

robhoes commented Jun 1, 2026

I think this looks reasonable. It is helpful to see the design considerations explained in this document and I agree with the choice.

@semarie semarie force-pushed the srt-wip/design/vlan-filtering branch from 574a0c3 to 38893c7 Compare June 2, 2026 09:27
With input from changlei-li, minglumlu, and robhoes

Signed-off-by: Sebastien Marie <semarie@kapouay.eu.org>
@semarie semarie force-pushed the srt-wip/design/vlan-filtering branch from 38893c7 to 76a8128 Compare June 3, 2026 11:44
@semarie
Copy link
Copy Markdown
Contributor Author

semarie commented Jun 3, 2026

I squashed the commits and changed the status to proposed.

Please note that I didn't found documentation about the design document lifecycle. Any pointer would be welcomed.
For now, I am working on the implementation.

@psafont psafont added this pull request to the merge queue Jun 3, 2026
Merged via the queue into xapi-project:master with commit d9aa09d Jun 3, 2026
16 checks passed
@semarie semarie deleted the srt-wip/design/vlan-filtering branch June 3, 2026 13:09
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

5 participants