vsc73xx_vlan_commit_conf(9)

📦 version 7.3.1, in nixpkgs unstable

💅 vsc73xx_vlan_commit_conf — the kernel API manual, bestie edition 🎀

okay so real quick, before we even get into it: this is a page from the Kernel API Manual (kernel-doc girlies rise up ✨), and today's main character is vsc73xx_vlan_commit_conf. Yes it's a mouthful. Yes we're gonna say it like twelve times. Slay.

✨ NAME ✨

vsc73xx_vlan_commit_conf — Update VLAN configuration of a port 🌸

🦋 SYNOPSIS 🦋

int vsc73xx_vlan_commit_conf (struct vsc73xx *vsc , int port );

literally that's the whole thing. two args, one int back. clean. minimal. iconic. 💅

💖 ARGUMENTS 💖

  • vsc — the switch's private data structure 🫶 like, the whole vibe of this switch lives in here
  • port — the port index you're operating on, i.e. the specific port whose life you are about to change ✨

🌈 DESCRIPTION 🌈

okay so here's the tea ☕ — this function updates the VLAN behavior of a port. Not the VLAN table itself, bestie, the behavior. The vibes of the port, if you will.

The way it works: it makes sure that when the port is sitting under a VLAN filtering bridge, the port ends up in one of exactly two states — and no, there is no third option, this is not a choose-your-own-adventure:

  • filtering with tag preservation 🏷️, or
  • filtering with all VLANs egress-untagged 🌈

and if the port is not in one of those two states? Then (and I cannot stress this enough) the port ignores VLAN tags from packets and just applies the port-based VID. That's the fallback. That's the "we tried" state. 💀

You must call this when changes are made to: - the bridge VLAN filtering state of the port 🧚 - the number or attributes of VLANs from the bridge VLAN table, while the port is currently VLAN-aware 👑

like, not "should", not "maybe", must. the port does not let you forget. periodt.

⭐ RETURN ⭐

  • 0 on success 🎉 (we love a zero)
  • negative errno on error 😭 (boo, but at least it's honest)

🔥 SEE ALSO 🔥

and that's the page, bestie!! 🎀 this lil beauty lives under ./drivers/net/dsa, and the version fairy stamped it October 2026 ⭐ — so if you're reading this anytime before that, no you didn't 🙈. go forth and commit those VLAN configs, you absolute icon 👑💅

📦 where this page comes from