AIX 5L for Itanium-based Systems Operating System

Device Driver Kit Release Notes
June 25, 2001- PRPQ - a

When downloading files using the Netscape browser, hold down the shift key prior to using the left mouse-button (or use the right mouse-button and choose, "Save Link As...").

A. Introduction

• Welcome to AIX 5L for Itanium-based Systems Device Driver Kit (DDK). This package contains documentation and sample code to assist in the development of AIX 5L for Itanium-based Systems device drivers. AIX 5L supports two driver models: the UDI driver interface, and the native AIX 5L driver interface. This version of the DDK supports both driver models. There are certain limitations on the UDI model which are noted below.
• The AIX 5L native driver interface is based on IBM's AIX operating system device driver interface, complemented with technology from SCO's UnixWare operating system. This DDK is the build level of code that contains core level of function and stability such that device driver developers can reasonably undertake development using this level of documentation and sample code. This does not imply that the DDK is complete and fully functional, nor that the components in this version will be present in a subsequent product.
• The Device Driver Kit is installed and executes on an AIX 5L for Itanium-based Systems Operating System, providing a native development environment. When used with the AIX 5L Software Development Environment (SDE), also installed and running on AIX 5L for Itanium-based Systems, the DDK allows developers to install and test device support on AIX 5L for Itanium-based systems.
• Enhancements and changes will occur in various areas and at various stages of product development. Please note that although there is no defect** or update support available for AIX 5L for Itanium-based Systems in this time frame, we welcome your feedback and suggestions. The DDK will be refreshed periodically.

B. Purpose of this release

• This DDK release is intended specifically for developers creating device drivers for the AIX 5L for Itanium-based Systems Operating · System PRPQ.

C. Supported Platforms and Adapters

• The DDK installs on AIX 5L for Itanium-based Systems to provide a native development environment. The DDK can be installed stand-alone on a AIX 5L for Itanium-based Systems system. However, in order to utilize the DDK to build AIX 5L for Itanium-based Systems device drivers, the companion Software Development Environment (SDE) is required.
• The separate SDE package provides the headers, tools and documentation in order to compile and link native AIX 5L for Itanium-based Systems device drivers.
• The supported platforms for device drivers built with this DDK include the Intel SDV workstation and the Intel SDV servers, and certain unique OEM Itanium-based hardware platforms.

D. Installation Instructions

• The target DDK installation is a AIX 5L for Itanium-based Systems
• You need to download the AIX 5L for Itanium-based Systems Device Driver Kit, and complete the steps listed below. This installation or reinstallation of the DDK will overlay a prior installation. Any user created files are not affected by this installation. However, if you have modified existing DDK files, you must backup your changes prior to installing this version.
• It is suggested that you first install the SDE, although it is not mandatory if your reason for installing the DDK is for educational purposes, and not to develop device drivers.
• DDK documentation is included in a package. Certain programming information, API's and other relevant material is provided through links to other online documentation. Thus, it is strongly suggested that you have internet access to the online documentation. A web browser is required, and is included with the Operating System.
• The documentation and references by the DDK are in HTML format. The documentation is also available in PDF format.
• Please follow the following steps to install the DDK on AIX 5L for Itanium-based Systems:
  1. Verify that enough space is available to install the DDK. (a minimum of 20MB of free space is required if you install all the components)
  2. Read and accept the license agreement prior to download of any packages. Your acceptance of the license agreement is required to download and install the DDK
  3. Once you accept the license agreement, you may download any of the installation files for the sample device drivers, documentation, and tools. These packages are in installp format, and contain source code, build instructions, installation scripts, and development tools. You do not need to download all the packages, but only the ones you are interested in:
     • The pseudo device driver
     • The SCSI CD-ROM and adpater device driver
     • The Network device driver
     • The Fibre Channel device driver
     • SCSI over Fibre Channel protocol driver
     • The TTY device driver
     • Packaging tools and a sample installp package
     • Device Driver Class educational material
     • The DDK documentation package

