From 894ec46ef4e504e73e023740b67d151e782c9bce Mon Sep 17 00:00:00 2001 From: Gisle Vanem Date: Sat, 8 Jan 2005 16:35:03 +0000 Subject: Note about the static lib requirement; -DCURL_STATICLIB. --- docs/INSTALL | 51 +++++++++++++++++++++++++++++---------------------- 1 file changed, 29 insertions(+), 22 deletions(-) (limited to 'docs/INSTALL') diff --git a/docs/INSTALL b/docs/INSTALL index c904fe6bd..9f9f065f2 100644 --- a/docs/INSTALL +++ b/docs/INSTALL @@ -1,7 +1,7 @@ - _ _ ____ _ - ___| | | | _ \| | - / __| | | | |_) | | - | (__| |_| | _ <| |___ + _ _ ____ _ + ___| | | | _ \| | + / __| | | | |_) | | + | (__| |_| | _ <| |___ \___|\___/|_| \_\_____| How To Compile @@ -75,7 +75,7 @@ UNIX ./configure (with csh, tcsh and their clones): - + env CPPFLAGS="-I/path/to/ssl/include" LDFLAGS="-L/path/to/ssl/lib" \ ./configure @@ -131,7 +131,7 @@ UNIX Win32 ===== - + Without SSL: MingW32 (GCC-2.95) style @@ -199,8 +199,8 @@ Win32 Then run 'nmake vc' in curl's root directory. If you want to compile with zlib support, you will need to build - zlib (http://www.gzip.org/zlib/) as well. Please read the zlib - documentation on how to compile zlib. Define the ZLIB_PATH environment + zlib (http://www.gzip.org/zlib/) as well. Please read the zlib + documentation on how to compile zlib. Define the ZLIB_PATH environment variable to the location of zlib.h and zlib.lib, for example: set ZLIB_PATH=c:\zlib-1.2.1 @@ -229,7 +229,7 @@ Win32 'nmake vc-ssl-dll' creates the libcurl dynamic library and links curl.exe against libcurl and OpenSSL dynamically. This executable requires libcurl.dll and the OpenSSL DLLs - at runtime. + at runtime. Run 'nmake vc-ssl-zlib' to build with both ssl and zlib support. Microsoft / Borland style @@ -241,27 +241,27 @@ Win32 Using Borland C++ compiler version 5.5.1 (available as free download from Borland's site) --------------------------------------------------------------------- - + compile openssl - + Make sure you include the paths to curl/include and openssl/inc32 in your bcc32.cnf file - + eg : -I"c:\Bcc55\include;c:\path_curl\include;c:\path_openssl\inc32" - + Check to make sure that all of the sources listed in lib/Makefile.b32 are present in the /path_to_curl/lib directory. (Check the src directory for missing ones.) - + Make sure the environment variable "BCCDIR" is set to the install location for the compiler eg : c:\Borland\BCC55 - + command line: make -f /path_to_curl/lib/Makefile-ssl.b32 - + compile simplessl.c with appropriate links - + c:\curl\docs\examples\> bcc32 -L c:\path_to_curl\lib\libcurl.lib -L c:\borland\bcc55\lib\psdk\ws2_32.lib -L c:\openssl\out32\libeay32.lib @@ -293,6 +293,13 @@ Win32 - Add defines to Project/Settings/C/C++/General/Preprocessor Definitions in the curllib.dsw/curllib.dsp Visual C++ 6 IDE project. + + Important (with SSL or not): + When building an application that uses the static libcurl library, you + must add '-DCURL_STATICLIB' to your CFLAGS. Otherwise the linker will + look for dynamic import symbols. + + IBM OS/2 ======== @@ -373,7 +380,7 @@ VMS 1 = Success 2 = Error 3 = Information - 4 = Fatal + 4 = Fatal <5-7> reserved. This all presents itself with: @@ -449,10 +456,10 @@ NetWare - either any gcc / nlmconv, or CodeWarrior 7 PDK 4 or later. - gnu make and awk running on the platform you compile on; native Win32 versions can be downloaded from: - http://www.gknw.com/development/prgtools/ + http://www.gknw.com/development/prgtools/ - recent Novell LibC SDK available from: http://developer.novell.com/ndk/libc.htm - - optional zlib sources (at the moment only dynamic linking with zlib.imp); + - optional zlib sources (at the moment only dynamic linking with zlib.imp); sources with NetWare Makefile can be obtained from: http://www.gknw.com/mirror/zlib/ @@ -464,7 +471,7 @@ NetWare a 'set | grep OSTYPE' shows the var present and set; I simply overwrote it with 'OSTYPE=linux-rh9-gnu' and the detection in the Makefile worked...; other options are currently not supported, although partly prepared. - The Ares lib builds arlready fine, and both test tools work fine at least + The Ares lib builds arlready fine, and both test tools work fine at least when build with CodeWarrior...; don't know yet why they fail when build with gcc though; if you want to compile with Ares support then set an env var WITH_ARES=1; I've not tested yet including libares into curl. @@ -604,7 +611,7 @@ PORTS - m68k Linux - m68k OpenBSD - m88k dg-dgux5.4R3.00 - - s390 Linux + - s390 Linux - XScale/PXA250 Linux 2.4 Useful URLs -- cgit v1.2.3