Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
VGE(4)			 BSD Kernel Interfaces Manual			VGE(4)

NAME
     vge -- VIA	Networking Technologies	Velocity Gigabit Ethernet adapter
     driver

SYNOPSIS
     To	compile	this driver into the kernel, place the following lines in your
     kernel configuration file:

	   device miibus
	   device vge

     Alternatively, to load the	driver as a module at boot time, place the
     following line in loader.conf(5):

	   if_vge_load="YES"

DESCRIPTION
     The vge driver provides support for various NICs and embedded Ethernet
     interfaces	based on the VIA Technologies VT6120, VT6122, VT6130 and
     VT6132 Velocity Family Gigabit Ethernet controller	chips.

     The VT6120/VT6122 is a 33/66MHz 64-bit PCI	device which combines a	tri-
     speed MAC with an integrated 10/100/1000 copper PHY.  (Some older cards
     use an external PHY.)  The	VT6130/VT6132 is the PCI express version of
     Velocity family.  The MAC supports	TCP/IP hardware	checksums (IPv4	only),
     TCP large send, VLAN tag insertion	and stripping, as well as VLAN filter-
     ing, a 64-entry CAM filter	and a 64-entry VLAN filter, 64-bit multicast
     hash filter, 4 separate transmit DMA queues, flow control and jumbo
     frames up to 16K in size.	The Velocity family controllers	have a 16K re-
     ceive FIFO	and 48K	transmit FIFO.

     The vge driver takes advantage of the controller's	checksum offload and
     VLAN tagging features, as well as the jumbo frame and CAM filter support.
     The CAM filter is used for	multicast address filtering to provide 64 per-
     fect multicast address filter support.  If	it is necessary	for the	inter-
     face to join more than 64 multicast groups, the driver will switch	over
     to	using the hash filter.

     The jumbo frame support can be enabled by setting the interface MTU to
     any value larger than the default of 1500 bytes, up to a maximum of 9000
     bytes.  The receive and transmit checksum offload support can be toggled
     on	and off	using the ifconfig(8) utility.

     The vge driver supports the following media types:

     autoselect	  Enable autoselection of the media type and options.  The
		  user can manually override the autoselected mode by adding
		  media	options	to rc.conf(5).

     10baseT/UTP  Set 10Mbps operation.	 The ifconfig(8) mediaopt option can
		  also be used to select either	full-duplex or half-duplex
		  modes.

     100baseTX	  Set 100Mbps (Fast Ethernet) operation.  The ifconfig(8)
		  mediaopt option can also be used to select either
		  full-duplex or half-duplex modes.

     1000baseTX	  Set 1000baseTX operation over	twisted	pair.  The ifconfig(8)
		  mediaopt option can also be used to select either
		  full-duplex or half-duplex modes.

     The vge driver supports the following media options:

     full-duplex  Force	full duplex operation.

     half-duplex  Force	half duplex operation.

     The vge driver also supports one special link option for 1000baseTX
     cards:

     link0  With 1000baseTX cards, establishing	a link between two ports re-
	    quires that	one port be configured as a master and the other a
	    slave.  With autonegotiation, the master/slave settings will be
	    chosen automatically.  However when	manually selecting the link
	    state, it is necessary to force one	side of	the link to be a mas-
	    ter	and the	other a	slave.	The vge	driver configures the ports as
	    slaves by default.	Setting	the link0 flag with ifconfig(8)	will
	    set	a port as a master instead.

     For more information on configuring this device, see ifconfig(8).

HARDWARE
     The vge driver supports VIA Networking VT6120, VT6122, VT6130 and VT6132
     based Gigabit Ethernet adapters including:

     o	 VIA Networking	LAN-on-motherboard Gigabit Ethernet
     o	 ZyXEL GN650-T 64-bit PCI Gigabit Ethernet NIC (ZX1701)
     o	 ZyXEL GN670-T 32-bit PCI Gigabit Ethernet NIC (ZX1702)

LOADER TUNABLES
     Tunables can be set at the	loader(8) prompt before	booting	the kernel or
     stored in loader.conf(5).

     hw.vge.msi_disable
	     This tunable disables MSI support on the Ethernet hardware.  The
	     default value is 0.

SYSCTL VARIABLES
     The following variables are available as both sysctl(8) variables and
     loader(8) tunables:

     dev.vge.%d.int_holdoff
	     Maximum number of time to delay interrupts.  The valid range is 0
	     to	5100 in	units of 1us, the default is 150 (150us).  The resolu-
	     tion of of	timer is about 20us so finer tuning than 20us wouldn't
	     be	available.  The	interface should be brought down and up	again
	     before a change takes effect.

     dev.vge.%d.rx_coal_pkt
	     Maximum number of packets to fire Rx completion interrupt.	 The
	     valid range is 1 to 255, the default is 64.

     dev.vge.%d.tx_coal_pkt
	     Maximum number of packets to fire Tx completion interrupt.	 The
	     valid range is 1 to 255, the default is 128.

DIAGNOSTICS
     vge%d: couldn't map memory	 A fatal initialization	error has occurred.

     vge%d: couldn't map ports	A fatal	initialization error has occurred.

     vge%d: couldn't map interrupt  A fatal initialization error has occurred.

     vge%d: failed to enable memory mapping!  The driver failed	to initialize
     PCI shared	memory mapping.	 This might happen if the card is not in a
     bus-master	slot.

     vge%d: watchdog timeout  The device has stopped responding	to the net-
     work, or there is a problem with the network connection (cable).

SEE ALSO
     altq(4), arp(4), miibus(4), netintro(4), ng_ether(4), polling(4),
     vlan(4), ifconfig(8)

HISTORY
     The vge device driver first appeared in FreeBSD 5.3.

AUTHORS
     The vge driver was	written	by Bill	Paul <wpaul@windriver.com>.

BSD			       December	18, 2009			   BSD

NAME | SYNOPSIS | DESCRIPTION | HARDWARE | LOADER TUNABLES | SYSCTL VARIABLES | DIAGNOSTICS | SEE ALSO | HISTORY | AUTHORS

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=vge&sektion=4&manpath=FreeBSD+8.1-RELEASE>

home | help