Realmode DDK Source Installation Instructions

Print-friendly Version

This document assumes that you are familiar with the Realmode Drivers white paper and the External BEF Interface Specification for x86 Realmode DDI. Both documents are available on the Solaris Developer Connection at http://soldc.sun.com/developer/support/driver.

The file SOURCE.ZIP contains sources of the files distributed as object files and libraries in the basic development kit (BASIC.ZIP). None of the files are necessary for building realmode drivers, but they are provided as a reference for debugging. You should have already installed the basic development files.

Download this file (README.SRC) and SOURCE.ZIP, and copy them into the root of your realmode development tree (assumed here to be C:\BOOT). Extract the files from SOURCE.ZIP such that the directory hierarchy is preserved. Some extraction tools require an argument to prevent all the files from being placed in the local directory. You should have the following directory hierarchy after extraction:

C:\BOOT
    +-- INC
    |
    +-- DRIVERS
         +----- HALFBEFS
         |
         +----- INCLUDE
         |
         +----- LIB
         |       +----- SRC
         |
         +----- NETWORK
         |       +----- PCN
         |
         +----- PROTO
         |
         +----- SCSI
                 +----- AHA1540

The source files include MAIN.C, NETWORK.C, SCSI.C, and all the C and assembler source files for the subroutine library.

Sun's intent in providing these source files is to allow you to refer to the sources for documentation or debugging purposes and to allow you to build debugging versions of the object files. Sun strongly discourages you from altering these files except for these purposes. If you need to add other routines, you should do so within your driver directory. If you find errors or omissions in these sources, notify Sun so that they can be fixed in future releases.

If you are having difficulty getting your driver to work, read README.DBG and then download and extract DEBUG.ZIP. This archive contains debug versions of framework object files and a debug utility to assist with debugging realmode drivers using MS-DOS debuggers.

Files in the SOURCE.ZIP file are provided as reference only. None of the files included in the SOURCE.ZIP file is Modifiable but are Redistributable in a binary form according to terms of the Binary Code License Agreement and Supplemental License Terms listed in the download agreement:

drivers/lib/makefile
drivers/lib/src/makefile
drivers/lib/src/crt0.s
drivers/lib/src/delay.c
drivers/lib/src/ll_shift.s
drivers/lib/src/ul_mul.s
drivers/lib/src/us_div.s
drivers/lib/src/us_mod.s
drivers/lib/src/low.s
drivers/lib/src/intsubs.s
drivers/lib/src/util.s
drivers/lib/src/pciconf.s
drivers/lib/src/__ntohs.s
drivers/lib/src/netsubs.s
drivers/lib/src/rl_shift.s
drivers/lib/src/get_conf.s
drivers/lib/src/ra_shift.s
drivers/lib/src/dbgcrt0.s
drivers/lib/src/scsisubs.s
drivers/lib/src/callback.c
drivers/lib/src/fsprintf.c
drivers/lib/src/ldiv.c
drivers/lib/src/memcmp.c
drivers/lib/src/memcpy.c
drivers/lib/src/memset.c
drivers/lib/src/printf.c
drivers/lib/src/putc.c
drivers/lib/src/strchr.c
drivers/lib/src/strcmp.c
drivers/lib/src/strcpy.c
drivers/lib/src/strlen.c
drivers/lib/src/strncpy.c
drivers/lib/src/vfprintf.c
drivers/lib/src/irq_mask.c
drivers/lib/src/is_eisa.c
drivers/lib/src/repio.s
drivers/main.c
drivers/makefile
drivers/network/makefile
drivers/network/network.c
drivers/scsi/makefile
drivers/scsi/scsi.c