Gentoo Websites Logo
Go to: Gentoo Home Documentation Forums Lists Bugs Planet Store Wiki Get Gentoo!
Bug 479540 - "VLAN (802.1q support)" should indicate sys-apps/iproute2 is required
Summary: "VLAN (802.1q support)" should indicate sys-apps/iproute2 is required
Status: RESOLVED FIXED
Alias: None
Product: [OLD] Docs on www.gentoo.org
Classification: Unclassified
Component: Installation Handbook (show other bugs)
Hardware: All Linux
: Normal normal (vote)
Assignee: Sven Vermeulen (RETIRED)
URL:
Whiteboard:
Keywords:
Depends on:
Blocks:
 
Reported: 2013-08-02 17:20 UTC by Francis Norberg
Modified: 2013-08-15 08:35 UTC (History)
1 user (show)

See Also:
Package list:
Runtime testing required: ---


Attachments

Note You need to log in before you can comment on or make changes to this bug.
Description Francis Norberg 2013-08-02 17:20:35 UTC
http://www.gentoo.org/doc/en/handbook/handbook-x86.xml?part=4&chap=3#doc_chap10

3.j. VLAN (802.1q support)

is very useful. But it doesn't say that sys-apps/iproute2 is required to use VLANS. That would be a helpful note to add.

(also an example using the new naming conventions would be good too, eg:

config_eno1="127.0.0.1 netmask 255.255.255.0 brd 127.0.0.255"
vlans_eno1="3"
config_eno1_3="10.0.0.1 netmask 255.255.255.0"

)

Thanks. Keep up the good work.
Comment 1 Sven Vermeulen (RETIRED) gentoo-dev 2013-08-03 15:26:20 UTC
I don't have much experience with the VLAN stuff, but would the following be a correct write-up of the VLAN support (with your suggestions in it)?

"""
3.j. VLAN (802.1q support)

For VLAN support, emerge net-misc/vconfig. Also make sure that you use iproute2 as configuration module rather than ifconfig.

Virtual LAN is a group of network devices that behave as if they were connected to a single network segment - even though they may not be. VLAN members can only see members of the same VLAN even though they may share the same physical network.

To configure VLANs, first specify the VLAN numbers in /etc/conf.d/net like so:

Code Listing 10.1: Specifying VLAN numbers
  vlans_eth0="1 2"

Next, configure the interface for each VLAN:

Code Listing 10.2: Interface configuration for each VLAN
  config_eth0_1="172.16.3.1 netmask 255.255.254.0"
  routes_eth0_1="default via 172.16.3.254"

  config_eth0_2="172.16.2.1 netmask 255.255.254.0"
  routes_eth0_2="default via 172.16.2.254"

VLAN-specific configurations are handled by vconfig like so:

Code Listing 10.3: Configuring the VLANs
  vlan1_name="vlan1"
  vlan1_ingress="2:6 3:5"
  eth0_vlan1_egress="1:2"

Important: For using some VLAN setups, you may need to consult the variable name documentation.
"""
Comment 2 Sven Vermeulen (RETIRED) gentoo-dev 2013-08-15 08:35:06 UTC
Okay, committed to CVS. Should show up in an hour or so.