In the alternative, you can download a single compressed tar file that contains all the files listed above. After downloading that tar file ddk_prpqa.tar.Z , extract the contents and install each individual package as needed. E. Installing DDK Packages
Use "smitty installp" to install all the packages as follows:

• Create .toc (table of content) file in the directory containing packages by using 'inutoc' command.
• Invoke "smitty installp" and select the menu option to "Install and Update from ALL Available Software
• Enter the directory name where you downloaded or extracted each package,
• Ensure that installation is successful for each package you install

F. Using the DDK

1. Each DDK package contains sample source code, make files to build the driver. In order to compile the sample code, you need to install the AIX 5L for Itanium-based Systems native compiler and related tools. Ensure you set and export the environment variable using "export PATH=/usr/vac/bin:$PATH"
For each driver package, simply run "make" to build the driver.
The documentation package describes the key points of each sample driver source and provides guide material for building device drivers. Once you installed the documentation package, point your web browser to the DDK table of contents at /usr/ddk/docs/native/ddnativetfrm.htm.

G. DDK Contents
The DDK contains the following:

• Documentation for developing device drivers – This documentation is in the form of programming guides, as well as links to programming interfaces and technical references.
• Sample source code – This sample code is provided for illustrative purposes, and is intended to assist you in developing new device drivers. The sample code includes source code, Makefiles, and documentation for the following:
• An elementary pseudo device driver, that illustrates the concepts of developing, configuring and loading native AIX 5L for Itanium-based Systems device drivers.
• A more complex example, illustrating the interface of a SCSI device driver with a SCSI adapter device driver. The sample includes a typical SCSI CDROM device driver and the top half of a SCSI adapter device driver. The sample also includes the source code to load and configure the device driver.
• A comprehensive sample driver that illustrates programming an ethernet network adapter.
• A comprehensive sample driver that illustrates programming a fibre channel adapter and a SCSI protocol driver.
• A comprehensive sample driver that illustrates programming a tty adapter.
• Tools for creating installp images, and a sample installp package that can be used to package device drivers in installp format
• The accompanying documentation describes the key details of each of these samples. Once you have installed the DDK, you can navigate the documentation by starting at the table of contents page, which can be found in /usr/ddk/docs/native/ddnaivetfrm.htm. A web browser is needed to view the documentation.

H. Where to go for Assistance
Please contact your AIX 5L for Itanium-based Systems Support Representative for further assistance. Please note that there is no defect support or updates in the Beta time period. We still welcome your feedback by contacting us at aix@us.ibm.com Please include "DDK" in the subject line.

I. Limitations
The DDK sample code is intended to be illustrative in nature, and it is provided "as-is". Please refer to the license agreement for details on your use of the code.
Some of the online documentation refers to IBM's AIX Operating System documentation, and not specifically to the AIX 5L for Itanium-based Systems. It is anticipated that during the development phase of the system, AIX 5L for Itanium-based Systems specific documentation will become available. It is suggested that you visit the AIX 5L for Itanium-based Systems home page for updates.

J. This software and documentation is provided on an "AS IS" basis. It is subject to change without notice. Your reliance upon its content is at your own risk. IBM DISCLAIMS ALL WARRANTIES, WHETHER EXPRESSED OR IMPLIED, INCLUDING WITHOUT LIMITATION, WARRANTIES OF FITNESS AND MERCHANTABILITY WITH RESPECT TO THE INFORMATION IN THIS DOCUMENT. BY FURNISHING THIS DOCUMENT, IBM GRANTS NO LICENSES TO ANY RELATED PATENTS OR COPYRIGHTS. (c) Copyright IBM Corporation, 2000. All rights reserved. U.S. Government Users Restricted Rights - Use, duplication, or disclosure restricted by GSA ADP Schedule Contract with IBM Corp.

(c) Copyright The Santa Cruz Operation Inc., 2001. All rights reserved. Intel is a trademark of Intel Corporation. All other trademarks and registered trademarks are the property of their respective holders