*****************************************************************************

*                                                                           *

*                    VIA PCI Fast Ethernet Adapter                          *

*                                                                           *

*                      Ethernet Driver for Linux                            *

*                                                                           *

*                           v3.19   Jan. 2001                               *

*                                                                           *

*                                                                           *

*****************************************************************************

                 

         

Introduction:

=============



  Below are instructions for install linux driver. You must compile the source

  code to generate driver.o and use insmod command to insert driver.o as module .

  You can use "netconfig" utilities to setup network parameters for the driver.





Contents of the Subdirectory:

=============================



    linux.txt               This file.

    vialinux.tar            Tar file include following file list    

    Makefile                Makefile for generating driver object file

    pci-scan.c              The linux scan pci device source code

    pci-scan.h              The linux scan pci device header file

    kern_compat.h           The linux kernel version control header file

    via-rhine.c             The linux driver source code file





Installation:

=============



    

    1) Now enter the following commands at the UNIX prompt.  Remember, UNIX is 

       case sensitive.



        1.mkdir /temp

        2.cd /temp

        3.mcopy a:vialinux.tar .   (copies from DOS disk to current working directory)

                                   (mcopy is mtools if you don't have mtools,you can mount -t /dev/fd0 and use cp command)

        4.tar xvf vialinux.tar    

                         

    2) type

       make clean

       make all 

       to generate via-rhine.o && pci-scan.o       



    3) Run netconfig to set you network parameter(like ip,gateway),This will create

       '/etc/rc.d/inet1' and 'inet2' files.



    4) you must modify /etc/rc.d/rc.inet1 to insmod driver.This file will run at 

       boot time. 



        1:add a line in rc.inet1:

        2:cd /etc/rc.d 

        3:vi rc.inet1  add following

          insmod /your driver'path/via-rhine.o(pci-scan.o must in the same directory)

          ex:insmod /usr/src/linux/modules/via-rhine.o (must before bind protocal)

        4:shutdown -h now    (then your driver will work every time you boot.)

       





    Note.1 : make sure that your kernel is built with network, fast_ethernet and 

             module support. Otherwise, you have to rebuild your kernel.



        1:go to /usr/src/linux directory

        2:run 'make menuconfig' or 'make config'

        3:mark the options list above.

        4:exit and rebuild your kernel.

            make dep;make clean;make zImage

            the file 'zImage' will be at /usr/src/linux/arch/i386/boot/zImage

        5:modify /etc/lilo.conf.(this file specify where kernel image is)

        6:run 'lilo'





    Note.2 : installation in Red Hat Linux



        1:mkdir temp

        2:cd temp                 

        3:mcopy a:vialinux.tar .   (copies from DOS disk to current working directory)

                                  (mcopy is mtools if you don't have mtools,you can mount -t /dev/fd0 and use cp command)

        4.tar xvf vialinux.tar  

        5:type

          make clean

          make all 

          to generate via-rhine.o && pci-scan.o

     

        6:cp via-rhine.o /lib/modules/2.2.XXX/net/via-rhine.o

          cp pci-scan.o /lib/modules/2.2.XXX/net/pci-scan.o

        7:linuxconf                 (run linuxconf)

        8:enter setting in the Config/Networking/Client tasks/Basic host information/

            IP address:    xxx.xxx.xxx.xxx

            Netmask:       255.255.255.xxx

            Net device:    eth0

            Kernel module: via-rhine

            

            

   Note.3 : install in SMP Ret Hat

        1:mkdir temp

        2:cd temp                 

        3:mcopy a:vialinux.tar .     (copies from DOS disk to current working directory)

                                     (mcopy is mtools if you don't have mtools,you can mount -t /dev/fd0 and use cp command)

        4.tar xvf vialinux.tar  

        5:type

          make clean

          make smp 

          to generate via-rhine.o && pci-scan.o

     

        6:cp via-rhine.o /lib/modules/2.2.XXX/net/via-rhine.o

          cp pci-scan.o /lib/modules/2.2.XXX/net/pci-scan.o

        7:linuxconf                 (run linuxconf)

        8:enter setting in the Config/Networking/Client tasks/Basic host information/

            IP address:    xxx.xxx.xxx.xxx

            Netmask:       255.255.255.xxx

            Net device:    eth0

            Kernel module: via-rhine

            

    Note.4 : for Red Hat version less than 6.0:

      

        1:vi /etc/conf.modules add following

          alias eth0 via-rhine

          install via-rhine insmod via-rhine

          

    Note.5 : If you can't install driver at boot time.

             If you can install your driver using insmod command (please install pci-scan.o 

             module before via-rhine.o module), but you can't install it at boot time, please

             check whether the driver is in the correct directory (ex: /lib/modules/2.2.XXX/net/),

             and check the /lib/modules/2.2.XXX/modules.dep file, it must include the following 

             line:

                 /lib/modules/2.2.XXX/net/via-rhine.o:	/lib/modules/2.2.XXX/net/pci-scan.o

             

             You can insert this line using depmod command or insert it manually.



    Note.6 : If you can't compile this driver, and appear parse error messages,

             please make sure your source code text format is right. This problem

             is the MS-DOS text format and UNIX text format transfer problem.

             The following is the solution (When you use these commands , make sure the files

             in floppy disk is not vialinux.tar file, it must be the source code text files (5 files),

             , vialinux.tar is not text file, so it can't be convert.

             Solution1:

                 If you use mcopy command to copy your driver from floppy disk to linux, you can type

                     mcopy -t a:\* .

                 then, it will convert the format for you. 

             Solution2:

                 If you use mount command to mount floppy disk to linux, you can type

                     mount -t vfat -o conv=t /dev/fd0 /mnt/floppy

                 then, when you copy files from /mnt/floppy, these files format will be right.