
Release notes for Marvell Linux IAL Layer, Release: 3.4.2-GPL
============================================================================

Table of Contents
-----------------

1.	Contents of Release 3.4.2-GPL
2.	Changes from Previous Releases
3.	File Structures
4.	Known Issues
5.      Notes
6.      Disclaimer
	

1. Contents of Release 3.4.2
==============================

 - Linux IAL


2. Changes from Previous Releases
=================================


Changes from Release 3.4.1
----------------------------
Updated files:
ALL
- use the GPL license instead of Marvell's commercial license.
- changed code to be ready for open source.


3. File Structures
==================

-->LinuxIAL
      |
      +----->Makefile_2_6
      +----->Makefile_2_4
      +----->build.sh
      +----->mvLinuxIalHt.c
      +----->mvLinuxIalHt.h
      +----->mvLinuxIalLib.c
      +----->mvLinuxIalLib.h
      +----->mvLinuxIalOs.c
      +----->mvLinuxIalSmart.c
      +----->mvLinuxIalSmart.h
      +----->mvOsLinux.h
      +----->RedHat
             |
             +---->build.sh
             +---->gen_module.sh
             +---->files
                   |
                   +---->modinfo
                   +---->modules.cgz
                   +---->modules.dep
                   +---->pcitable
                   +---->rhdd-6.1

4. Known Issues
===============
- Kernel 2.6 support defined as Not Qualified as only a minimal validation was done
  prior to the release of this package.


- In Kernel 2.6, a device may be set into offline state due to bus reset. This issue
  will be fixed in a future revision.

- Infinite loop in the SCSI error handler of Kernel 2.4:
  While handling an error, (e.g. a timeout error), the scsi_send_eh_cmnd() function
  issues a timed out queued command. When this command hits a repeatable failure
  (e.g. MEDIUM ERROR), the SCSI error handler keep issuing that command on the
  same (broken) block infinitely. This bug is fixed in linux kernel 2.4.28.

- For Kernel 2.4 the channel's maximum queue depth is two commands for a none-queued
  mode. This may cause a startvation if multiple drives are connected to the same
  SATA channel through a Port Multiplier (PM). The channel queue (of only two commands)
  is a shared resource between all the drives connected to that channel. The scsi-mid
  layer is not aware of that shared resource, so it may fill the queue with commands
  of the same drive, and when trying to serivce IO's for the other drives it
  will find that this queue is full.
  This issue will be handled in future revisions.

- In Kernel 2.4 a device may be set into offline state under heavy load of bus resets
  issued by sg_reset utility.
  This issue will be fixed in future revisions.

- The Folling message may be falsely printed when reseting the SATA channel:
  "Core Driver (FATAL_ERROR) <$adapter> <$channel>: Error in handling EDMA error"
  This massage should be ignored in such case.
  This issue will be fixed in future revisions.

- In Kernel 2.6, a command may be issued to a released channel. In this case, the
  following message will be printed:
  "Linux IAL (FATAL_ERROR): in queuecommand, command queued for released host!!"
  this is a Linux issue, and seems to be fixed in the linux version 2.6.8.

- In heavy load under Kernel 2.6 - unplugging a hard drive may not be noticed
  by the OS.
  This issue will be resolved in future revisions.

- RedHat/gen_module.sh doesn't support Kernel 2.6.
  This issue will be fixed in future revisions.

- Binary drivers for RHEL installation may not work in SMP installations.
  This issue will be fixed in future revisions.

5. Notes
========
Tested on the following platforms:

 - RedHat AS v3 (Kernel version 2.4.21-9.EL)
 - Fedora Core2 (Kernel version 2.6.5-1.327)
 - Suse Linux 9.1 (Kernel version 2.6.4-52)


6. Disclaimer
=============
  Marvell Serial ATA Linux Driver
   Copyright 2004 
   Marvell International Ltd.

 This software program (the "Program") is distributed by Marvell International
 ltd. under the terms of the GNU General Public License Version 2, June 1991 
 (the "License").  You may use, redistribute and/or modify this Program in 
 accordance with the terms and conditions of the License, a copy of which is
 available along with the Program in the license.txt file or by writing to the 
 Free Software Foundation, Inc., 59 Temple Place, Suite 330, Boston, 
 MA 02111-1307 or on the worldwide web at http://www.gnu.org/licenses/gpl.txt.

 THE PROGRAM IS DISTRIBUTED AS-IS, WITHOUT WARRANTY OF ANY KIND, AND THE 
 IMPLIED WARRANTIES OF MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE ARE
 EXPRESSLY DISCLAIMED.  The License provides additional details about this 
 warranty disclaimer.

 For more information about the Program or the License as it applies to the
 Program, please contact Marvell International Ltd. via its affiliate, Marvell
 Semiconductor, Inc., 700 First Avenue, Sunnyvale, CA 94010.
