Networking FreeDOS - Quick Networking HowTo
The original of this Quick Networking HowTo is available in internet
with pictures, see:
http://wiki.freedos.org/wiki/index.php/Networking_FreeDOS_-_Quick_
Networking_HowTo .
The next chapters of this document will describe DOS networking with a
lot of detail. But for the impatient users, here's a quick HowTo: It
explains how to set up a network with FreeDOS 1.3.
Install the networking software
By default there is no network preinstalled with FreeDOS.
But the installer makes it pretty simple to set it up.
* Install FreeDOS according to http://www.freedos.org/install/
* Afterwards, leave the CD in the tray, reboot and choose:
"Boot from system harddisk".
(Picture installing FreeDOS from CD)
* After the reboot run the package manager FDIMPLES:
(Picture with tool FDIMPLES activating FDNET, mTCP and HTGET.)
(The install CD has to be present to see all the packages available.)
* In the left window choose Networking, in the right the programs
you wish to install.
* FDNET is mandatory for networking in virtual machines. I
would also recommend at least mTCP and wget. Confirm with OK.
* Reboot.
(Picture showing FreeDOS 1.3 that booted up with network support.)
The boot messages above show that the C:\FREEDOS\BIN\FDNET.BAT network
batch file was able to identify my system correctly as running in
VirtualBox. It loaded the correct packet driver PCNTPK.COM. DHCP.EXE
from mTCP also found the network and was configured automatically.
So far FDNET.BAT is able to identify the following virtual machines:
QEMU, VirtualBox, VMWARE.
If you don't run FreeDOS in a virtual machine
If you don't run FreeDOS in a virtual machine, you should first try
to find a packet driver for your network interface card (NIC).
Many packet drivers are written and collected by Russell Nelson and
his Crynwr Software (*01). Download them from there or from the
FreeDOS repository.
Georg Potthast provides a collection of PCI card packet drivers (see:
http://www.georgpotthast.de/sioux/packet.htm ) and a tool called
NICSCAN.EXE (see: http://www.georgpotthast.de/sioux/pktdrv/nicscan.zip)
to determine the chipset of PCI network cards. He made the experience
that packet drivers are often the same for a large number of models by
the same manufacturer, so he recommends not to try finding a packet
driver specific for your model number.
If you found a packet driver, please add it to your FDAUTO.BAT
right before the line with FDNET.BAT. For example the simplest way
for a Realtek8139 is:
a) Run fdimples and install fdnet, mTCP and wget packets (if not
already done)
b) Download NICSCAN from the Georg Potthast site,
c) Run NICSCAN and you will see that you have an Realtek8139 card.
d) Create a folder "C:\REAL8139" and copy "rtspkt.com" etc. (driver)
in there.
e) Edit "C:\fdauto.bat" and add:
"lh C:\REAL8139\rtspkt.com 0x60"
one line above:
"if exist %dosdir%\bin\fdnet.bat call %dosdir%\bin\fdnet.bat start"
f) Save "C:\fdauto.bat" and reboot. Then check if for example:
"fdnpkg install zoo" works.
Without a packet driver
If you can't find a packet driver for your network card, there is a
good chance to find a driver that was supposed to work with Novell
Netware (ODI driver) or with the Windows Lanmanager or with Windows
for Workgroups (NDIS driver). It's a bit of work, but you can use
these drivers as packet drivers. Learn more about NDIS drivers
or ODI drivers in this documentation.
The network's up. Now what?
If you're using FreeDOS in VirtualBox, please check your settings for
your network adapter. You have to decide between bridged Networking
or NAT. Please see the HowTo about VirtualBox (*02).
You need to configure your networking programs. For instance set the
name and password for the FTP server by editing C:\MTCP\FTPPASS.TXT.
Some DOS networking programs need to find the network configuration
in C:\FREEDOS\WATTCP.CFG. In FreeDOS 1.3 it looks like this:
my_ip = dhcp
Unfortunately some old programs are not able to get the values by
DHCP themselves. So either you put fixed IPs in here. Or you use a
nice utility written by Canadian programmer Dave Dunfield (*03) (*04):
It will get the correct network settings via DHCP and insert them in
C:\FREEDOS\WATTCP.CFG.
If you want to do the latter,
* Open C:\FREEDOS\WATTCP.CFG and delete the line
my_ip = dhcp
* Go to Dave Dunfields "DOS Widgets" page (*03).
* Download "DDHCP" from the network tools section
(NEW: "DHCP", see (*04)).
* Put it into an directory C:\DDHCP and add these lines to
FDAUTO.BAT, right after the FDNET.BAT line:
if exist %dosdir%\bin\fdnet.bat call %dosdir%\bin\fdnet.bat start
C:\DDHCP\DDHCP /W /F
(The "/F" parameter will fill in all values that are missing in
WATTCP.CFG.)
(PLEASE NOTE: The filename is not "DDHCP" but "DHCP"! So there
maybe minor changes!)
Now with every reboot, WATTCP.CFG is updated with the correct network
settings.
See also:
* (*01) Crynwr website, see:
http://crynwr.com
Crynwr packet drivers, see:
http://crynwr.com/drivers/
OR:
https://web.archive.org/web/20120623172127/http://www.crynwr.
com/drivers/
(everything in ONE LINE, NO free space!)
* (*02) HowTo about Virtual Box, see:
http://wiki.freedos.org/wiki/index.php/VirtualBox
* (*03) Dave Dunfields "DOS Widgets page" is here now:
http://dunfield.classiccmp.org/dos/index.html
* (*04) The file seems to have the name "dhcp.zip" instead
of ddhcp.zip. So the new link is:
http://dunfield.classiccmp.org/dos/dhcp.zip
Copyright © 2007 Ulrich Hansen, Mainz (Germany), updated 2022
for FreeDOS help by W.Spiegl.
For more information see here.
This file is derived from the FreeDOS Spec Command HOWTO.
See the file H2Cpying for copying conditions.