    ©Copyright 2003-2006 Marvell®.
    All rights reserved.

    dlgebsd60x86-8.14.3.3.htm created 23-Jun-2006

    Readme File for dlgebsd60x86-8.14.3.3.tgz

    DGE-530T/560T/560SX/550SX Gigabit Ethernet Adapter

# This file contains

1 Overview
2 Required Files
3 Installation

3.1 Installation of driver software
3.2 Deinstallation of driver software

4 Parameters

## 1 Overview

    The dlgebsd driver supports the DGE-530T/560T/560SX/550SX Gigabit Ethernet
    Adapter on the FreeBSD 6.0 operating system running on Intel x86 hardware.

## 2 Required Files

    For proper software installation the following package file is required:
    dlgebsd60x86-8.14.3.3.tgz .

## 3 Installation

    This section describes the installation of the driver software on a
    computer running FreeBSD 6.0.

3.1 Installation of driver software

    NOTE: root privileges are necessary to install the driver.
    First of all, the package containing the driver software must be installed.
    This is done by typing:

    pkg_add dlgebsd60x86-8.14.3.3.tgz

    This installs the driver binary into /boot/kernel and the manpage into
    /usr/share/man/man4.
    In order for the system to load the driver automatically on booting, the
    following line must be added to the file /boot/loader.conf:

    if_dlge_load="YES"

    In addition to this, the following line must be added to the /etc/rc.conf
    file to configure the interface when the system is booted:

    ifconfig_dlge0="inet 192.168.100.1"

    This assumes a local IP address of 192.168.100.1. You must replace this
    IP address with your computer's IP address.
    On reboot, the driver will be loaded and the interface configured
    automatically.

    It is also possible to load and unload the kernel module by hand. To load
    the kernel module by hand, type:

    kldload if_dlge.ko

    To unload the kernel module by hand, type:

    kldunload if_dlge.ko

3.2 Deinstallation of driver software

    To deinstall the driver, type:

    pkg_delete dlgebsd60x86-8.14.3.3

    This removes the driver kernel module from the /boot/kernel directory, as
    well as the manpage from the /usr/share/man/man4 directory.
    If you have set up your machine to load the driver automatically, you must
    delete the lines you added in /boot/loader.conf and /etc/rc.conf

## 4 Parameters

    There are a number of driver parameters that can be changed to suit different
    operating conditions. These parameters include:

    o Speed
    o Duplex settings
    o Hardware checksumming
    o Clocking Master
    o Virtual LANs
    o Jumbo frames
    o Interrupt moderation

    All these parameters except DualNet mode and Interrupt moderation are modified
    with the ifconfig utility. For detailed information about the usage of this
    program, please consult the relevant FreeBSD manual pages (ie. man ifconfig).

    Speed
    =====
    The following adapter speed settings are available:

    auto         Auto-negotiated speed setting (default)
    1000baseTX   1000baseTX, no auto-negotiation
    100baseTX    100baseTX, no auto-negotiation
    10baseT/UTP  10baseT/UTP, no auto-negotiation

    To change the adapter speed setting to 100baseTX, type:

    ifconfig dlge0 media 100baseTX

    To switch it back to auto-negotiation, type:

    ifconfig dlge0 media auto

    Duplex
    ======
    Please note that half duplex at 1000baseTX is not supported.

    Duplex settings (full or half duplex) are set with the mediaopt keyword. For
    example, to set 100baseTX, half duplex, type:

    ifconfig dlge0 media 100baseTX mediaopt half-duplex

    To clear half-duplex mode, prefix the mediaopt keyword with a hyphen:

    ifconfig dlge0 media 100baseTX -mediaopt half-duplex

    Note that clearing half-duplex mode implies setting full-duplex.

    Checksumming
    ============
    By default, hardware checksumming is enabled for both receive and transmit.

    To turn this feature off, type:

    ifconfig dlge0 -rxcsum

    or

    ifconfig dlge0 -txcsum

    Note that it is currently not possible to switch hardware checksumming on or
    off independently. It is only possible to switch both transmit and receive
    together.

    To turn hardware checksumming on, type:

    ifconfig dlge0 rxcsum

    or

    ifconfig dlge0 txcsum

    Clocking Master
    ===============
    This parameter only applies to Copper adapters with a fixed speed of
    1000baseTX. In this case, autonegotiation is disabled and each side of the
    link must agree on who is clocking master and who is slave. By default,
    the adapter is clocking slave ie. the other end is the master. If the
    reverse is desired (this adapter should be clocking master), the
    "flag0" media option must be set via ifconfig.

    To set clocking master, type:

    ifconfig dlge0 media 1000baseTX mediaopt flag0

    To reset clocking master to the default of slave, type:

    ifconfig dlge0 media 1000baseTX -mediaopt flag0

    Virtual LANs
    ============
    Virtual LAN (VLAN) functionality is supported by the dlge driver
    in conjunction with FreeBSD's if_vlan driver. This can be verified by
    checking the output of ifconfig, where the line listing the interface
    options should include VLAN_MTU. This means that the driver (and thus
    the hardware) can accept packets that are 4 bytes longer than the norm
    (due to the added vlan tag). For further details, see the section 4
    manpage for vlan.

    To use vlans, one or more vlan interfaces must be created and bound
    to the physical interface. In the example below, we assume a physical
    interface of dlge0 and two vlan interfaces, vlan0 and vlan1,
    with vlan IDs of 2 and 3 respectively.

    Create two vlan interfaces:

    ifconfig vlan0 create
    ifconfig vlan1 create

    Assign a vlan ID to each vlan device and attach a physical interface:

    ifconfig vlan0 vlan 2 vlandev dlge0
    ifconfig vlan1 vlan 3 vlandev dlge0

    Use vlan interface as normal:

    ifconfig vlan0 inet 192.168.100.1
    ifconfig vlan1 inet 192.168.101.1

    To remove the vlans and their interfaces:

    ifconfig vlan0 destroy
    ifconfig vlan1 destroy

    Jumbo frames
    ============
    For some applications throughput can be enhanced by the use of frames
    larger than the default of 1500 bytes. These so-called jumbo frames are
    set by the mtu (maximum transfer unit) switch of ifconfig.
    To set the frame size to the maximum of 9000 bytes, type:

    ifconfig dlge0 mtu 9000

    To reset the adapter to use normal (1500 byte) frames, type:

    ifconfig dlge0 mtu 1500

    Note that any frame size between 1500 and 9000 is valid. Note also that
    your switch must be capable of processing large frames and must be
    appropriately configured to do so.
    If you are using jumbo frames, do not forget to configure other hosts
    on the same switch and network to use the same frame size. Failure to
    do this will result in faulty network operation with large numbers of
    frame errors.

    Interrupt moderation
    ====================
    In certain circumstances, it may be desirable to limit the number of
    interrupts the card generates per second in order to reduce the
    interrupt processing overhead.
    This is done with the sysctl command, which allows the user to examine
    and set the value of the driver's interrupt moderation variable.
    This value can be displayed by typing:

    sysctl hw.dlgec0

    It can be modified by typing:

    sysctl -w hw.dlgec0.max_ints_per_sec=4000

    In order for the setting to take effect automatically on system
    boot, the above line may be added to the file /etc/sysctl.conf

    A value of 0 stops interrupt moderation. The value to set depends on
    the speed of the computer (higher for faster machines) and your
    requirements for throughput versus response time. Note that high
    throughput is achieved at the expense of response time. A value
    between 1000 and 20000 is reasonable, although the exact setting for
    optimum performance has to be determined for each system via
    benchmark tests.

    			***End of Readme File***