readme.qla2x00

QL2000卡的驱动程序,可以学习驱动的编程. 对于UNIX的I/O操作有帮助!

   ->select Exit (exiting menuconfig)

   Note: Another screen shows: "Do you wish to save your new kernel 
         configuration?"  Select (Yes)
         It saves a new config file called ".config" in the current 
         directory.

7. cd to the directory: /usr/src/linux/ and perform the following:

       # make dep
       # make bzImage

8. Now copy the new kernel image to the boot directory.

       # cd arch/i386/boot
       # cp bzImage  /boot/newsmp

9. Now tell the boot loader to load a new image by modifying 
   /etc/lilo.conf file (use vi editor) with the following lines. 
   This is only an example:

       image=/boot/newsmp
       label=newsmp
       root=/dev/hda5  (this is where your boot partition is)
       read-only

   These lines tell the Linux boot loader to load the new kernel 
   image called "newsmp" in /boot and mount the root partiton using
   device /dev/hda5.

10. Change default=linux or default=linux-up to default=newsmp.
  
11. Now load the new boot configuration by executing the following:

       # /sbin/lilo
          
   The lilo program will echo the names of loadable kernels to the 
   screen:

       newsmp *

12. You are now ready to reboot. At the boot prompt "lilo:" type the 
    new label specified in the lilo.conf file. In the example above 
    that name would be "newsmp".

       lilo: newsmp

13. Type the following command to see if your "custom-kernel" is 
    loaded:

       # cat /proc/version

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

6.1.2 Building a Ramdisk Image to Load the Driver
-------------------------------------------------

Follow the steps below to create the QLogic driver ramdisk image: 

Note:  Before you continue, please complete the procedure described 
       in section 4.3. "Adding the QLogic Controller to the Existing
       OS" first.

1. Add the following line to the file /etc/conf.modules.

       alias scsi_hostadapter qla2x00

2. Perform the the following command to build the ramdisk image that
   contains the qla2x00.o module.

   For Uni-processor system:

       /sbin/mkinitrd /boot/newinitrd-image 2.2.14-5.0 

   For Multi-processors system:

       /sbin/mkinitrd /boot/newinitrd-image 2.2.14-5.0smp 

   Note: "2.2.14-5.0" or "2.2.14-5.0smp" is the subdirectory under 
         /lib/modules/"kernel_release" where the qla2x00.o module 
         resides. The command "uname -r" will display the current
         release.

3. Modify the /etc/lilo.conf to load the ramdisk image. Change the 
   line:
       initrd=/boot/initrd-2.2.14-5.0.img
   or
       initrd=/boot/initrd-2.2.14-5.0smp.img

   to  initrd=/boot/newinitrd-image

4. Load a new lilo file by executing this command:

       #/sbin/lilo

5. Done. The driver will be loaded as a ramdisk image every time the
   system is rebooted.

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

6.2. Loading the Driver Manually
--------------------------------

To load the QLogic driver for QLA2x00 controller type the following
command:

    # modprobe qla2x00

or under directory that contains qla2x00.o file, type:

    # insmod qla2x00.o

Note: After modprobe (or insmod) you can now access the devices 
      without rebooting the system. The driver will be unloaded every
      time the system is rebooted.

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

7. Removing the Driver 
----------------------

Perform the following steps to uninstall the QLogic QLA2x00 driver 
from RedHat 6.2 system: 

If the module is loaded then remove it from the Linux kernel using 
the remove module utility.

    # modprobe -r qla2x00
Or
    # rmmod qla2x00

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

8. Driver Parameters
--------------------

The driver parameters are divided into System Parameters and NVRAM 
Parameters sections.


8.1  System parameters
----------------------

max_scsi_luns - To support more than 1 LUN you must change this 
                kernel parameter. 

For example, type in the following at the boot prompt to support
128 LUNs:

      boot: linux max_scsi_luns=128

The /etc/lilo.conf file can be changed to automatically make the 
kernel to enable more than 1 LUN. If you have multiple kernel images,
the "apend=" line must be added to each kernel image listed in the 
lilo configuration file.

For example, add the following line to support 128 LUNs:

    append="max_scsi_luns=128"

Note: If you have multiple adapters, set max_scsi_luns to maximum
      LUN supported between adapters.

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

8.2. NVRAM Parameters
---------------------

The NVRAM features described below are hard-coded in the driver. The 
changes made for the particular NVRAM feature in the Fast!Util do not
take effect unless otherwise noted.

None.

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

8.3. Driver Command Line Parameters
-----------------------------------

Verbose is the only command line option available.

Verbose - Verbose detail debug information

    #insmod qla2x00 options = verbose

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

