                   ============================
                    R E L E A S E    N O T E S
                   ============================

       Broadcom Management Application Programming Interface
                       for RedHat Linux
                        Version 6.0.2

              Copyright (c) 2002 Broadcom Corporation
                       All rights reserved.
                          October 31, 2003


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

    1.  Overview
    2.  Limitation
    3.  Installation
    4.  Files
    5.  Uninstall - RPM package
    6.  Uninstall - RPM package
    7.  Known Problems
    8.  Logs


1. Overview
-----------

BMAPI is a share library that provides vrious management APIs for
ethernet network controllers. BMAPI also provides many advance
features to manage and configure Broadcom made 570x based gigabit
ethernet controllers.




2. Limitation
-------------

BMAPI supports Red Hat 7.3 for i386 architecture. Application should
define symbol 'LINUX' before include 'bcmtype.h' and 'BMAPI.h'.
Currently, BMAPI for Linux implements only part of BMAPI APIs.



3. Installation
---------------
To install the RPM package, run

    % rpm -i bmapilnx-{version}.{arch}.rpm



4. Files
--------

    libbmapi.so.{version}   BMAPI share library
    bcmtype.h               commonly use type header file for BMAPI
    BMAPI.h                 BMAPI header file
    release.txt             this file



5. Uninstall - RPM package
---------------------------

To uninstall RPM package, 

    % rpm -e bmapilnx



6. Upgrade - RPM package
---------------------------

To upgrade RPM package, 

    % rpm -U bmapilnx-{version}.{arch}.rpm



7. Known Problems
------------------


8. Logs
--------
v6.0.2 (07/28/03)
- Added external loopback capability to BMAPI.

v6.0.1
- Fix CQ7112: BmapiResumeDriverEx() failed to resume driver after
  BmapiSuspendDriverEx() is called.
  Description: If an interface does not have cable connected and
  manually brought up (ifconfig ethX up), the intefrcae will be
  brought down by BMAPI at the end of diagnostics. The cause is that
  BMAPI check both 'UP' and 'RUNNING' flag for the interface.
  Resolution: BMAPI will check status 'UP' only in BmapiInitDiag().
- Starting driver v5.20, driver will deny MII register access and
  cause LED test failed if the interface is a fiber NIC. Bmapi will
  check the media before performing LED test. If the media is fiber,
  BMAPI will not use MII regesters. Note that bmapi can only blink
  LEDs controlled by MAC registers.

v6.0.0
- Bmapilnx will try to bring up the target interface for diagnostics
  in BmapiInitDiag() if the interface is not 'UP'. Bmaplnx will
  restore the interface to its original state in BmapiUnInitDiag().
- Support ASF! table in ACPI 2.0 BIOS.

v3.0.13
- Not to resolve host name when scanning routing table.

v3.0.12
- Handle one interface with multiple IP properly.
- Support rpm upgrade option.

v3.0.11
- Fix man pages installation problem.
- Fix exception when BMAPI is un-initialize and initialize again.
- Support 5700, 5701, 5702, 5703 and 5705 based deviced.

v3.0.10
- Require miniport driver 5.0.12 or later.
- Add following APIs.
  BmapiDoNicIOCTL()
  BmapiSuspendDriverEx()
  BmapiResumeDriverEx()
  BmapiTestControlRegistersEx()
  BmapiTestMIIRegistersEx()
  BmapiTestInternalMemoryEx()
  BmapiTestInterruptEx()
  BmapiTestLoopBackEx()
  BmapiTestCPUEx()
  BmapiTestLEDsEx()
  BmapiTestEEPROMEx()
  BmapiTestASF()
  BmapiRefreshData()

v3.0.9
- Support 'ui_number' field.

v3.0.8
- Support ASF on 5705.

v3.0.7
- Fix ClearQuest:
  5616: BMAPI get system asf table doesnt work.

v3.0.6
- Require driver v4.0.1 or later.
- Support ASF SNMP community name.
ATTENTION: Support 5700, 5701, 5702 and 5703 based adapters ONLY.

v2.2.25
- Require driver v3.0.11 or later.
- Support 'dhcp_enabled' attribute.
- Support 'default_gateway' attribute.
- BmapiSetASFTable() will generate chip reset to make changes take
  effect immediately.

v2.2.24
- Fix ClearQuest:
  5043: ASF status (in BM_ASF_CFG struc) is mismatched when compared
  between DOS diag and bmapilnx.
- Release version for 'man page' remains the same.

v2.2.23
- Add man pages for APIs support on Linux platform.

v2.2.22
- First release for Linux. Support Redhat Linux 7.3 on i386
  architecture.
- Require Broadcom miniport driver for Linux (module name bcm5700)
  version 3.0.6 or later.
