VCONFIG(8)

📦
version 2.0.5ubuntu5 · 2 versions
, in debian bookworm, debian trixie, ubuntu jammy, ubuntu noble, ubuntu questing, ubuntu resolute, ubuntu stonking

✨ NAME ✨

okay so bestie, we're in section 8 of the System Manager's Manual, and this page is all about vconfig — the VLAN (802.1q) configuration program 💅

🌸 SYNOPSIS 🌸

vconfig [lots of long options]

that's it. that's the whole vibe. lots of long options, no cap 🫶

🦋 DESCRIPTION 🦋

so vconfig is the little program that lets you create and remove vlan-devices on a vlan enabled kernel ✨

and what even is a vlan-device, you ask? they're virtual ethernet devices — virtual ethernet devices which represents the virtual lans on the physical lan. like, the whole point. literally the entire point 👑

💖 OPTIONS 💖

  • add [interface-name] [vlan-id] — Creates a vlan-device on [interface-name]. The resulting vlan-device will be called according to the nameing convention set. 🎀 (yes we're keeping the original spelling, we don't gatekeep typos here, it's giving iconic)
  • rem [vlan-device] — Removes the named vlan-device. bye bestie 💀
  • set_flag [vlan-device] 0 | 1 — When 1 (the default since 2.6.18), ethernet header reorders are turned on. Dumping the device will appear as a common ethernet device without vlans. When 0 however, ethernet headers are not reordered, which results in vlan tagged packets when dumping the device. Usually the default gives no problems, but some packet filtering programs might have problems with it. ⚠️ so like, know your filtering programs before you flip this one
  • set_egress_map [vlan-device] [skb-priority] [vlan-qos] — This flags that outbound packets with a particular skb-priority should be tagged with the particular vlan priority vlan-qos. The default vlan priority is 0. 📤
  • set_ingress_map [vlan-device] [skb-priority] [vlan-qos] — This flags that inbound packets with the particular vlan priority vlan-qos should be queued with a particular skb-priority. The default skb-priority is 0. 📥
  • set_name_type VLAN_PLUS_VID | VLAN_PLUS_VID_NO_PAD | DEV_PLUS_VID | DEV_PLUS_VID_NO_PAD — Sets the way vlan-device names are created. Use vconfig without arguments to see the different formats. ✨ (run it with zero args, it's basically a little fashion show of naming formats)
  • NOTES — VLAN will use Broadcom's NICE interface when the network device supports it. This is necessary, since usually the hardware of these devices already removes the vlan tag from the ethernet packet. The set_flag option on vlan-devices created on such a physical network device will be ignored. Dumping the network-device will show only untagged(non-vlan) traffic, and dumping the vlan-devices will only show traffic intended for that vlan, without the tags. 👀
🚨 real talk: on those NICE-interface devices, your set_flag is doing absolutely nothing. it's not broken, it's just being ignored. the hardware already ate the tag.

🎀 FILES 🎀

  • /proc/net/vlan/config
  • /proc/net/vlan/[vlan-device]

go peek, it's giving receipts 🧚

🌈 SEE ALSO 🌈

💜 AUTHORS 💜

This manual page was written by Ard van Breemen <ard@kwaak.net> 🫶

The vlan patch is written by Ben Greear <greearb@candelatech.com> 🌟

and that's the whole page, bestie — VCONFIG(8), System Manager's Manual, section 8, closing out on that very same VCONFIG(8) footer line 💅✨ mwah, go configure some vlans 👑

📦 where this page comes from