9da7bdde06
The Software Package Data Exchange (SPDX) group provides a specification to make it easier for automated tools to detect and summarize well known opensource licenses. We are gradually adopting the specification, noting that the tags are considered only advisory and do not, in any way, superceed or replace the license texts. Special thanks to Wind River for providing access to "The Duke of Highlander" tool: an older (2014) run over FreeBSD tree was useful as a starting point. Initially, only tag files that use BSD 4-Clause "Original" license. RelNotes: yes Differential Revision: https://reviews.freebsd.org/D13133
557 lines
16 KiB
Bash
557 lines
16 KiB
Bash
#!/bin/sh
|
|
#
|
|
# SPDX-License-Identifier: BSD-4-Clause
|
|
#
|
|
# 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 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
|
|
return
|
|
}
|
|
|
|
|
|
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 return to continue... "
|
|
read KEYPRESS
|
|
return
|
|
}
|
|
|
|
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 return to continue... "
|
|
read KEYPRESS
|
|
return
|
|
}
|
|
|
|
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 installer 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 return to continue... "
|
|
read KEYPRESS
|
|
return
|
|
}
|
|
|
|
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 return to continue... "
|
|
read KEYPRESS
|
|
return
|
|
}
|
|
|
|
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 you 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 return to continue... "
|
|
read KEYPRESS
|
|
return
|
|
}
|
|
|
|
infconv () {
|
|
header
|
|
echo " INF file validation"
|
|
|
|
if [ -z "$INFPATH" ]; then
|
|
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
|
|
fi
|
|
|
|
if [ ${INFPATH} ] && [ -e ${INFPATH} ]; then
|
|
INFTYPE=`${EGREP} -i -c "Signature|.S.i.g.n.a.t.u.r.e" ${INFPATH}`
|
|
if [ ${INFTYPE} -le 0 ]; then
|
|
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=""
|
|
return
|
|
fi
|
|
|
|
INFTYPE=`${EGREP} -i -c "Class.*=.*Net" ${INFPATH}`
|
|
if [ ${INFTYPE} -gt 0 ]; then
|
|
echo ""
|
|
echo " This .INF file appears to be ASCII."
|
|
echo ""
|
|
echo -n " Press return to continue... "
|
|
read KEYPRESS
|
|
return
|
|
fi
|
|
|
|
INFTYPE=`${EGREP} -i -c ".C.l.a.s.s.*=.*N.e.t" ${INFPATH}`
|
|
if [ ${INFTYPE} -gt 0 ]; then
|
|
echo ""
|
|
echo " This .INF file appears to be Unicode."
|
|
if [ -e ${ICONVPATH} ]; then
|
|
echo " Trying to convert to ASCII..."
|
|
${ICONVPATH} -f utf-16 -t utf-8 ${INFPATH} > ${INFFILE}
|
|
INFPATH=${INFFILE}
|
|
echo " Done."
|
|
echo ""
|
|
echo -n " Press return 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
|
|
return
|
|
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=""
|
|
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
|
|
return
|
|
}
|
|
|
|
sysconv() {
|
|
header
|
|
echo " Driver file validation"
|
|
|
|
if [ ! -r "$SYSPATH" ]; then
|
|
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/i386 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
|
|
fi
|
|
|
|
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 return 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
|
|
return
|
|
}
|
|
|
|
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
|
|
return
|
|
}
|
|
|
|
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 continue. (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} ]; 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
|
|
return
|
|
}
|
|
|
|
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 ""
|
|
echo -n " Generating Makefile... "
|
|
echo ".PATH: ${PWD} ${STUBPATH}" > ${MAKEFILE}
|
|
echo "KMOD= ${SYSBASE}" >> ${MAKEFILE}
|
|
echo "SRCS+= ${STUBFILE} ${DNAME}.h bus_if.h device_if.h" >> ${MAKEFILE}
|
|
echo "OBJS+=${FRMLIST} ${DNAME}.o" >> ${MAKEFILE}
|
|
echo "CFLAGS+= \\" >> ${MAKEFILE}
|
|
echo " -DDRV_DATA_START=ndis_${SYSBASE}_drv_data_start \\" >> ${MAKEFILE}
|
|
echo " -DDRV_NAME=ndis_${SYSBASE} \\" >> ${MAKEFILE}
|
|
echo " -DDRV_DATA_END=ndis_${SYSBASE}_drv_data_end" >> ${MAKEFILE}
|
|
echo "CLEANFILES+= \\" >> ${MAKEFILE}
|
|
echo " ${INFFILE} \\" >> ${MAKEFILE}
|
|
echo " ${DNAME}.h \\" >> ${MAKEFILE}
|
|
echo " ${DNAME}.o" >> ${MAKEFILE}
|
|
echo ".include <bsd.kmod.mk>" >> ${MAKEFILE}
|
|
if [ -f ${MAKEFILE} ]; then
|
|
echo "done."
|
|
else
|
|
echo "generating Makefile failed. Exiting."
|
|
echo ""
|
|
exit
|
|
fi
|
|
echo -n " Building kernel module... "
|
|
echo "" > bus_if.h
|
|
echo "" > device_if.h
|
|
if ! ${MAKE} -f ${MAKEFILE} all > /dev/null; then
|
|
echo "build failed. Exiting."
|
|
echo ""
|
|
exit
|
|
else
|
|
if [ -f ${SYSBASE}.ko ]; then
|
|
${MV} ${SYSBASE}.ko ${SYSBASE}.kmod
|
|
echo "done."
|
|
else
|
|
echo "build failed. Exiting."
|
|
echo ""
|
|
exit
|
|
fi
|
|
fi
|
|
echo -n " Cleaning up... "
|
|
if ! ${MAKE} -f ${MAKEFILE} clean cleandepend > /dev/null; then
|
|
echo "cleanup failed. Exiting."
|
|
echo ""
|
|
exit
|
|
else
|
|
echo "done."
|
|
fi
|
|
${RM} ${MAKEFILE}
|
|
${MV} ${SYSBASE}.kmod ${SYSBASE}.ko
|
|
echo ""
|
|
echo " The file ${SYSBASE}.ko has been successfully generated."
|
|
echo " You can kldload this module to get started."
|
|
echo ""
|
|
echo -n " Press return to exit. "
|
|
read KEYPRESS
|
|
echo ""
|
|
echo ""
|
|
return
|
|
}
|
|
|
|
convert_driver () {
|
|
while : ; do
|
|
infconv
|
|
if [ ${INFPATH} ]; then
|
|
break
|
|
fi
|
|
done
|
|
|
|
while : ; do
|
|
sysconv
|
|
if [ ${SYSPATH} ]; then
|
|
break
|
|
fi
|
|
done
|
|
|
|
ndiscvt
|
|
firmcvt
|
|
drvgen
|
|
return
|
|
}
|
|
|
|
ICONVPATH=/usr/bin/iconv
|
|
NDISCVT=/usr/sbin/ndiscvt
|
|
STUBPATH=/usr/share/misc
|
|
STUBFILE=windrv_stub.c
|
|
DNAME=windrv
|
|
CP=/bin/cp
|
|
MV=/bin/mv
|
|
RM=/bin/rm
|
|
TR=/usr/bin/tr
|
|
FILE=/usr/bin/file
|
|
EGREP=/usr/bin/egrep
|
|
MAKE=/usr/bin/make
|
|
BASENAME=/usr/bin/basename
|
|
TOUCH=/usr/bin/touch
|
|
MKTEMP=/usr/bin/mktemp
|
|
|
|
MAKEFILE=`${MKTEMP} /tmp/Makefile.XXXXXX`
|
|
INFFILE=`${MKTEMP} /tmp/ascii_inf.XXXXXX`
|
|
|
|
INFPATH=""
|
|
FRMLIST=""
|
|
SYSPATH=""
|
|
SYSBASE=""
|
|
FRMBASE=""
|
|
|
|
if [ -r "$1" -a -r "$2" ]; then
|
|
# Looks like the user supplied .INF and .SYS files on the command line
|
|
INFPATH=$1
|
|
SYSPATH=$2
|
|
convert_driver && exit 0
|
|
fi
|
|
|
|
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 understand that. Press enter to try again: "
|
|
read KEYPRESS
|
|
;;
|
|
esac
|
|
done
|
|
exit
|