MAC Driver Interface (MDI) Network Driver Code Samples
The ndsample package includes
the following sample MDI network drivers for 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 (DDI version 8 for PCI Ethernet adapters)
A sample multithreaded DDI version 8 MDI driver (shrk) was added to the
Sample MDI Network Drivers package in version 7.0.0a. There have been
some improvements and bug fixes made to the shrk driver in this release.
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 either UnixWare 7 or OpenServer 5.0.5
although they can only be built and installed on UnixWare 7 systems.
The O5ndsampl package contains sample MDI network drivers
for OpenServer systems.
The following UnixWare 7 packages must 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)
The UnixWare/OpenServer Development Kit (UDK), with the uccs
and usoftint packages selected, must be installed on your
system before you can create installable packages.
See the UDK documentation for more information.
Installation
To install the package from:
downloaded files
- Log in as root.
- Download the package to an installation directory; for
example, /tmp.
- Use the
pkgadd(1M)
command to install it by entering:
- pkgadd -d /tmp/ndsample
media distribution
- Log in as root.
- Insert the CD-ROM in the drive
- 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 may be included with the sample drivers in
/usr/src/hdk/net/README to provide more information:
This README file contains some of the information
about the ndsample package.
It is loosly organized as follows:
- Building the sample MDI drivers
- Packaging your drivers
This file is not intended to replace the online documentation or online
examples.
Building the sample MDI drivers:
--------------------------------
To build the sample MDI drivers that are found under /usr/src/hdk/net/mdi,
you must add "UTSRULES=/usr/src/hdk/net/mdi/uts.rulefile" to your
environment, or run something like the following:
make -f e3D.mk UTSRULES=/usr/src/hdk/net/mdi/uts.rulefile
Packaging your drivers:
-----------------------
We have provided a simple framework to assist with packaging your
drivers. To make use of this, you may place your driver source
under a directory called "/usr/src/hdk/net/mdi/driver_prefix",
where driver_prefix is replaced with your driver prefix. Your makefile
must be called "/usr/src/hdk/net/mdi/driver_prefix/driver_prefix.mk",
and the result of building the all target is a idinstallable DSP under the
"/usr/src/hdk/net/mdi/driver_prefix/driver_prefix.cf" directory.
If you wish to build your driver(s) somewhere besides /usr/src/hdk/net/mdi,
you may use the mdi.mk makefile and change the NETDIR macro.
The mdi.mk file will automatically generate a pkgaddable image for you when the
"pkg" target is built:
# cd /usr/src/hdk/net/mdi
# UTSRULES=`pwd`/uts.rulefile make -f mdi.mk pkg
# pkgtrans -s /usr/src/hdk/net/pkg /tmp/newnics.pkg
