Throw the switch on the new driver generation/loading mechanism. From

here on in, if_ndis.ko will be pre-built as a module, and can be built
into a static kernel (though it's not part of GENERIC). Drivers are
created using the new ndisgen(8) script, which uses ndiscvt(8) under
the covers, along with a few other tools. The result is a driver module
that can be kldloaded into the kernel.

A driver with foo.inf and foo.sys files will be converted into
foo_sys.ko (and foo_sys.o, for those who want/need to make static
kernels). This module contains all of the necessary info from the
.INF file and the driver binary image, converted into an ELF module.
You can kldload this module (or add it to /boot/loader.conf) to have
it loaded automatically. Any required firmware files can be bundled
into the module as well (or converted/loaded separately).

Also, add a workaround for a problem in NdisMSleep(). During system
bootstrap (cold == 1), msleep() always returns 0 without actually
sleeping. The Intel 2200BG driver uses NdisMSleep() to wait for
the NIC's firmware to come to life, and fails to load if NdisMSleep()
doesn't actually delay. As a workaround, if msleep() (and hence
ndis_thsuspend()) returns 0, use a hard DELAY() to sleep instead).
This is not really the right thing to do, but we can't really do much
else. At the very least, this makes the Intel driver happy.

There are probably other drivers that fail in this way during bootstrap.
Unfortunately, the only workaround for those is to avoid pre-loading
them and kldload them once the system is running instead.

4 files changed, 834 insertions, 0 deletions

diff --git a/usr.sbin/ndiscvt/Makefile b/usr.sbin/ndiscvt/Makefile
index 8004897..90ecebb 100644
--- a/usr.sbin/ndiscvt/Makefile
+++ b/usr.sbin/ndiscvt/Makefile
@@ -8,6 +8,7 @@ SRCS+=	subr_pe.c
 SRCS+=	inf.c inf-token.l inf-parse.y y.tab.h
 
 MAN=	ndiscvt.8
+MAN+=	ndisgen.8
 
 WARNS?=	4
 
@@ -20,4 +21,10 @@ CFLAGS+=-I. -I${.CURDIR} -I${.CURDIR}/../../sys
 
 CLEANFILES= y.output
 
+FILES= windrv_stub.c
+FILESNAME= windrv_stub.c
+FILESDIR= /usr/share/misc
+
+SCRIPTS= ndisgen.sh
+
 .include <bsd.prog.mk>
