# LINUX VLAN + Cisco HOWTO

0-0-0-0-0-0-0-0-0-0-0-0-0-0-0-0-0-0-0-0-0-0-0-0-0-0-0-0-0-0-0-0-0-0-0-0-0-0

      The Linux VLAN HOWTO

      VLAN Mailing list: vlan@candelatech.com
      Kristjan Kotkas kristjan@data.ee
      Ben Greear greearb@candelatech.com

NOTE: If you can get ping to work, but telnet/http/ssh/etc hangs, then you most likely have a driver that is broken with regard to 802.1Q vlans. There are various patches for different drivers below. As a last ditch effort, you can set the MTU on your VLAN interface to 1496 as opposed to 1500. If you are unaware of the consequences of such a thing, please consider getting supported hardware and/or ask the writer of your driver for a patch. --Ben

## Contents

1. Who, why and where
2. Actual info on how to make it work.
3. Specific work-arounds/patches for certain configurations.
   - Tulip driver patch.
   - eepro100 driver patch.
   - SysKonnect sk98lin driver patch.
   - 3c59X driver patch.
   - natsemi driver patch.
   - 3c509b driver patch.
   - pcmcia drivers.
4. Scripts and Recipes.

1. META
   1. This is the first HOWTO for the "802.1Q VLAN implementation for Linux"

      Homepage: http://scry.wanfear.com/~greear/vlan.html Mailing List: VLAN@Scry.WANfear.com

   2. Copyright

      This document is part of the Linux HOWTO project. The copyright notice is the following: Unless otherwise stated, Linux HOWTO documents are copyrighted by their respective authors. Linux HOWTO documents may be reproduced and distributed in whole or in part, in any medium physical or electronic, as long as this copyright notice is retained on all copies. Commercial redistribution is allowed and encouraged; however, the author would like to be notified of any such distributions. All translations, derivative works, or aggregate works incorporating any Linux HOWTO documents must be covered under this copyright notice. That is, you may not produce a derivative work from a HOWTO and impose additional restrictions on its distribution. Exceptions to these rules may be granted under certain conditions; please contact the Linux HOWTO coordinator at the address given below. In short, we wish to promote dissemination of this information through as many channels as possible. However, we do wish to retain copyright on the HOWTO documents, and would like to be notified of any plans to redistribute the HOWTOs. If you have questions, please contact Tim Bynum, the Linux HOWTO coordinator, at linux-howto@sunsite.unc.edu via email.

   3. Disclaimer

      As usual: the author IS NOT responsible for any damage. For the correct wording, see the relevant part of the GNU GPL 0.1.1

   4. Credits

      Thanks to Ben Greear http://www.candelatech.com/~greear for the VLAN project and also to all the people who have contributed to the project.

   5. General

      What is VLAN is not described in this document. Info on the VLAN protocol can be found at http://standards.ieee.org/getieee802/download/802.1Q-1998.pdf.

2. Software/Hardware (Cisco-specific setup, with some general info as well.)

   1. VLAN installation & Configuration on the Linux Side.

          NOTE:  This is fairly old.  I'm leaving it in for historical reasons, but
          be aware that VLAN is included in the later 2.4 kernels, so most folks do
          NOT have to patch their kernel. --Ben

          * Linux kernel 2.2.14
          * Vlan 0.0.10 Patched into it
          * Cisco Catalyst 2900XL
          * 3Com 3C509B NIC using patched driver 3c59x

          Currently VLAN is not part of the kernel distribution so you need to patch
          it into a supported Linux kernel and re-compile.

          You need the kernel source.  If you don't have it already, you can get from
          ftp.kernel.org or from one of its mirrors.  If this scares you, read the
          KERNEL-HOWTO.

          It is assumed that you have the linux kernel source extracted, and found at:
          $HOME/linux  If your setup is different, then some of these commands may
          need to be slightly different.

          Download the VLAN package from the vlan homepage and extract it's contents.
          tar -xvzf vlan*.tar.gz

          Go to the vlan directory, build the vlan tools by just typing:
          make

          After this you get a programm named <vconfig>. This program manages all VLAN
          specific configurations.

          Now patch the kernel.
          Go to the linux directory
          cd linux
          (if you installed the kernel source from some rpm based distribution it is
          something like /usr/src/linux)
          patch the kernel by typing:

          patch -p 1 < $HOME/vlan/vlan.patch (patch is in the vlan directory)

          Time to compile your kernel. Use the make menuconfig command in your
          linux directory to select your kernel options. The option related to
          802.1Q VLANs is found under the Networking options.

          Additional help for kernel compilation can be found in KERNEL-HOWTO

          Assuming your kernel compiled cleanly, you are now ready to use it.
          Install your kernel in the normal manner (fix up your /etc/lilo.conf file
          appropriately and run lilo as root.)
          Reboot your computer and choose your new kernel.

          As your computer comes back to life, there will be little sign that you are
          now 802.1Q capable.
          You should see something like this:

                  802.1Q VLAN Support v0.10  Ben Greear <greearb@candelatech.com>
                  vlan Initialization complete.

          Your system is now vlan ready, lets configure some vlans:
          I'm assuming that your VLAN capable network card is eth0.

          First, set the eth0 state to down:

          ifconfig eth0 down

      Ben's Note: Regarding the next section, you can run plain ethernet and VLAN over the same NIC, but you may not want to..

          Whatever your previous netconf was, you should move everything to vlans.
          This means, that you don't set ip address to the real interface, but set it to
          vlan interface. To set your eth0 with no ip:

          ifconfig eth0 0.0.0.0 up

          !note!
          YOU MUST SET THE ETH0 TO UP, or it wont work. (ifconfig eth0 up)

          Add some vlans; goto your vlan directory where you previously compiled
          vconfig and type:

          vconfig add eth0 2

          ! Little note about VLAN 1. In Cisco systems it is the default VLAN
          so you MUST start using vlans from 2.

          This will create device vlan0002 to your system. Linux will think, that it
          is just another network device, so you can configure it like any other. Also
          you should see the interface by typing

          ifconfig -a

          Lets make some conf on the vlan then:
          ifconfig -i vlan0002 10.0.231.1 broadcast 10.0.231.0 netmask 255.255.255.0 up

          This ends the configuration at the linux side.

   2. Specific Extreme Networks Configuration

            From: Craig Metz: cmetz@inner.net

          Extreme configuration example:

            create vlan v42
            config vlan v42 tag 42
            config vlan v42 add port 10 tagged

            ... will create a vlan named v42, whose 802.1Q tag is 42, and connect port
          10 (tag 42) to that vlan.

   3. Cisco-specific configuration

          Cisco Conf
          configure the port you want to use as the trunk:

          telnet switch or use the console port

          ena
          (will prompt for password, so have it ready)

          conf t
          interface FastEthernet0/24 (it doesnt have to be 0/24)
           duplex full
           speed 100
           switchport trunk encapsulation dot1q
           switchport trunk allowed vlan 2
           switchport mode trunk

          This conf will do the following:

          Set the port to full duplex mode; force the port to 100Mb mode; set the port
          vlan encapsulation to support 802.1Q; tell the
          switch that the port is allowed to run vlans through (even if you set just
          VLAN 2, cisco will automatically add VLAN 1 and VLAN 1002-1005) to the port
          and set the port to trunk mode aswell. Trunk mode tells the switch that
          a number of VLANS can go through it.

          Last line is usually the mother of all screw-ups. If you forget that, you
          won't get your VLAN working. Simple as that.

          Now configure some other port to be used as the destination for the vlan:

          conf t
          interface FastEthernet0/1
           duplex half
           speed 10
           switchport access vlan 2
          end

          Here we tell the switch to force the port 1 to half duplex 10Mb mode (normal
          10 Mb NIC) and only traffic from interface VLAN 2 can go through this port.
          also you can use a number of ports with VLAN 2, like a HUB ;)

          You should now connect some other device to port 1.

          Let it have an ip of eg. 10.0.231.2 mask 255.255.255.0

          Ping linux from it

          ping 10.0.231.1

          If it replies scream: "YESS!!" This means, that VLAN is working.

          Hard truth: It's not over, till its over.
          if this works, then you are out of the woods, if not, well I hear that
          tcpdump is a good tool ;-) and tcpdump that came with the vlan package even
          better tool. (if you want to dump, use the one that came with vlan package)

      NOTE: Ethereal also supports VLANs, and is much more beautiful than tcpdump, if you have GUI capabilities.

          If you can ping the linux and from linux the host, you should try the
          following at linux side:

          ping -s 1476 10.0.231.2

          If there is no reply, there is something foggy with the NIC. and you
          should start debugging.  If ping -s 100 10.0.231.2 works, then it is most likely
          an MTU problem with your NIC/Driver.