9. Limitations
--------------

* The current release of the kernel 2.2.14-5.0 does not support more 
  than 128 SCSI device nodes (i.e., /dev/sdXY). 

* The current release of the kernel 2.2.14-5.0 only sees one LUN 
  during installation and installs only to LUN zero. This is a Red 
  Hat Linux limitation.

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

10. Additional Notes
---------------------

10.1. Proc Filesystem Support
-----------------------------

The /proc filesystem for the QLA2x00 driver can be found in the
/proc/scsi/qla2x00/ directory. This directory contains a file for
each QLogic Fibre Channel adapter in the system. Each file will 
present information about the adapter and transfer statistics for 
each discovered LUN.

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

10.2. Adding QLogic Driver to the Kernel
----------------------------------------

See AddKernel.txt for details.
Addkernel.txt can be obtained from the source:

    # tar -xvzf qla2x00src-v2.23.tgz

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

10.3. Building a Driver from the Sources
----------------------------------------

10.3.1 Building a Uni-Processor (UP) Version of the Driver
----------------------------------------------------------

1. Extract the kernel-headers and kernel-sources RPM files from the 
   first RedHat CD:

       # cd /mnt/cdrom/RedHat/RPMS
       # rpm -iv kernel-headers*.rpm
       # rpm -iv kernel-source*.rpm   

2. Using the diskette you created in Section 4.3, copy the
   qla2x00src-v2.23.tgz file to /home/qla2x00. Follow these steps:

       # cd /home
       # mkdir qla2x00
       # cd /home/qla2x00
       # mcopy a:*.tgz .
       # tar -xvzf qla*.tgz

3. Build the driver from the sources

       # make 

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

10.3.2 Building Symmetric Multi-Processor (SMP) Version of the Driver
---------------------------------------------------------------------

1. If the QLogic SMP module is required to load with RedHat's SMP 
   kernel, it must be compiled with the same version number that was
   assigned to the original SMP kernel built by RedHat. Change the 
   file - /usr/src/linux/include/linux/version.h to the following:

       was:        #define UTS_RELEASE "2.2.14-5.0" 
       should be:  #define UTS_RELEASE "2.2.14-5.0smp"

2. Extract the kernel-headers and kernel-source RPM files from the 
   first RedHat CD:

       # cd /mnt/cdrom/RedHat/RPMS
       # rpm -iv kernel-headers*.rpm
       # rpm -iv kernel-source*.rpm

3. Prepare source headers for a SMP module build by first changing 
   to the source directory

       # cd /usr/src/linux

4. # make menuconfig 

       ->select "Processor type and features" and hit <space bar>
       ->select "Symmetric multiproccessor" and hit <space bar>

   ->select Exit (exiting menuconfig)

   Note: Another screen shows: "Do you wish to save your new kernel 
         configuration?"  Select (Yes)
         It saves a new config file called ".config" in the current 
         directory.

5. Change directory to /usr/src/linux/ and perform the following:

       # make dep

6. Using the diskette you created in Section 4.3, copy the
   qla2x00src-v2.23.tgz file to /home/qla2x00. Follow these steps:

       # cd /home
       # mkdir qla2x00
       # cd /home/qla2x00
       # mcopy a:*.tgz .
       # tar -xvzf qla*.tgz

7. Build the driver from the sources

       # make SMP=1 

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

11. Diskette Content 
--------------------

The following files on this diskette support RedHat Linux 6.2:

1) 2x00_boot2.23.zip (self-extracting zip file)
       rhdd-6.1  
       pcitable 
       modinfo
       modules.cgz (compressed module)
           2.2.14-5.0
               qla2x00.o
           2.2.14-5.0BOOT:
               qla2x00.o
           2.2.14-5.0smp:
               qla2x00.o
           2.2.14-6.1:
               qla2x00.o
           2.2.14-6.1BOOT:
               qla2x00.o
           2.2.14-6.1smp:
               qla2x00.o
        
2) qla2x00src-v2.23.tgz (compressed tar file of the source code)
       Addkernel.txt
       Makefile
       README.qla2x00
       ql2100_fw.h
       ql2200_fw.h
       qla2x00.c
       qla2x00.h
       release.txt - Release Notes

3) qla2x00-2.23-0.i386.rpm - A RedHat Package Manager used during 
   adding the driver or upgrading driver


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

12. Contacting QLogic 
---------------------

Please visit QLogic's website (www.qlogic.com). On this site you will
find product information, our latest drivers and links for technical
assistance if needed.

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

    Copyright (c) 2000 QLogic Corporation. All rights reserved.