MAC Driver Interface (MDI) Network Driver Code Samples

The ndsample package (version 8.0.2a) includes the following sample MDI network drivers for OpenServer 6 and UnixWare 7:

e3B
3Com 3C503 EtherLink II ISA series (DDI version 7 for Ethernet adapters)

e3D
3Com 3C507 EtherLink 16 ISA series (DDI version 8 for Ethernet adapters)

tok
IBM Token-Ring Network Adapter Series (DDI version 7 for Token Ring adapters)

shrk
Matrox NS100/1 and Osicom 2300 (multithreaded DDI version 8 for PCI Ethernet adapters)

Version 8.0.2a of the ndsample package differs from previous versions in the following ways:

  • Updated mdi.mk to work on OpenServer 6.
  • Fixed a few (but not all) WARNINGS when sample drivers are compiled.
  • Corrected typos in /usr/src/hdk/net/README.

For current information about the entire UnixWare/OpenServer Hardware Developers Kit (HDK) release, see the HDK Release Notes.

Note: Documentation references on this page link to the Product Documentation. They are also available on your local system when the baseMAN, HDKdoc, and HDKman packages are installed.

System requirements

The ndsample package has no installation dependencies. The samples can be installed on OpenServer 6, UnixWare 7 and OpenServer 5.0.5 (and later). However, samples can only be built and installed on OpenServer 6 and UnixWare 7 systems. The O5ndsampl package contains sample MDI network drivers for OpenServer 5 systems.

OpenServer 6 does not require any additional package installations prior to installing ndsample. Unixware 7 requires the following packages be installed on your system before building and packaging the sample drivers:

cmds
Advanced Commands

uccs
UDK Optimizing C Compilation System (included with the UDK)

usoftint
Software Packaging Tools (included with the UDK)

You must install the uccs and usoftint packages (see above) from the UnixWare and OpenServer Development Kit (UDK) CD before you can create installable packages. This CD is included with your UnixWare 7 distribution media. See the UDK documentation for more information.

Installation

To install the ndsample package from:

downloaded files

  1. Log in as root.
  2. Download the package to an installation directory; for example, /tmp.
  3. Use the pkgadd(1M) command to install it by entering:
    pkgadd  -d  /tmp/ndsample

media distribution

  1. Log in as root.
  2. Insert the CD-ROM in the drive
  3. Use the pkgadd(1M) command to install it by entering:
    pkgadd  -d  cdrom1  ndsample

This will place the MDI sample driver files in the /usr/src/hdk/net/mdi directory.

Configuration

No specific configuration is required.

For more information

More information concerning MDI drivers may be found in Developing MDI network adapter drivers.

See also Network Driver Certification Test Suite for information about testing and debugging your driver.

A README file is included with the sample drivers in /usr/src/hdk/net/README to provide additional information.