3. ### Specific patches and work-arounds for various configurations.

   1. My Tulip-based card has MTU problems.

             Here is a patch sent in by Ben McKeegan:
          Dear VLAN list members,

          Courtesy of my new employer, I've finally got around to updating my tulip
          vlan patch for use with linux 2.4.x.  I've also taken the opportunity to
          do a rewrite and fix various (non-critical) flaws in my previous patch
          (which was against 2.2.x).  The patch allows the driver to receive vlan
          frames with maximum MTU.

          Hopefully this rewrite will help satisfy some of the concerns of the 2.4
          kernel driver maintainers and thus aid inclusion of the patch in the
          main driver.

          The old patch would erroneously allow incoming frames sized between 1519
          and 1536 bytes excluding the CRC.  The new patch should correctly limit
          this to 1518, the maximum size for VLANs.  The old patch also needlessly
          increased various constants.

          I believe there was some suggestion that the old patch disabled all length
          error checking and opened the system to DoS attacks from massively
          oversized packets.  This is was never really the case, although the above
          mentioned bug did exist.  The patch only disabled checking of the 'Frame
          Too Long' flag which indicates the frame exceeds 1518 bytes (including the
          CRC).  The NIC does not take any special action when this flag is set and
          it does not stop the buffers getting filled up - the protection against
          DoS comes from the receive timer which has a separate error flag that gets
          set when length exceeds 2048 bytes.  The 'Frame Too Long' flag is
          basically just a summary of the length bits that are passed as part of the
          same descriptor as the flag.  The patch just explicitly checks the length
          instead of relying on the flag.

          The unpatched driver uses 'magic number' constants to check the receive
          status code.  Having worked out what these meant from the documentation,
          in the old patch I replaced them with a similar magic number.  The new
          patch replaces them with a series of verbose enumerations.  Any worthwhile
          compiler should optimize these down to a single constant, but these make
          the code much easier to read.  (In fact, its a lot easier to tell what the
          patched driver does than what the unpatched driver does.

          I have tested the new patch on our own systems (using chipset 21143 rev
          65), and it works ok, but I would appreciate feedback from other people.
          With a lot of testing and a bit of luck and persuasion this patch might
          make it into the kernel.

          Ben, I would be grateful if you could update the section of your how-to
          containing my old patch, and add a note about the problems with the old
          patch alongside it.  (Perhaps someone else may wish to backport the new
          patch to 2.2)

          Regards,

          Ben McKeegan.

          diff -ur linux-2.4.19/drivers/net/tulip/interrupt.c linux-2.4.19-tulip-vlan/drivers/net/tulip/interrupt.c
          --- linux-2.4.19/drivers/net/tulip/interrupt.c	Fri Nov  9 21:45:35 2001
          +++ linux-2.4.19-tulip-vlan/drivers/net/tulip/interrupt.c	Mon Sep 16 13:17:40 2002
          @@ -122,14 +122,36 @@
           	/* If we own the next entry, it is a new packet. Send it up. */
           	while ( ! (tp->rx_ring[entry].status & cpu_to_le32(DescOwned))) {
           		s32 status = le32_to_cpu(tp->rx_ring[entry].status);
          +		short pkt_len;

           		if (tulip_debug > 5)
           			printk(KERN_DEBUG "%s: In tulip_rx(), entry %d %8.8x.\n",
           				   dev->name, entry, status);
           		if (--rx_work_limit < 0)
          -			break;
          -		if ((status & 0x38008300) != 0x0300) {
          -			if ((status & 0x38000300) != 0x0300) {
          +		        break;
          +
          +		/*
          +		  Omit the four octet CRC from the length.
          +		  (May not be considered valid until we have
          +		  checked status for RxLengthOver2047 bits)
          +                */
          +		pkt_len = ((status >> 16) & 0x7ff) - 4;
          +
          +		/*
          +		  Maximum pkt_len is 1518 (1514 + vlan header)
          +		  Anything higher than this is always invalid
          +		  regardless of RxLengthOver2047 bits
          +		*/
          +
          +		if ((status & (RxLengthOver2047 |
          +			       RxDescCRCError |
          +			       RxDescCollisionSeen |
          +			       RxDescRunt |
          +			       RxDescDescErr |
          +			       RxWholePkt))        != RxWholePkt
          +		    || pkt_len > 1518 ) {
          +			if ((status & (RxLengthOver2047 |
          +				       RxWholePkt))         != RxWholePkt) {
           				/* Ingore earlier buffers. */
           				if ((status & 0xffff) != 0x7fff) {
           					if (tulip_debug > 1)
          @@ -138,31 +160,21 @@
           							   dev->name, status);
           					tp->stats.rx_length_errors++;
           				}
          -			} else if (status & RxDescFatalErr) {
          +			} else {
           				/* There was a fatal error. */
           				if (tulip_debug > 2)
           					printk(KERN_DEBUG "%s: Receive error, Rx status %8.8x.\n",
           						   dev->name, status);
           				tp->stats.rx_errors++; /* end of a packet.*/
          -				if (status & 0x0890) tp->stats.rx_length_errors++;
          +				if (pkt_len > 1518 ||
          +				    status & RxDescRunt) tp->stats.rx_length_errors++;
           				if (status & 0x0004) tp->stats.rx_frame_errors++;
           				if (status & 0x0002) tp->stats.rx_crc_errors++;
           				if (status & 0x0001) tp->stats.rx_fifo_errors++;
           			}
           		} else {
          -			/* Omit the four octet CRC from the length. */
          -			short pkt_len = ((status >> 16) & 0x7ff) - 4;
           			struct sk_buff *skb;

          -#ifndef final_version
          -			if (pkt_len > 1518) {
          -				printk(KERN_WARNING "%s: Bogus packet size of %d (%#x).\n",
          -					   dev->name, pkt_len, pkt_len);
          -				pkt_len = 1518;
          -				tp->stats.rx_length_errors++;
          -			}
          -#endif
          -
           #ifdef CONFIG_NET_HW_FLOWCONTROL
                                   drop = atomic_read(&netdev_dropping);
                                   if (drop)
          diff -ur linux-2.4.19/drivers/net/tulip/tulip.h linux-2.4.19-tulip-vlan/drivers/net/tulip/tulip.h
          --- linux-2.4.19/drivers/net/tulip/tulip.h	Fri Nov  9 21:45:35 2001
          +++ linux-2.4.19-tulip-vlan/drivers/net/tulip/tulip.h	Mon Sep 16 11:55:33 2002
          @@ -186,11 +186,44 @@

           enum desc_status_bits {
           	DescOwned = 0x80000000,
          -	RxDescFatalErr = 0x8000,
          +
          +        /*
          +	   Error summary flag is logical or of 'CRC Error',
          +	   'Collision Seen', 'Frame Too Long', 'Runt' and
          +	   'Descriptor Error' flags generated within tulip chip.
          +	*/
          +        RxDescErrorSummary = 0x8000,
          +
          +	RxDescCRCError = 0x0002,
          +        RxDescCollisionSeen = 0x0040,
          +
          +        /*
          +	   'Frame Too Long' flag is set if packet length including CRC
          +	   exceeds 1518.  However, a full sized VLAN tagged frame is
          +	   1522 bytes including CRC.
          +
          +	   The tulip chip does not block oversized frames, and if this
          +	   flag is set on a receive descriptor it does not indicate
          +	   the frame has been truncated.  The receive descriptor also
          +	   includes the actual length.  Therefore we can safety ignore
          +	   this flag and check the length ourselves.
          +        */
          +        RxDescFrameTooLong = 0x0080,
          +	RxDescRunt = 0x0800,
          +	RxDescDescErr = 0x4000,
           	RxWholePkt = 0x0300,
          +
          +	/*
          +	  Top three bits of 14 bit frame length (status bits 27-29)
          +          should never be set as that would make frame over 2047 bytes.
          +	  The Receive Watchdog flag (bit 4) may indicate the length is
          +          over 2048 and the length field is invalid.
          +	*/
          +	RxLengthOver2047 = 0x38000010
           };

          +
           enum t21041_csr13_bits {
           	csr13_eng = (0xEF0<<4), /* for eng. purposes only, hardcode at EF0h */
           	csr13_aui = (1<<3), /* clear to force 10bT, set to force AUI/BNC */

   2. My eepro100 has MTU problems.

      NOTE: Intel's e100 driver works out-of-the-box. --Ben

      Here is a patch sent in by gleb@nbase.co.il

               filename="linux-2.2.14-eepro100-vlan.patch"

          --- linux/drivers/net/eepro100.c        Tue Oct 26 20:53:40 1999
          +++ linux1/drivers/net/eepro100.c       Sun May 14 07:47:34 2000
          @@ -377,12 +377,12 @@
           const char i82557_config_cmd[22] = {
                  22, 0x08, 0, 0,  0, 0x80, 0x32, 0x03,  1, /* 1=Use MII  0=Use AUI */
                  0, 0x2E, 0,  0x60, 0,
          -       0xf2, 0x48,   0, 0x40, 0xf2, 0x80,              /* 0x40=Force full-duplex */
          +       0xf2, 0x48,   0, 0x40, 0xfa, 0x80,              /* 0x40=Force full-duplex */
                  0x3f, 0x05, };
           const char i82558_config_cmd[22] = {
                  22, 0x08, 0, 1,  0, 0x80, 0x22, 0x03,  1, /* 1=Use MII  0=Use AUI */
                  0, 0x2E, 0,  0x60, 0x08, 0x88,
          -       0x68, 0, 0x40, 0xf2, 0xBD,              /* 0xBD->0xFD=Force full-duplex */
          +       0x68, 0, 0x40, 0xfa, 0xBD,              /* 0xBD->0xFD=Force full-duplex */
                  0x31, 0x05, };

           /* PHY media interface chips. */

   3. My SysKonnect sk98lin doesn't work (submitted by: Patrick Schaaf <bof@bof.de>)

      Here's a piece needed to get SysKonnect sk98lin driven cards to play nice; they recognize and drop incoming VLAN tagged frames in the driver, the patch below removes that check. Tested a bit with a Cisco Catalyst 6509 on the other side, and a fibre link, works like a charm. The card and driver already supports MTUs up to over 9000, so no problem on that side.

          diff -urN linux/drivers/net/sk98lin/skge.c blues/drivers/net/sk98lin/skge.c
          --- linux/drivers/net/sk98lin/skge.c    Mon Jun 19 20:42:38 2000
          +++ blues/drivers/net/sk98lin/skge.c    Mon Aug  7 09:43:18 2000
          @@ -1948,7 +1948,7 @@

                          if ((Control & RX_CTRL_STAT_VALID) == RX_CTRL_STAT_VALID &&
                                  (FrameStat &
          -                       (XMR_FS_ANY_ERR | XMR_FS_1L_VLAN | XMR_FS_2L_VLAN))
          +                       (XMR_FS_ANY_ERR /*| XMR_FS_1L_VLAN*/ | XMR_FS_2L_VLAN))
                                   == 0) {
                                  SK_DBG_MSG(NULL, SK_DBGMOD_DRV,
                                          SK_DBGCAT_DRV_RX_PROGRESS,("V"));

   4. My 3C59X has MTU problems.

      Various contributors, most recently: Richard Fuchs

          --- 3c59x.c-ori	2003-07-02 15:26:26.000000000 +0200
          +++ 3c59x.c	2003-07-02 15:40:26.000000000 +0200
          @@ -308,6 +308,9 @@
              code size of a per-interface flag is not worthwhile. */
           static char mii_preamble_required;

          +/* The Ethernet Type used for 802.1q tagged frames */
          +#define VLAN_ETHER_TYPE 0x8100
          +
           #define PFX DRV_NAME ": "

          @@ -655,7 +658,7 @@
           	Wn2_ResetOptions=12,
           };
           enum Window3 {			/* Window 3: MAC/config bits. */
          -	Wn3_Config=0, Wn3_MAC_Ctrl=6, Wn3_Options=8,
          +	Wn3_Config=0, Wn3_MaxPktSize=4, Wn3_MAC_Ctrl=6, Wn3_Options=8,
           };

           #define BFEXT(value, offset, bitcount)  \
          @@ -683,7 +686,8 @@
           	Media_LnkBeat = 0x0800,
           };
           enum Window7 {					/* Window 7: Bus Master control. */
          -	Wn7_MasterAddr = 0, Wn7_MasterLen = 6, Wn7_MasterStatus = 12,
          +	Wn7_MasterAddr = 0, Wn7_VlanEtherType=4, Wn7_MasterLen = 6,
          +	Wn7_MasterStatus = 12,
           };
           /* Boomerang bus master control registers. */
           enum MasterCtrl {
          @@ -780,7 +784,8 @@
           		pm_state_valid:1,				/* power_state[] has sane contents */
           		open:1,
           		medialock:1,
          -		must_free_region:1;				/* Flag: if zero, Cardbus owns the I/O region */
          +		must_free_region:1,				/* Flag: if zero, Cardbus owns the I/O region */
          +		large_frames:1;					/* accept large frames */
           	int drv_flags;
           	u16 status_enable;
           	u16 intr_enable;
          @@ -848,6 +853,9 @@
           static int vortex_ioctl(struct net_device *dev, struct ifreq *rq, int cmd);
           static void vortex_tx_timeout(struct net_device *dev);
           static void acpi_set_WOL(struct net_device *dev);
          +#if defined(CONFIG_VLAN_8021Q) || defined(CONFIG_VLAN_8021Q_MODULE)
          +static void set_8021q_mode(struct net_device *dev, int enable);
          +#endif

           /* This driver uses 'options' to pass the media type, full-duplex flag, etc. */
           /* Option count limit only -- unlimited interfaces are supported. */
          @@ -1031,6 +1039,7 @@
           	dev->base_addr = ioaddr;
           	dev->irq = irq;
           	dev->mtu = mtu;
          +	vp->large_frames = mtu > 1500;
           	vp->drv_flags = vci->drv_flags;
           	vp->has_nway = (vci->drv_flags & HAS_NWAY) ? 1 : 0;
           	vp->io_size = vci->io_size;
          @@ -1450,7 +1459,7 @@

           	/* Set the full-duplex bit. */
           	outw(	((vp->info1 & 0x8000) || vp->full_duplex ? 0x20 : 0) |
          -		 	(dev->mtu > 1500 ? 0x40 : 0) |
          +		 	(vp->large_frames ? 0x40 : 0) |
           			((vp->full_duplex && vp->flow_ctrl && vp->partner_flow_ctrl) ? 0x100 : 0),
           			ioaddr + Wn3_MAC_Ctrl);

          @@ -1534,6 +1543,10 @@
           	}
           	/* Set receiver mode: presumably accept b-case and phys addr only. */
           	set_rx_mode(dev);
          +#if defined(CONFIG_VLAN_8021Q) || defined(CONFIG_VLAN_8021Q_MODULE)
          +	/* enable 802.1q tagged frames */
          +	set_8021q_mode(dev, 1);
          +#endif
           	outw(StatsEnable, ioaddr + EL3_CMD); /* Turn on statistics. */

           //	issue_and_wait(dev, SetTxStart|0x07ff);
          @@ -1674,7 +1687,7 @@
           						/* Set the full-duplex bit. */
           						EL3WINDOW(3);
           						outw(	(vp->full_duplex ? 0x20 : 0) |
          -								(dev->mtu > 1500 ? 0x40 : 0) |
          +								(vp->large_frames ? 0x40 : 0) |
           								((vp->full_duplex && vp->flow_ctrl && vp->partner_flow_ctrl) ? 0x100 : 0),
           								ioaddr + Wn3_MAC_Ctrl);
           						if (vortex_debug > 1)
          @@ -1897,6 +1910,10 @@
           			issue_and_wait(dev, RxReset|0x07);
           			/* Set the Rx filter to the current state. */
           			set_rx_mode(dev);
          +#if defined(CONFIG_VLAN_8021Q) || defined(CONFIG_VLAN_8021Q_MODULE)
          +			/* enable 802.1q VLAN tagged frames */
          +			set_8021q_mode(dev, 1);
          +#endif
           			outw(RxEnable, ioaddr + EL3_CMD); /* Re-enable the receiver. */
           			outw(AckIntr | HostError, ioaddr + EL3_CMD);
           		}
          @@ -2494,6 +2511,11 @@
           	outw(RxDisable, ioaddr + EL3_CMD);
           	outw(TxDisable, ioaddr + EL3_CMD);

          +#if defined(CONFIG_VLAN_8021Q) || defined(CONFIG_VLAN_8021Q_MODULE)
          +	/* Disable receiving 802.1q tagged frames */
          +	set_8021q_mode(dev, 0);
          +#endif
          +
           	if (dev->if_port == XCVR_10base2)
           		/* Turn off thinnet power.  Green! */
           		outw(StopCoax, ioaddr + EL3_CMD);
          @@ -2758,6 +2780,50 @@
           	outw(new_mode, ioaddr + EL3_CMD);
           }

          +#if defined(CONFIG_VLAN_8021Q) || defined(CONFIG_VLAN_8021Q_MODULE)
          +/* Setup the card so that it can receive frames with an 802.1q VLAN tag.
          +   Note that this must be done after each RxReset due to some backwards
          +   compatibility logic in the Cyclone and Tornado ASICs */
          +static void set_8021q_mode(struct net_device *dev, int enable)
          +{
          +	struct vortex_private *vp = (struct vortex_private *)dev->priv;
          +	long ioaddr = dev->base_addr;
          +	int old_window = inw(ioaddr + EL3_CMD);
          +	int mac_ctrl;
          +
          +	if (vp->drv_flags&IS_CYCLONE || vp->drv_flags&IS_TORNADO) {
          +		/* cyclone and tornado chipsets can recognize 802.1q
          +		 * tagged frames and treat them correctly */
          +
          +		int max_pkt_size = dev->mtu+14;	/* MTU+Ethernet header */
          +		if (enable)
          +			max_pkt_size += 4;	/* 802.1Q VLAN tag */
          +
          +		EL3WINDOW(3);
          +		outw(max_pkt_size, ioaddr+Wn3_MaxPktSize);
          +
          +		/* set VlanEtherType to let the hardware checksumming
          +		   treat tagged frames correctly */
          +		EL3WINDOW(7);
          +		outw(VLAN_ETHER_TYPE, ioaddr+Wn7_VlanEtherType);
          +	} else {
          +		/* on older cards we have to enable large frames */
          +
          +		vp->large_frames = dev->mtu > 1500 || enable;
          +
          +		EL3WINDOW(3);
          +		mac_ctrl = inw(ioaddr+Wn3_MAC_Ctrl);
          +		if (vp->large_frames)
          +			mac_ctrl |= 0x40;
          +		else
          +			mac_ctrl &= ~0x40;
          +		outw(mac_ctrl, ioaddr+Wn3_MAC_Ctrl);
          +	}
          +
          +	EL3WINDOW(old_window);
          +}
          +#endif
          +
           /* MII transceiver control section.
              Read and write the MII registers using software-generated serial
              MDIO protocol.  See the MII specifications or DP83840A data sheet

   5. My natsemi has MTU problems.

      By Peter Stuge:

          --- natsemi.c.orig	2002-12-30 21:38:04.000000000 +0100
          +++ natsemi.c	2002-12-30 22:25:19.000000000 +0100
          @@ -233,7 +233,7 @@
           #define NATSEMI_REGS_SIZE	(NATSEMI_NREGS * sizeof(u32))
           #define NATSEMI_EEPROM_SIZE	24 /* 12 16-bit values */

          -#define PKT_BUF_SZ		1536 /* Size of each temporary Rx buffer. */
          +#define PKT_BUF_SZ		2064 /* Size of each temporary Rx buffer. */

           /* These identify the driver base version and may not be removed. */
           static char version[] __devinitdata =
          @@ -1290,7 +1290,7 @@
           	/* DRTH 0x10: start copying to memory if 128 bytes are in the fifo
           	 * MXDMA 0: up to 256 byte bursts
           	 */
          -	np->rx_config = RxMxdma_256 | 0x20;
          +	np->rx_config = RxAcceptLong | RxMxdma_256 | 0x20;
           	writel(np->rx_config, ioaddr + RxConfig);

           	/* Disable PME:

   6. My 3C905B has MTU problems.

      As found here at one point in time.
      Furnished by: Luis Miguel Cruz Miranda luismi@b2bi.es
      (I don't know the original author --Ben).

          --- linux.orig/drivers/net/3c59x.c	Sun Sep 30 21:26:06 2001
          +++ linux/drivers/net/3c59x.c	Wed Oct 24 21:52:10 2001
          @@ -308,6 +308,9 @@
              code size of a per-interface flag is not worthwhile. */
           static char mii_preamble_required;

          +/* The Ethernet Type used for 802.1q tagged frames */
          +#define VLAN_ETHER_TYPE 0x8100
          +
           #define PFX DRV_NAME ": "

          @@ -651,7 +654,7 @@
           	Wn2_ResetOptions=12,
           };
           enum Window3 {			/* Window 3: MAC/config bits. */
          -	Wn3_Config=0, Wn3_MAC_Ctrl=6, Wn3_Options=8,
          +	Wn3_Config=0, Wn3_MaxPktSize=4, Wn3_MAC_Ctrl=6, Wn3_Options=8,
           };

           #define BFEXT(value, offset, bitcount)  \
          @@ -679,7 +682,8 @@
           	Media_LnkBeat = 0x0800,
           };
           enum Window7 {					/* Window 7: Bus Master control. */
          -	Wn7_MasterAddr = 0, Wn7_MasterLen = 6, Wn7_MasterStatus = 12,
          +	Wn7_MasterAddr = 0, Wn7_VlanEtherType=4, Wn7_MasterLen = 6,
          +	Wn7_MasterStatus = 12,
           };
           /* Boomerang bus master control registers. */
           enum MasterCtrl {
          @@ -776,7 +780,8 @@
           		pm_state_valid:1,				/* power_state[] has sane contents */
           		open:1,
           		medialock:1,
          -		must_free_region:1;				/* Flag: if zero, Cardbus owns the I/O region */
          +		must_free_region:1,				/* Flag: if zero, Cardbus owns the I/O region */
          +		large_frames:1;			/* accept large frames */
           	int drv_flags;
           	u16 status_enable;
           	u16 intr_enable;
          @@ -844,6 +849,9 @@
           static int vortex_ioctl(struct net_device *dev, struct ifreq *rq, int cmd);
           static void vortex_tx_timeout(struct net_device *dev);
           static void acpi_set_WOL(struct net_device *dev);
          +#if defined(CONFIG_VLAN_8021Q) || defined(CONFIG_VLAN_8021Q_MODULE)
          +static void set_8021q_mode(struct net_device *dev, int enable);
          +#endif

           /* This driver uses 'options' to pass the media type, full-duplex flag, etc. */
           /* Option count limit only -- unlimited interfaces are supported. */
          @@ -1030,6 +1038,7 @@
           	dev->base_addr = ioaddr;
           	dev->irq = irq;
           	dev->mtu = mtu;
          +	vp->large_frames = mtu > 1500;
           	vp->drv_flags = vci->drv_flags;
           	vp->has_nway = (vci->drv_flags & HAS_NWAY) ? 1 : 0;
           	vp->io_size = vci->io_size;
          @@ -1461,7 +1470,7 @@

           	/* Set the full-duplex bit. */
           	outw(	((vp->info1 & 0x8000) || vp->full_duplex ? 0x20 : 0) |
          -		 	(dev->mtu > 1500 ? 0x40 : 0) |
          +		 	(vp->large_frames ? 0x40 : 0) |
           			((vp->full_duplex && vp->flow_ctrl && vp->partner_flow_ctrl) ? 0x100 : 0),
           			ioaddr + Wn3_MAC_Ctrl);

          @@ -1545,6 +1554,10 @@
           	}
           	/* Set receiver mode: presumably accept b-case and phys addr only. */
           	set_rx_mode(dev);
          +#if defined(CONFIG_VLAN_8021Q) || defined(CONFIG_VLAN_8021Q_MODULE)
          +	/* enable 802.1q tagged frames */
          +	set_8021q_mode(dev, 1);
          +#endif
           	outw(StatsEnable, ioaddr + EL3_CMD); /* Turn on statistics. */

           //	issue_and_wait(dev, SetTxStart|0x07ff);
          @@ -1680,7 +1693,7 @@
           						/* Set the full-duplex bit. */
           						EL3WINDOW(3);
           						outw(	(vp->full_duplex ? 0x20 : 0) |
          -								(dev->mtu > 1500 ? 0x40 : 0) |
          +								(vp->large_frames ? 0x40 : 0) |
           								((vp->full_duplex && vp->flow_ctrl && vp->partner_flow_ctrl) ? 0x100 : 0),
           								ioaddr + Wn3_MAC_Ctrl);
           						if (vortex_debug > 1)
          @@ -1900,6 +1913,10 @@
           			issue_and_wait(dev, RxReset|0x07);
           			/* Set the Rx filter to the current state. */
           			set_rx_mode(dev);
          +#if defined(CONFIG_VLAN_8021Q) || defined(CONFIG_VLAN_8021Q_MODULE)
          +			/* enable 802.1q VLAN tagged frames */
          +			set_8021q_mode(dev, 1);
          +#endif
           			outw(RxEnable, ioaddr + EL3_CMD); /* Re-enable the receiver. */
           			outw(AckIntr | HostError, ioaddr + EL3_CMD);
           		}
          @@ -2497,6 +2514,11 @@
           	outw(RxDisable, ioaddr + EL3_CMD);
           	outw(TxDisable, ioaddr + EL3_CMD);

          +#if defined(CONFIG_VLAN_8021Q) || defined(CONFIG_VLAN_8021Q_MODULE)
          +	/* Disable receiving 802.1q tagged frames */
          +	set_8021q_mode(dev, 0);
          +#endif
          +
           	if (dev->if_port == XCVR_10base2)
           		/* Turn off thinnet power.  Green! */
           		outw(StopCoax, ioaddr + EL3_CMD);
          @@ -2760,6 +2782,50 @@

           	outw(new_mode, ioaddr + EL3_CMD);
           }
          +
          +#if defined(CONFIG_VLAN_8021Q) || defined(CONFIG_VLAN_8021Q_MODULE)
          +/* Setup the card so that it can receive frames with an 802.1q VLAN tag.
          +   Note that this must be done after each RxReset due to some backwards
          +   compatibility logic in the Cyclone and Tornado ASICs */
          +static void set_8021q_mode(struct net_device *dev, int enable)
          +{
          +	struct vortex_private *vp = (struct vortex_private *)dev->priv;
          +	long ioaddr = dev->base_addr;
          +	int old_window = inw(ioaddr + EL3_CMD);
          +	int mac_ctrl;
          +
          +	if (vp->drv_flags&IS_CYCLONE || vp->drv_flags&IS_TORNADO) {
          +		/* cyclone and tornado chipsets can recognize 802.1q
          +		 * tagged frames and treat them correctly */
          +
          +		int max_pkt_size = dev->mtu+14;	/* MTU+Ethernet header */
          +		if (enable)
          +			max_pkt_size += 4;	/* 802.1Q VLAN tag */
          +
          +		EL3WINDOW(3);
          +		outw(max_pkt_size, ioaddr+Wn3_MaxPktSize);
          +
          +		/* set VlanEtherType to let the hardware checksumming
          +		   treat tagged frames correctly */
          +		EL3WINDOW(7);
          +		outw(VLAN_ETHER_TYPE, ioaddr+Wn7_VlanEtherType);
          +	} else {
          +		/* on older cards we have to enable large frames */
          +
          +		vp->large_frames = dev->mtu > 1500 || enable;
          +
          +		EL3WINDOW(3);
          +		mac_ctrl = inw(ioaddr+Wn3_MAC_Ctrl);
          +		if (vp->large_frames)
          +			mac_ctrl |= 0x40;
          +		else
          +			mac_ctrl &= ~0x40;
          +		outw(mac_ctrl, ioaddr+Wn3_MAC_Ctrl);
          +	}
          +
          +	EL3WINDOW(old_window);
          +}
          +#endif

           /* MII transceiver control section.
              Read and write the MII registers using software-generated serial

   7. How to make my PCMCIA ethernet card work with VLANs?

      Per Peter Stuge:

      The problem was that the VLAN code in kernel header files weren't included properly when compiling the PCMCIA stuff. Exactly why? I'm not sure, might be because the PCMCIA stuff isn't the actual kernel and that means it's missing defines that trigger the VLAN #ifdefs.

      Commenting the #ifdefs in linux/netdevice.h and adding code to clear out the struct vlan_dev_info* vlan_dev after having created the new network device in the PCMCIA client for the networking card did the trick if I remember correctly. (The reason it doesn't work out-of-the-box is that the kernel VLAN code has garbage data for the VLAN fields in struct device since the device creator (PCMCIA client driver) doesn't know about them.)

      Ben Adds:

      To clear out the garbage, the PCMCIA driver needs to mset the net_device structure to zero (it should do this anyway..) If anyone has a patch, please send it to me and the owners of the PCMCIA code...

4. ### Scripts and Recipes.

   1. Mandrake (RedHat-style) startup script for VLANs.

      Contributed by: "MaxiM Basunov" <maxim@idknet.com>

          #!/bin/sh
          #
          # network       Bring up/down networking
          #
          # chkconfig: 2345 10 90
          # description: Activates/Deactivates all network interfaces configured to \
          #              start at boot time.
          # probe: true

          # Source function library.
          . /etc/init.d/functions

          if [ ! -f /etc/sysconfig/network ]; then
              exit 0
          fi

          . /etc/sysconfig/network

          if [ -f /etc/sysconfig/pcmcia ]; then
           . /etc/sysconfig/pcmcia
          fi

          # Check that networking is up.
          [ ${NETWORKING} = "no" ] && exit 0

          [ -x /sbin/ifconfig ] || exit 0

          # Even if IPX is configured, without the utilities we can't do much
          [ ! -x /sbin/ipx_internal_net -o ! -x /sbin/ipx_configure ] && IPX=

          CWD=`pwd`
          cd /etc/sysconfig/network-scripts

          # find all the interfaces besides loopback.
          # ignore aliases, alternative configurations, and editor backup files
          interfaces=`ls ifcfg* | egrep -v '(ifcfg-lo|:)' | \
                      egrep -v 'ifcfg-ippp[0-9]+$' | \
          >            egrep 'ifcfg-[a-z0-9\.]+$' | \
          <            egrep 'ifcfg-[a-z0-9]+$' | \
                      sed 's/^ifcfg-//g'`

          # See how we were called.
          case "$1" in
            start)

             action "Setting network parameters: " sysctl -p /etc/sysctl.conf

           action "Bringing up interface lo: " ./ifup ifcfg-lo

           case "$IPX" in
             yes|true)
               /sbin/ipx_configure --auto_primary=$IPXAUTOPRIMARY \
                 --auto_interface=$IPXAUTOFRAME
               if [ "$IPXINTERNALNETNUM" != "0" ]; then
                  /sbin/ipx_internal_net add $IPXINTERNALNETNUM $IPXINTERNALNODENUM
               fi
               ;;
           esac
           # depreciated but we still use it.
           if [ -f /proc/sys/net/ipv4/ip_forward ] && [ "$FORWARD_IPV4" = "yes" ] ||
           "$FORWARD_IPV4" = "true" ];
               then
            action "Enabling IPv4 packet forwarding" sysctl -w net.ipv4.ip_forward=1
           fi

          > action "Setting VLAN parameters: " vconfig set_name_type DEV_PLUS_VID

           for i in $interfaces; do
            if egrep -L "^ONBOOT=\"?[Nn][Oo]\"?" ifcfg-$i >/dev/null 2>&1; then
             # Probe module to preserve interface ordering
             /sbin/ifconfig $i >/dev/null 2>&1
            else
          >   vlan=`echo $i | egrep -v '(lo|:)' | \
          >        egrep -v 'ippp[0-9]+$' | \
          >        egrep '[a-z0-9]+\.[0-9][0-9][0-9][0-9]$' | \
          >        sed "s/^[a-z0-9]*\.//g;s/^0*//g"`
          >   ifvlan=`echo $i | egrep -v '(lo|:)' | \
          >        egrep -v 'ippp[0-9]+$' | \
          >           egrep '[a-z0-9]+\.[0-9][0-9][0-9][0-9]$' | \
          >        sed "s/\.[a-z0-9]*$//g"`

          >   if [ -n "${vlan}" ]; then
          >    action "Enable ${vlan} on {$ifvlan}: " vconfig add ${ifvlan} ${vlan}
          >   fi
             action "Bringing up interface $i: " ./ifup $i boot
            fi
           done

           # Add non interface-specific static-routes.
           if [ -f /etc/sysconfig/static-routes ]; then
              grep "^any" /etc/sysconfig/static-routes | while read ignore type dest
          netmask mask bogus args; do
                 if [ "${bogus}" = "gw" ]; then
                  /sbin/route add -$type $dest $netmask $mask $args
                 else
                  /sbin/route add -$type $dest $netmask $mask $bogus $args
                 fi
              done
           fi

                  touch /var/lock/subsys/network
                  ;;
            stop)
             # If this is a final shutdown/halt, check for network FS,
           # and unmount them even if the user didn't turn on netfs

           if [ "$RUNLEVEL" = "6" -o "$RUNLEVEL" = "0" -o "$RUNLEVEL" = "1" ]; then
            NFSMTAB=`grep -v '^#' /proc/mounts | awk '{ if ($3 ~ /^nfs$/ ) print $2}'`
            SMBMTAB=`grep -v '^#' /proc/mounts | awk '{ if ($3 ~ /^smbfs$/ ) print
          $2}'`
            NCPMTAB=`grep -v '^#' /proc/mounts | awk '{ if ($3 ~ /^ncpfs$/ ) print
          $2}'`
            if [ -n "$NFSMTAB" -o -n "$SMBMTAB" -o -n "$NCPMTAB" ] ; then
             /etc/init.d/netfs stop
            fi
           fi

           for i in $interfaces ; do
                   if ifconfig $i 2>/dev/null | grep -q "UP" >/dev/null 2>&1 ; then
               action "Shutting down interface $i: " ./ifdown $i boot
            fi
           done
           case "$IPX" in
             yes|true)
               if [ "$IPXINTERNALNETNUM" != "0" ]; then
                  /sbin/ipx_internal_net del
               fi
               ;;
           esac
           ./ifdown ifcfg-lo
           if [ -d /proc/sys/net/ipv4 ]; then
             if [ -f /proc/sys/net/ipv4/ip_forward ]; then
            if [ `cat /proc/sys/net/ipv4/ip_forward` != 0 ]; then
             action "Disabling IPv4 packet forwarding: " sysctl -w
          net.ipv4.ip_forward=0
            fi
             fi
             if [ -f /proc/sys/net/ipv4/ip_always_defrag ]; then
                   if [ `cat /proc/sys/net/ipv4/ip_always_defrag` != 0 ]; then
                    action "Disabling IPv4 automatic defragmentation: " sysctl -w
          net.ipv4.ip_always_defrag=0
            fi
             fi
           fi
           if [ -f /proc/sys/net/ipv4/tcp_syncookies ];then
                   if [ `cat /proc/sys/net/ipv4/tcp_syncookies` != 0 ]; then
                sysctl -w net.ipv4.tcp_syncookies=0
            fi
           fi

                  rm -f /var/lock/subsys/network
                  ;;
            status)
           echo "Configured devices:"
           echo lo $interfaces

           if [ -x /bin/linuxconf ] ; then
            eval `/bin/linuxconf --hint netdev`
            echo "Devices that are down:"
            echo $DEV_UP
            echo "Devices with modified configuration:"
            echo $DEV_RECONF
           else
            echo "Currently active devices:"
            echo `/sbin/ifconfig | grep ^[a-z] | awk '{print $1}'`
           fi
           ;;
            restart)
                  cd $CWD
           $0 stop
           $0 start
           ;;
            reload)
           if [ -x /bin/linuxconf ] ; then
            eval `/bin/linuxconf --hint netdev`
            for device in $DEV_UP ; do
             action "Bringing up device $device: " ./ifup $device
            done
            for device in $DEV_DOWN ; do
             action "Shutting down device $device: " ./ifdown $device
            done
            for device in $DEV_RECONF ; do
             action "Shutting down device $device: " ./ifdown $device
             action "Bringing up device $device: " ./ifup $device
            done
            for device in $DEV_RECONF_ALIASES ; do
             action "Briging up alias $device: "
          /etc/sysconfig/network-scripts/ifup-aliases $device
            done
            for device in $DEV_RECONF_ROUTES ; do
             action "Bringing up route $device: "
          /etc/sysconfig/network-scripts/ifup-routes $device
            done
            case $IPX in yes|true)
              case $IPXINTERNALNET in
                reconf)
             action "Deleting internal IPX network: " /sbin/ipx_internal_net del
             action "Adding internal IPX network $IPXINTERNALNETNUM
          $IPXINTERNALNODENUM: " /sbin/ipx_internal_net add $IPXINTERNALNETNUM \
                      $IPXINTERNALNODENUM
             ;;
                add)
             action "Adding internal IPX network $IPXINTERNALNETNUM
          $IPXINTERNALNODENUM: "/sbin/ipx_internal_net add $IPXINTERNALNETNUM \
                      $IPXINTERNALNODENUM
             ;;
                del)
             action "Deleting internal IPX network: " /sbin/ipx_internal_net del
             ;;
              esac
              ;;
            esac
           else
                   cd $CWD
            $0 restart
           fi
           ;;
            probe)
           if [ -x /bin/linuxconf ] ; then
            eval `/bin/linuxconf --hint netdev`
            [ -n "$DEV_UP$DEV_DOWN$DEV_RECONF$DEV_RECONF_ALIASES" -o \
              -n "$DEV_RECONF_ROUTES$IPXINTERNALNET" ] && \
             echo reload
            exit 0
           else
            # if linuxconf isn't around to figure stuff out for us,
            # we punt.  Probably better than completely reloading
            # networking if user isn't sure which to do.  If user
            # is sure, they would run restart or reload, not probe.
            exit 0
           fi
           ;;
            *)
                  echo "Usage: network {start|stop|restart|reload|status|probe}"
                  exit 1
          esac

          exit 0

       Terv,

       -----------------------------
       Kristjan Kotkas
       KPNQwest Estonia
       kristjan.kotkas@kpnqwest.ee
       t + 372 62 66299 m + 372 51 60697 f + 372 62 66292

   Last modified: Fri Jul 4 09:53:40 PDT 2003