readme.dos

This directory contains source code for tcpdump, a tool for network monitoring and data acquisition

tcpdump for DOS (djgpp & Pharlap)
----------------------------------

This is a port of tcpdump ver. 3.5 & libpcap for DOS. See the
`README' file if you don't know what they are.

The following targets are supported:

 - Borland C 4.0+ small or large model.
 - Metaware HighC 3.1+ with PharLap DOS-extender
 - GNU C 2.7+ with djgpp 2.01+ DOS extender
 - Watcom C 11.x with DOS4GW extender

 Note: tcpdump uses too much data, so small and large memory models
       (for Borland) are not supported. Only libpcap may be compiled
       with Borland C.


Required packages:
------------------

tcpdump requires installation of Watt-32 and libpcap. Get and install
http://www.bgnett.no/~giva/watt32s*.zip and
http://www.bgnett.no/~giva/pcap/libpcap.zip.

It's recommended that you install this into sub-directory named
`.\pcap\'. Otherwise you need to update the makefiles.

Refer file `.\pcap\readme.dos'. No additional tools besides those
described there are required.


Building libpcap & tcpdump
--------------------------

First step is to build libpcap.

1. Make sure you have set the environment variable C_INCLUDE_PATH to
   point to the Watt-32 include directory. And LIBRARY_PATH to point
   to Watt-32 library directory. E.g, put:
     SET C_INCLUDE_PATH=c:/net/watt/inc
     SET LIBRARY_PATH=c:/net/watt/lib
   in your autoexec.bat.

   Enter the .\pcap subdirectory and build pcap library as described in
   `.\pcap\readme.dos'.

2. Build pcap by using appropriate makefile. For djgpp, use:
     make -f makefile.dj

Follow these steps in building tcpdump:

1. Currently only djgpp, Watcom and Metaware HighC is supported. Compiling
   for 16-bit targets would require major rewrite to keep size of static
   data below 64kByte (DGROUP limit).

2. The makefiles uses environment variable `WATT_ROOT' set during installa-
   tion of Watt-32. If you want to add/remove some features, change `DEFINES'
   accordingly.  E.g. `-DPRINT_NETBIOS_DETAILS' includes a much more detailed
   NetBIOS (nbt) dumper. `USE_RPC' should be 0 as this library isn't released
   yet.

   For djgpp, change `-mcpu=i486' to `-m486' if you have gcc 2.7.2 or older
   If you have gcc 2.8 or older and would like to generate a .map-file, change
   `makefile.dj' to redirect to stdout instead:
     LINK = redir -o ...

   For djgpp use this GNU make command:
     `make -f makefile.dj'

   For Metaware use this make command (Borland maker.exe):
     `make -f makefile.hc'



Acknowledgements
----------------

DJ Delorie <[e-mail]> for giving djgpp to the world.
[e-mail]  for providing the SMB parsers for tcpdump.

All who contributed and provided fixes to the Watt-32 tcp/ip library.


Gisle Vanem <[e-mail]>  -- Bergen, Norway
            <[e-mail]>      Oct. 1999