diff --git a/usr.sbin/ndiscvt/ndisgen.8 b/usr.sbin/ndiscvt/ndisgen.8
new file mode 100644
index 0000000..d16c34d
--- /dev/null
+++ b/usr.sbin/ndiscvt/ndisgen.8
@@ -0,0 +1,82 @@
+.\" Copyright (c) 2005
+.\"	Bill Paul <wpaul@windriver.com> All rights reserved.
+.\"
+.\" Redistribution and use in source and binary forms, with or without
+.\" modification, are permitted provided that the following conditions
+.\" are met:
+.\" 1. Redistributions of source code must retain the above copyright
+.\"    notice, this list of conditions and the following disclaimer.
+.\" 2. Redistributions in binary form must reproduce the above copyright
+.\"    notice, this list of conditions and the following disclaimer in the
+.\"    documentation and/or other materials provided with the distribution.
+.\" 3. All advertising materials mentioning features or use of this software
+.\"    must display the following acknowledgement:
+.\"	This product includes software developed by Bill Paul.
+.\" 4. Neither the name of the author nor the names of any co-contributors
+.\"    may be used to endorse or promote products derived from this software
+.\"   without specific prior written permission.
+.\"
+.\" THIS SOFTWARE IS PROVIDED BY Bill Paul AND CONTRIBUTORS ``AS IS'' AND
+.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
+.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
+.\" ARE DISCLAIMED.  IN NO EVENT SHALL Bill Paul OR THE VOICES IN HIS HEAD
+.\" BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
+.\" CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
+.\" SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
+.\" INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
+.\" CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
+.\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF
+.\" THE POSSIBILITY OF SUCH DAMAGE.
+.\"
+.\" $FreeBSD$
+.\"
+.Dd April 24, 2005
+.Dt NDISGEN 8
+.Os
+.Sh NAME
+.Nm ndisgen
+.Nd generate a FreeBSD driver module from a
+.Tn Windows\[rg]
+NDIS driver distribution
+.Fx
+.Sh SYNOPSIS
+.Nm
+.Sh DESCRIPTION
+The
+.Nm
+script uses the
+.Xr ndiscvt 8
+utility and other tools to generate a FreeBSD loadable driver module
+and a static ELF object module from a
+.Tn Windows\[rg]
+NDIS driver, for use with the
+.Xr ndis 4
+compatibility module.
+.Pp
+The
+.Nm
+script is interactive and contains its own help section. The script
+will prompt the user for the
+.Pa .INF
+and
+.Pa .SYS
+files (and any firmware or other external files) needed to generate
+the FreeBSD driver module.
+.Sh SEE ALSO
+.Xr ld 1 ,
+.Xr objcopy 1 ,
+.Xr ndis 4 ,
+.Xr kldload 8 ,
+.Xr ndiscvt 8 ,
+.Xr ndisapi 9
+.Sh HISTORY
+The
+.Nm
+utility first appeared in
+.Fx 6.0 .
+.Sh AUTHORS
+.An -nosplit
+The
+.Nm
+utility was written by
+.An Bill Paul Aq wpaul@windriver.com .
diff --git a/usr.sbin/ndiscvt/ndisgen.sh b/usr.sbin/ndiscvt/ndisgen.sh
new file mode 100644
index 0000000..3e31e88
--- /dev/null
+++ b/usr.sbin/ndiscvt/ndisgen.sh
@@ -0,0 +1,500 @@
+#!/bin/sh
+#
+# Copyright (c) 2005
+#	Bill Paul <wpaul@windriver.com>.  All rights reserved.
+#
+# Redistribution and use in source and binary forms, with or without
+# modification, are permitted provided that the following conditions
+# are met:
+# 1. Redistributions of source code must retain the above copyright
+#    notice, this list of conditions and the following disclaimer.
+# 2. Redistributions in binary form must reproduce the above copyright
+#    notice, this list of conditions and the following disclaimer in the
+#    documentation and/or other materials provided with the distribution.
+# 3. All advertising materials mentioning features or use of this software
+#    must display the following acknowledgement:
+#	This product includes software developed by Bill Paul.
+# 4. Neither the name of the author nor the names of any co-contributors
+#    may be used to endorse or promote products derived from this software
+#    without specific prior written permission.
+#
+# THIS SOFTWARE IS PROVIDED BY Bill Paul AND CONTRIBUTORS ``AS IS'' AND
+# ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
+# IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
+# ARE DISCLAIMED.  IN NO EVENT SHALL Bill Paul OR THE VOICES IN HIS HEAD
+# BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
+# CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
+# SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
+# INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
+# CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
+# ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF
+# THE POSSIBILITY OF SUCH DAMAGE.
+#
+# $FreeBSD$
+#
+
+header () {
+clear
+echo "	=================================================================="
+echo "	------------------ Windows(r) driver converter -------------------"
+echo "	=================================================================="
+echo ""
+}
+
+mainmenu() {
+header
+echo "	This is script is designed to guide you through the process"
+echo "	of converting a Windows(r) binary driver module and .INF"
+echo "	specification file into a FreeBSD ELF kernel module for use"
+echo "	with the NDIS compatibility system."
+echo ""
+echo "	The following options are available:"
+echo ""
+echo "	1] Learn about the NDIS compatibility system"
+echo "	2] Convert individual firmware files"
+echo "	3] Convert driver"
+echo "	4] Exit"
+echo ""
+echo -n "	Enter your selection here and press return: "
+read KEYPRESS
+}
+
+
+help1 () {
+header
+echo "				General information"
+echo ""
+echo "	The NDIS compatibility system is designed to let you use Windows(r)"
+echo "	binary drivers for networking devices with FreeBSD, in cases where"
+echo "	a native FreeBSD driver is not available due to hardware manufacturer"
+echo "	oversight or stupidity. NDIS stands for Network Driver Interface"
+echo "	Standard, and refers to the programming model used to write Windows(r)"
+echo "	network drivers. (These are often called \"NDIS miniport\" drivers.)"
+echo ""
+echo "	In order to use your network device in NDIS compatibility mode,"
+echo "	you need the Windows(r) driver that goes with it. Also, the driver"
+echo "	must be compiled for the same architecture as the release of FreeBSD"
+echo "	you have installed. At this time, the i386 and amd64 architectures"
+echo "	are both supported. Note that you cannot use a Windows/i386 driver"
+echo "	with FreeBSD/amd64: you must obtain a Windows/amd64 driver."
+echo ""
+echo -n "	Press any key to continue... "
+read KEYPRESS
+}
+
+help2() {
+header
+echo "				Where to get drivers"
+echo ""
+echo "	If you purchased your network card separately from your computer,"
+echo "	there should have been a driver distribution CD included with the"
+echo "	card which contains Windows(r) drivers. The NDIS compatibility"
+echo "	system is designed to emulate the NDIS API of a couple of different"
+echo "	Windows(r) releases, however it works best with drivers designed"
+echo "	for NDIS 5.0 or later. Drivers distributed for Windows 2000 should"
+echo "	work, however for best results you should use a driver designed"
+echo "	for Windows XP or Windows Server 2003."
+echo ""
+echo "	If your card was supplied with your computer, or is a built-in device,"
+echo "	drivers may have been included on a special driver bundle CD shipped"
+echo "	with the computer."
+echo ""
+echo "	If you don't have a driver CD, you should be able to find a driver"
+echo "	kit on the card or computer vendor's web site."
+echo ""
+echo -n "	Press any key to continue... "
+read KEYPRESS
+}
+
+help3 () {
+header
+echo "				What files do I need?"
+echo ""
+echo "	In most cases, you will need only two files: a .INF file and a .SYS"
+echo "	file. The .INF file is a text file used by the Windows(r) installer to"
+echo "	perform the driver installation. It contains information that tells"
+echo "	the intaller what devices the driver supports and what registry keys"
+echo "	should be created to control driver configuration. The .SYS file"
+echo "	is the actual driver executable code in Windows(r) Portable Executable"
+echo "	(PE) format. Note that sometimes the .INF file is supplied in unicode"
+echo "	format. Unicode .INF files must be converted to ASCII form with the"
+echo "	iconv(1) utility before this installer script can use them."
+echo "	Occasionally, a driver may require firmware or register setup"
+echo "	files that are external to the main .SYS file. These are provided"
+echo "	on the same CD with the driver itself, and sometimes have a .BIN"
+echo "	extension, though they can be named almost anything. You will need"
+echo "	these additional files to make your device work with the NDIS"
+echo "	compatibility system as well."
+echo ""
+echo -n "	Press any key to continue... "
+read KEYPRESS
+}
+
+help4 () {
+header
+echo "				How does it all work?"
+echo ""
+echo "	The installer script uses the ndiscvt(1) utility to convert the .INF,"
+echo "	.SYS and optional firmware files into a FreeBSD kernel loadable module"
+echo "	(.ko) file. This module can be loaded via the kldload(8) utility or"
+echo "	loaded automatically via the /boot/loader.conf file. The ndiscvt(1)"
+echo "	utility extracts the device ID information and registry key data"
+echo "	from the .INF file and converts it into a C header file. It also uses"
+echo "	the objcopy(1) utility to convert the .SYS file and optional firmware"
+echo "	files into ELF objects. The header file is compiled into a small C"
+echo "	stub file which contains a small amount of code to interface with"
+echo "	the FreeBSD module system. This stub is linked together with the"
+echo "	converted ELF objects to form a FreeBSD kernel module. A static ELF"
+echo "	object (.o) file is also created. This file can be linked into a"
+echo "	static kernel image for those who want/need a fully linked kernel"
+echo "	image (possibly for embedded bootstrap purposes, or just plain old"
+echo "	experimentation)."
+echo ""
+echo -n "	Press any key to continue... "
+read KEYPRESS
+}
+
+help5 () {
+header
+echo "				Prerequisites"
+echo ""
+echo "	Converting a driver requires the following utilities:"
+echo ""
+echo "	- The FreeBSD C compiler, cc(1) (part of the base install)."
+echo "	- The FreeBSD linker, ld(1) (part of the base install)."
+echo "	- The objcopy(1) utility (part of the base install)."
+echo "	- The ndiscvt(1) utility (part of the base install)."
+echo ""
+echo "	If your happen to end up with a .INF file that's in unicode format,"
+echo "	then you'll also need:"
+echo ""
+echo "	- The iconv(1) utility."
+echo ""
+echo "	If you have installed the X Window system or some sort of desktop"
+echo "	environment, then iconv(1) should already be present. If not, you"
+echo "	will need to install the libiconv package or port."
+echo ""
+echo -n "	Press any key to continue... "
+read KEYPRESS
+}
+
+infconv () {
+header
+echo "			INF file validation"
+echo ""
+echo ""
+echo "	A .INF file is most often provided as an ASCII file, however"
+echo "	files with multilanguage support are provided in Unicode format."
+echo "	Please type in the path to your .INF file now."
+echo ""
+echo -n "	> "
+read INFPATH
+if [ $INFPATH ] && [ -e $INFPATH ]; 
+then 
+	INFTYPE=`${FILE} ${INFPATH}`
+
+	case ${INFTYPE} in
+	*ASCII*)
+		echo ""
+		echo "	This .INF file appears to be ASCII."
+		echo ""
+		echo -n "	Press any key to continue... "
+		read KEYPRESS
+		;;
+	*text*)
+		echo ""
+		echo "	This .INF file appears to be ASCII."
+		echo ""
+		echo -n "	Press any key to continue... "
+		read KEYPRESS
+		;;
+	*nicode*)
+		echo ""
+		echo "	This .INF file appears to be Unicode."
+		if [ -e $ICONVPATH ];
+		then
+			echo "	Trying to convert to ASCII..."
+			${RM} -f /tmp/ascii.inf
+			${ICONVPATH} -f utf-16 -t utf-8 ${INFPATH} > /tmp/ascii.inf
+			INFPATH=/tmp/ascii.inf
+			echo "	Done."
+			echo ""
+			echo -n "	Press any key to continue... "
+			read KEYPRESS
+		else
+			echo "	The iconv(1) utility does not appear to be installed."
+			echo "	Please install this utility or convert the .INF file"
+			echo "	to ASCII and run this utility again."
+			echo ""
+			exit
+		fi
+		;;
+	*)
+		echo ""
+		echo "	I don't recognize this file format. It may not be a valid .INF file."
+		echo ""
+		echo -n "	Press enter to try again, or ^C to quit. "
+		read KEYPRESS
+		INFPATH=""
+		;;
+	esac
+else
+	echo ""
+	echo "	The file '$INFPATH' was not found."
+	echo ""
+	echo -n "	Press enter to try again, or ^C to quit. "
+	read KEYPRESS
+	INFPATH=""
+fi
+}
+
+sysconv() {
+header
+echo "			Driver file validation"
+echo ""
+echo ""
+echo "	Now you need to specify the name of the Windows(r) driver .SYS"
+echo "	file for your device. Note that if you are running FreeBSD/amd64,"
+echo "	then you must provide a driver that has been compiled for the"
+echo "	64-bit Windows(r) platform. If a 64-bit driver is not available"
+echo "	for your device, you must install FreeBSD/ia32 and use the"
+echo "	32-bit driver instead."
+echo ""
+echo "	Please type in the path to the Windows(r) driver .SYS file now."
+echo ""
+echo -n "	> "
+read SYSPATH
+if [ $SYSPATH ] && [ -e $SYSPATH ];
+then
+	SYSTYPE=`${FILE} ${SYSPATH}`
+
+	case ${SYSTYPE} in
+	*Windows*)
+		echo ""
+		echo "	This .SYS file appears to be in Windows(r) PE format."
+		echo ""
+		echo -n "	Press any key to continue... "
+		read KEYPRESS
+		SYSBASE=`basename ${SYSPATH} | ${TR} '.' '_'`
+		;;
+	*)
+		echo ""
+		echo "	I don't recognize this file format. It may not be a valid .SYS file."
+		echo ""
+
+		echo -n "	Press enter to try again, or ^C to quit. "
+		read KEYPRESS
+		SYSPATH=""
+		;;
+	esac
+else
+	echo ""
+	echo "	The file '$SYSPATH' was not found."
+	echo ""
+	echo -n "	Press enter to try again, or ^C to quit. "
+	read KEYPRESS
+	SYSPATH=""
+fi 
+}
+
+ndiscvt() {
+header
+echo "			Driver file conversion"
+echo ""
+echo "	The script will now try to convert the .INF and .SYS files"
+echo "	using the ndiscvt(1) utility. This utility can handle most"
+echo "	.INF files, however occasionally it can fail to parse some files"
+echo "	due to subtle syntax issues: the .INF syntax is very complex,"
+echo "	and the Windows(r) parser will sometimes allow files with small"
+echo "	syntax errors to be processed correctly which ndiscvt(1) will"
+echo "	not. If the conversion fails, you may have to edit the .INF"
+echo "	file by hand to remove the offending lines."
+echo ""
+echo -n "	Press enter to try converting the files now: "
+read KEYPRESS
+if ! ${NDISCVT} -i ${INFPATH} -s ${SYSPATH} -O -o ${DNAME}.h > /dev/null; then
+	echo "CONVERSION FAILED"
+	exit
+else
+	echo ""
+	echo "	Conversion was successful."
+	echo ""
+	echo -n "	Press enter to continue... "
+	read KEYPRESS
+fi
+}
+
+firmcvt() {
+	while : ; do
+header
+echo "			Firmware file conversion"
+echo ""
+echo "	If your driver uses additional firmware files, please list them"
+echo "	below. When you're finished, just press enter to contiue. (If your"
+echo "	driver doesn't need any extra firmware files, just press enter"
+echo "	to move to the next step.)"
+echo ""
+		echo -n "	> "
+		read FIRMPATH
+
+		if [ $FIRMPATH ] && [ $FIRMPATH != "" ]; then
+			if [ ! -e $FIRMPATH ]; then
+				echo ""
+				echo "	The file '$FIRMPATH' was not found"
+				echo ""
+				echo -n "	Press enter to try again, or ^C to quit. "
+				read KEYPRESS
+				continue
+			fi
+			if ! ${NDISCVT} -f ${FIRMPATH} > /dev/null; then
+				echo ""
+				echo "CONVERSION FAILED"
+			else
+				echo ""
+				echo "	Conversion was successful."
+				echo ""
+				FRMBASE=`basename ${FIRMPATH}`
+				FRMBASE="${FRMBASE}.o"
+				FRMLIST="${FRMLIST} ${FRMBASE}"
+			fi
+			echo -n "	Press enter to continue... "
+			read KEYPRESS
+		else
+			break
+		fi
+	done
+
+header
+echo ""
+echo "	List of files converted firmware files:"
+echo ""
+for i in $FRMLIST
+do
+	echo "	"$i
+done
+echo ""
+echo -n "	Press enter to continue... "
+read KEYPRESS
+}
+
+drvgen () {
+header
+echo "			Kernel module generation"
+echo ""
+echo ""
+echo "	The script will now try to generate the kernel driver module."
+echo "	This is the last step. Once this module is generated, you should"
+echo "	be able to load it just like any other FreeBSD driver module."
+echo ""
+echo "	Press enter to compile the stub module and generate the driver"
+echo -n "	module now: "
+read KEYPRESS
+echo ""
+touch bus_if.h
+touch device_if.h
+echo -n "	Compiling stub... "
+if ! ${CC} -D_KERNEL -DDRV_DATA_START=${SYSBASE}_drv_data_start -DDRV_NAME=${SYSBASE} -DDRV_DATA_END=${SYSBASE}_drv_data_end -I. ${STUBFILE} -c -o windrv_stub.o; then
+	echo "compilation failed. Exiting."
+	echo ""
+	exit
+else
+	echo "done."
+fi
+echo -n	"	Linking loadable kernel module... "
+if ! ${LD} -Bshareable  -d -warn-common -o ${SYSBASE}.ko windrv_stub.o ${FRMLIST} ${DNAME}.o; then
+	echo "linking failed. Exiting."
+	echo ""
+	exit
+else
+	echo "done."
+fi
+echo -n	"	Linking static kernel module... "
+if ! ${LD} -r  -d -warn-common -o ${SYSBASE}.o windrv_stub.o ${FRMLIST} ${DNAME}.o; then
+	echo "linking failed. Exiting."
+	echo ""
+	exit
+else
+	echo "done."
+fi
+echo -n "	Cleaning up... "
+${RM} -f bus_if.h device_if.h windrv_stub.o
+${RM} -f ${DNAME}.h ${DNAME}.o
+echo "done."
+echo ""
+echo "	The file $SYSBASE.ko has been successfully generated."
+echo "	You can kldload this module to get started."
+echo ""
+echo -n "	Press any key to exit. "
+read KEYPRESS
+echo ""
+echo ""
+}
+
+convert_driver () {
+	while : ; do
+		infconv
+		if [ $INFPATH ] && [ $INFPATH != "" ]; then
+			break
+		fi
+	done
+
+	while : ; do
+		sysconv
+		if [ $SYSPATH ] && [ $SYSPATH != "" ]; then
+			break
+		fi
+	done
+
+	ndiscvt
+	firmcvt
+	drvgen
+}
+
+ICONVPATH=/usr/local/bin/iconv
+NDISCVT=/usr/sbin/ndiscvt
+STUBFILE=/usr/share/misc/windrv_stub.c
+DNAME=windrv
+OBJCOPY=/usr/bin/objcopy
+CC=/usr/bin/cc
+LD=/usr/bin/ld
+RM=/bin/rm
+TR=/usr/bin/tr
+FILE=/usr/bin/file
+
+INFPATH=""
+FRMLIST=""
+SYSPATH=""
+SYSBASE=""
+FRMBASE=""
+
+while : ; do
+	mainmenu
+	case ${KEYPRESS} in
+	1)
+		help1
+		help2
+		help3
+		help4
+		help5
+		;;
+	2)
+		firmcvt
+		;;
+	3)
+		convert_driver
+		;;
+	4)
+		header
+		echo ""
+		echo "	Be seeing you!"
+		echo ""
+		exit
+		;;
+	*)
+		header
+		echo ""
+		echo -n "	Sorry, I didn't underatand that. Press enter to try again: "
+		read KEYPRESS
+		;;
+	esac
+done
diff --git a/usr.sbin/ndiscvt/windrv_stub.c b/usr.sbin/ndiscvt/windrv_stub.c
new file mode 100644
index 0000000..2097e50
--- /dev/null
+++ b/usr.sbin/ndiscvt/windrv_stub.c
@@ -0,0 +1,245 @@
+/*-
+ * Copyright (c) 2005
+ *      Bill Paul <wpaul@windriver.com>.  All rights reserved.
+ *
+ * Redistribution and use in source and binary forms, with or without
+ * modification, are permitted provided that the following conditions
+ * are met:
+ * 1. Redistributions of source code must retain the above copyright
+ *    notice, this list of conditions and the following disclaimer.
+ * 2. Redistributions in binary form must reproduce the above copyright
+ *    notice, this list of conditions and the following disclaimer in the
+ *    documentation and/or other materials provided with the distribution.
+ * 3. All advertising materials mentioning features or use of this software
+ *    must display the following acknowledgement:
+ *      This product includes software developed by Bill Paul.
+ * 4. Neither the name of the author nor the names of any co-contributors
+ *    may be used to endorse or promote products derived from this software
+ *    without specific prior written permission.
+ *
+ * THIS SOFTWARE IS PROVIDED BY Bill Paul AND CONTRIBUTORS ``AS IS'' AND
+ * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
+ * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
+ * ARE DISCLAIMED.  IN NO EVENT SHALL Bill Paul OR THE VOICES IN HIS HEAD
+ * BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
+ * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
+ * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
+ * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
+ * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
+ * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF
+ * THE POSSIBILITY OF SUCH DAMAGE.
+ */
+
+#include <sys/cdefs.h>
+__FBSDID("$FreeBSD$");
+
+#include <sys/param.h>
+#include <sys/systm.h>
+#include <sys/kernel.h>
+#include <sys/module.h>
+#include <sys/conf.h>
+
+#include <machine/bus.h>
+#include <machine/resource.h>
+#include <sys/bus.h>
+
+#define NDIS_REGVALS
+
+struct ndis_cfg {
+	char			*nc_cfgkey;
+	char			*nc_cfgdesc;
+	char			nc_val[256];
+	int			nc_idx;
+};
+
+typedef struct ndis_cfg ndis_cfg;
+
+#include "windrv.h"
+
+struct ndis_pci_type {
+        uint16_t                ndis_vid;
+        uint16_t                ndis_did;
+        uint32_t                ndis_subsys;
+        char                    *ndis_name;
+};
+
+struct ndis_pccard_type {
+        const char              *ndis_vid;
+        const char              *ndis_did;
+        char                    *ndis_name;
+};
+
+
+#ifdef NDIS_PCI_DEV_TABLE
+static struct ndis_pci_type ndis_devs[] = {
+        NDIS_PCI_DEV_TABLE
+        { 0, 0, 0, NULL }
+};
+#endif
+
+#ifdef NDIS_PCMCIA_DEV_TABLE
+static struct ndis_pccard_type ndis_devs[] = {
+        NDIS_PCMCIA_DEV_TABLE
+        { NULL, NULL, NULL }
+};
+#endif
+
+enum interface_type {
+	InterfaceTypeUndefined = -1,
+	Internal,
+	Isa,
+	Eisa,
+	MicroChannel,
+	TurboChannel,
+	PCIBus,
+	VMEBus,
+	NuBus,
+	PCMCIABus,
+	CBus,
+	MPIBus,
+	MPSABus,
+	ProcessorInternal,
+	InternalPowerBus,
+	PNPISABus,
+	PNPBus,
+	MaximumInterfaceType
+};
+
+typedef enum interface_type interface_type;
+
+/*
+ * XXX
+ * Ordinarily, device_probe_desc is defined in device_if.h, which
+ * is created from device_if.m. The problem is, the latter file
+ * is only available if you have the kernel source code installed,
+ * and not all users choose to install it. I'd like to let people
+ * load Windows driver modules with the minimal amount of hassle
+ * and dependencies. <sys/bus.h> wants both device_if.h and bus_if.h
+ * to be defined, but it turns out the only thing we really need
+ * to get this module compiled is device_probe_desc, so we define
+ * that here, and let the build script create empty copies of
+ * device_if.h and bus_if.h to make the compiler happy.
+ */
+
+extern struct kobjop_desc device_probe_desc;
+typedef int device_probe_t(device_t dev);
+
+extern int windrv_load(module_t, vm_offset_t, size_t,
+	interface_type, void *, void *);
+extern int windrv_unload(module_t, vm_offset_t, size_t);
+
+#ifndef DRV_DATA_START
+#define DRV_DATA_START UNDEF_START
+#endif
+
+#ifndef DRV_DATA_END
+#define DRV_DATA_END UNDEF_END
+#endif
+
+#ifndef DRV_NAME
+#define DRV_NAME UNDEF_NAME
+#endif
+
+extern uint8_t DRV_DATA_START;
+extern uint8_t DRV_DATA_END;
+
+/*
+ * The following is stub code that makes it look as though we want
+ * to be a child device of all the buses that our supported devices
+ * might want to attach to. Our probe routine always fails. The
+ * reason we need this code is so that loading an ELF-ified Windows
+ * driver module will trigger a bus reprobe.
+ */
+
+#define MODULE_DECL(x)				\
+	MODULE_DEPEND(x, ndisapi, 1, 1, 1);	\
+	MODULE_DEPEND(x, ndis, 1, 1, 1)
+
+MODULE_DECL(DRV_NAME);
+
+static int windrv_probe(device_t);
+static int windrv_modevent(module_t, int, void *);
+static int windrv_loaded = 0;
+
+static device_method_t windrv_methods[] = {
+	/* Device interface */
+	DEVMETHOD(device_probe,         windrv_probe),
+
+	{ 0, 0 }
+};
+
+static driver_t windrv_driver = {
+	"windrv_stub",
+	windrv_methods,
+	0
+};
+
+static devclass_t windrv_devclass;
+
+#define DRIVER_DECL(x)					\
+	DRIVER_MODULE(x, pci, windrv_driver,		\
+	    windrv_devclass, windrv_modevent, NULL);	\
+	DRIVER_MODULE(x, cardbus, windrv_driver,	\
+	    windrv_devclass, windrv_modevent, NULL);	\
+	DRIVER_MODULE(x, pccard, windrv_driver,		\
+	    windrv_devclass, windrv_modevent, NULL);	\
+	DRIVER_MODULE(x, uhub, windrv_driver,		\
+	    windrv_devclass, windrv_modevent, NULL);	\
+	MODULE_VERSION(x, 1)
+
+DRIVER_DECL(DRV_NAME);
+
+static int
+windrv_probe(dev)
+	device_t		dev;
+{
+	return (ENXIO);
+}
+
+static int
+windrv_modevent(mod, cmd, arg)
+	module_t		mod;
+	int			cmd;
+	void			*arg;
+{
+	int			drv_data_len;
+	int			error = 0;
+	vm_offset_t		drv_data_start;
+	vm_offset_t		drv_data_end;
+	interface_type		drv_type;
+
+#ifdef NDIS_PCI_DEV_TABLE
+	drv_type = PCIBus;
+#endif
+
+#ifdef NDIS_PCMCIA_DEV_TABLE
+	drv_type = PCMCIABus;
+#endif
+
+	drv_data_start = (vm_offset_t)&DRV_DATA_START;
+	drv_data_end = (vm_offset_t)&DRV_DATA_END;
+
+	drv_data_len = drv_data_end - drv_data_start;
+	switch (cmd) {
+	case MOD_LOAD:
+		windrv_loaded++;
+		if (windrv_loaded > 1)
+			break;
+		windrv_load(mod, drv_data_start, drv_data_len, drv_type,
+		    ndis_devs, &ndis_regvals);
+		break;
+	case MOD_UNLOAD:
+		windrv_loaded--;
+		if (windrv_loaded > 0)
+			break;
+		windrv_unload(mod, drv_data_start, drv_data_len);
+		break;
+	case MOD_SHUTDOWN:
+		break;
+	default:
+		error = EINVAL;
+		break;
+	}
+
+	return (error);
+}