BSD-style lwIP TCP/IP stack support - docs/INSTALL blurb

diff --git a/RELEASE-NOTES b/RELEASE-NOTES
index 569e0fc..b2ac756 100644 (file)
--- a/RELEASE-NOTES
+++ b/RELEASE-NOTES
@@ -12,6 +12,7 @@ This release includes the following changes:
  o Added CURLOPT_GSSAPI_DELEGATION
  o Added NTLM_SSO support
  o Display notes from setup file in testcurl.pl
+ o BSD-style lwIP TCP/IP stack support on Windows
  o 
 
 This release includes the following bugfixes:

diff --git a/docs/INSTALL b/docs/INSTALL
index 17550dc..7e2ce9a 100644 (file)
--- a/docs/INSTALL
+++ b/docs/INSTALL
@@ -467,6 +467,31 @@ Win32
      in the vc6libcurl.dsw/vc6libcurl.dsp Visual C++ 6 IDE project.
 
 
+   Using BSD-style lwIP instead of Winsock TCP/IP stack in Win32 builds
+   --------------------------------------------------------------------
+
+   In order to compile libcurl and curl using BSD-style lwIP TCP/IP stack
+   it is necessary to make definition of preprocessor symbol USE_LWIPSOCK
+   visible to libcurl and curl compilation processes. To set this definition
+   you have the following alternatives:
+
+   - Modify lib/config-win32.h and src/config-win32.h
+   - Modify lib/Makefile.vc6
+   - Add definition to Project/Settings/C/C++/General/Preprocessor Definitions
+     in the vc6libcurl.dsw/vc6libcurl.dsp Visual C++ 6 IDE project.
+
+   Once that libcurl has been built with BSD-style lwIP TCP/IP stack support,
+   in order to use it with your program it is mandatory that your program
+   includes lwIP header file <lwip/opt.h> (or another lwIP header that includes
+   this) before including any libcurl header. Your program does not need the
+   USE_LWIPSOCK preprocessor definition which is for libcurl internals only.
+
+   Compilation has been verified with lwIP 1.4.0 and contrib-1.4.0 from:
+
+   http://download.savannah.gnu.org/releases/lwip/lwip-1.4.0.zip
+   http://download.savannah.gnu.org/releases/lwip/contrib-1.4.0.zip
+
+
    Important static libcurl usage note
    -----------------------------------