                 -------------------------------
                 |        INTRODUCTION         |
                 -------------------------------

This package permits to COMPILE lcrzo.dll. If you seek a 
pre-compiled version, download lcrzo-4.xx-bin_windows.tgz.


Note : if you encounter problems, read ./doc/problemssolutionswindows_en.txt

There are 2 steps to compile :
 - install winpcap [if not already installed]
    - winpcap version >= 2.1 for Windows 95,98,Me,NT,2000
    - winpcap version >= 2.3 for Windows XP
 - compile and install lcrzo.dll


                 -------------------------------
                 |       STEP 1 : winpcap      |
                 -------------------------------

If winpcap isn't installed on your system, download it from :
  http://netgroup-serv.polito.it/winpcap/
Version 2.1, or superior, is needed for Windows 95,98,Me,NT,2000.
Version 2.3, or superior, is needed for Windows XP.
Follow the given instructions in order to install it.

After installing winpcap, you should test if it is working properly.
If you do not want to bother testing, you can directly go to step 2.
To test winpcap's installation, you need to download windump :
  http://netgroup-serv.polito.it/windump/
Then, in a console window, if you enter "\directory...\windump",
network packet will be displayed (for example, you can ping another
computer and see the packets).
Once windump displays network packets, you can go to step2.

If you have a problem downloading, installing winpcap, or running 
windump, read the faq at :
  http://netgroup-serv.polito.it/winpcap/
  http://netgroup-serv.polito.it/windump/
If you still have a problem, contact Winpcap's developers.
I cannot help you, because I do not maintain this code.


                 ------------------------------
                 |     STEP 2 : lcrzo.dll     |
                 ------------------------------

You need a Visual C++ compiler. I suggest you version 6 (it also
works with version 4, but you have to create your own Workspace).

Rename "src/lcrzo_defs_windowsxx.h" to "src/lcrzo_defs.h". For example
under Windows NT4, rename "src/lcrzo_defs_windowsnt4.h" to
"src/lcrzo_defs.h".

Open the Workspace file "src/port/Windows/project/lcrzo/lcrzo.dsw".
Select Release (instead of Debug) as "Active Configuration" under Build.

Press F7 key, to build everything.

The following files should be generated :
 src/port/Windows/project/lcrzo/Release/lcrzo.lib
 src/port/Windows/project/lcrzo/Release/lcrzo.dll

Copy "src/port/Windows/project/lcrzo/Release/lcrzo.dll" to
 - "c:\Windows\System\lcrzo.dll"   [under Windows 95, 98, Me]
 - "c:\winnt\System32\lcrzo.dll"   [under Windows NT, 2000]
 - "c:\windows\System32\lcrzo.dll" [under Windows XP]

Create a directory which will contain material for building 
projects using lcrzo (for example "c:\lcrzo\").

Copy "src/port/Windows/project/lcrzo/Release/lcrzo.lib" to 
"c:\lcrzo\lib\lcrzo.lib".

Copy "src\*.h" to "c:\lcrzo\include\*.h".


                 ------------------------------
                 |          NEXT STEP         |
                 ------------------------------

Now, I suggest you to download lcrzoex, which shows over 200 examples
of lcrzo.

If you want to create your own program using Visual C++ 6, follow 
those steps :
 - open Microsoft Visual C++ 6
 - Menu File - New
   + select "Win32 Console Application"
   + project name "lcrzotest"
   + location "c:\lcrzo\lcrzotest"
   + button OK
   + create "an empty project"
   + button Finish
 - Menu File - New
   + select "C/C++ source file"
   + file name "t1.c"
   + enter in this file :
       #include <lcrzo.h>
       #include <stdio.h>
       int main(void)
       { lcrzo_ipl ipl;
         lcrzo_init();
         lcrzo_epr(lcrzo_ipl_init_ips("1.2.3.4", &ipl));
         lcrzo_epr(lcrzo_ipl_print("The address is ", ipl, "\n"));
         lcrzo_close();
         return(0);
       }
 - Menu Project - Settings
   + select "C/C++"
   + select the category "preprocessor"
   + additional include directories "c:\lcrzo\include\"
   + button OK
 - Menu Project - Settings [this step is very important]
   + select "C/C++"
   + select the category "code generation"
   + use run-time library "Multithreaded DLL"
   + button OK
 - Menu Project - Settings
   + select "Link"
   + select the category "general"
   + in "Object/library modules", add at the end "lcrzo.lib"
   + button OK
 - Menu Project - Settings
   + select "Link"
   + select the category "input"
   + additional libraries path "c:\lcrzo\lib\"
   + button OK
 - press F7
 - open a msdos console in "c:\lcrzo\lcrzotest\Debug" :
   + button Start - Menu Run - "command" (or "cmd")
   + cd c:\lcrzo\lcrzotest\Debug
 - run lcrzotest.exe :
   + lcrzotest
   The text displayed should be :
     The address is 1.2.3.4
