2005-01-08 19:35:03 +03:00
|
|
|
_ _ ____ _
|
|
|
|
___| | | | _ \| |
|
|
|
|
/ __| | | | |_) | |
|
|
|
|
| (__| |_| | _ <| |___
|
2000-05-22 21:35:35 +04:00
|
|
|
\___|\___/|_| \_\_____|
|
|
|
|
|
|
|
|
How To Compile
|
|
|
|
|
2004-01-09 12:36:07 +03:00
|
|
|
Installing Binary Packages
|
|
|
|
==========================
|
2000-05-22 21:35:35 +04:00
|
|
|
|
2004-01-09 12:36:07 +03:00
|
|
|
Lots of people download binary distributions of curl and libcurl. This
|
|
|
|
document does not describe how to install curl or libcurl using such a
|
|
|
|
binary package. This document describes how to compile, build and install
|
|
|
|
curl and libcurl from source code.
|
2000-05-22 21:35:35 +04:00
|
|
|
|
|
|
|
UNIX
|
|
|
|
====
|
2001-03-15 11:38:15 +03:00
|
|
|
A normal unix installation is made in three or four steps (after you've
|
|
|
|
unpacked the source archive):
|
2000-11-27 16:39:11 +03:00
|
|
|
|
|
|
|
./configure
|
2001-03-15 11:38:15 +03:00
|
|
|
make
|
|
|
|
make test (optional)
|
|
|
|
make install
|
2000-05-22 21:35:35 +04:00
|
|
|
|
2001-03-15 11:38:15 +03:00
|
|
|
You probably need to be root when doing the last command.
|
|
|
|
|
2010-03-22 02:34:09 +03:00
|
|
|
If you have checked out the sources from the git repository, read the
|
|
|
|
GIT-INFO on how to proceed.
|
2002-11-30 19:00:10 +03:00
|
|
|
|
2003-04-29 20:55:17 +04:00
|
|
|
Get a full listing of all available configure options by invoking it like:
|
|
|
|
|
|
|
|
./configure --help
|
|
|
|
|
2001-03-15 11:38:15 +03:00
|
|
|
If you want to install curl in a different file hierarchy than /usr/local,
|
|
|
|
you need to specify that already when running configure:
|
|
|
|
|
|
|
|
./configure --prefix=/path/to/curl/tree
|
|
|
|
|
2002-11-30 19:00:10 +03:00
|
|
|
If you happen to have write permission in that directory, you can do 'make
|
|
|
|
install' without being root. An example of this would be to make a local
|
|
|
|
install in your own home directory:
|
|
|
|
|
|
|
|
./configure --prefix=$HOME
|
|
|
|
make
|
|
|
|
make install
|
|
|
|
|
2001-03-15 11:38:15 +03:00
|
|
|
The configure script always tries to find a working SSL library unless
|
|
|
|
explicitly told not to. If you have OpenSSL installed in the default search
|
|
|
|
path for your compiler/linker, you don't need to do anything special. If
|
2001-12-03 13:07:49 +03:00
|
|
|
you have OpenSSL installed in /usr/local/ssl, you can run configure like:
|
2000-05-22 21:35:35 +04:00
|
|
|
|
2007-01-26 16:55:18 +03:00
|
|
|
./configure --with-ssl
|
2000-05-22 21:35:35 +04:00
|
|
|
|
2008-07-30 00:59:51 +04:00
|
|
|
If you have OpenSSL installed somewhere else (for example, /opt/OpenSSL)
|
|
|
|
and you have pkg-config installed, set the pkg-config path first, like this:
|
|
|
|
|
|
|
|
env PKG_CONFIG_PATH=/opt/OpenSSL/lib/pkgconfig ./configure --with-ssl
|
|
|
|
|
|
|
|
Without pkg-config installed, use this:
|
2000-05-22 21:35:35 +04:00
|
|
|
|
2007-01-26 16:55:18 +03:00
|
|
|
./configure --with-ssl=/opt/OpenSSL
|
2000-05-22 21:35:35 +04:00
|
|
|
|
2001-12-03 13:07:49 +03:00
|
|
|
If you insist on forcing a build without SSL support, even though you may
|
|
|
|
have OpenSSL installed in your system, you can run configure like this:
|
2000-05-22 21:35:35 +04:00
|
|
|
|
|
|
|
./configure --without-ssl
|
|
|
|
|
|
|
|
If you have OpenSSL installed, but with the libraries in one place and the
|
2001-12-03 13:07:49 +03:00
|
|
|
header files somewhere else, you have to set the LDFLAGS and CPPFLAGS
|
2000-05-22 21:35:35 +04:00
|
|
|
environment variables prior to running configure. Something like this
|
|
|
|
should work:
|
|
|
|
|
|
|
|
(with the Bourne shell and its clones):
|
|
|
|
|
2008-07-30 00:59:51 +04:00
|
|
|
CPPFLAGS="-I/path/to/ssl/include" LDFLAGS="-L/path/to/ssl/lib" \
|
2000-05-22 21:35:35 +04:00
|
|
|
./configure
|
|
|
|
|
|
|
|
(with csh, tcsh and their clones):
|
2005-01-08 19:35:03 +03:00
|
|
|
|
2008-07-30 00:59:51 +04:00
|
|
|
env CPPFLAGS="-I/path/to/ssl/include" LDFLAGS="-L/path/to/ssl/lib" \
|
|
|
|
./configure
|
2000-05-22 21:35:35 +04:00
|
|
|
|
2004-10-26 12:09:16 +04:00
|
|
|
If you have shared SSL libs installed in a directory where your run-time
|
|
|
|
linker doesn't find them (which usually causes configure failures), you can
|
|
|
|
provide the -R option to ld on some operating systems to set a hard-coded
|
|
|
|
path to the run-time linker:
|
|
|
|
|
2008-07-30 00:59:51 +04:00
|
|
|
env LDFLAGS=-R/usr/local/ssl/lib ./configure --with-ssl
|
2004-10-26 12:09:16 +04:00
|
|
|
|
2001-03-15 11:38:15 +03:00
|
|
|
MORE OPTIONS
|
2008-07-23 22:17:25 +04:00
|
|
|
------------
|
2000-05-22 21:35:35 +04:00
|
|
|
|
2001-12-03 13:07:49 +03:00
|
|
|
To force configure to use the standard cc compiler if both cc and gcc are
|
|
|
|
present, run configure like
|
2000-05-22 21:35:35 +04:00
|
|
|
|
|
|
|
CC=cc ./configure
|
|
|
|
or
|
2004-12-11 00:55:05 +03:00
|
|
|
env CC=cc ./configure
|
2000-05-22 21:35:35 +04:00
|
|
|
|
2000-09-18 18:14:33 +04:00
|
|
|
To force a static library compile, disable the shared library creation
|
|
|
|
by running configure like:
|
|
|
|
|
|
|
|
./configure --disable-shared
|
|
|
|
|
2000-09-27 02:32:46 +04:00
|
|
|
To tell the configure script to skip searching for thread-safe functions,
|
|
|
|
add an option like:
|
|
|
|
|
|
|
|
./configure --disable-thread
|
|
|
|
|
|
|
|
To build curl with kerberos4 support enabled, curl requires the krb4 libs
|
|
|
|
and headers installed. You can then use a set of options to tell
|
|
|
|
configure where those are:
|
|
|
|
|
|
|
|
--with-krb4-includes[=DIR] Specify location of kerberos4 headers
|
|
|
|
--with-krb4-libs[=DIR] Specify location of kerberos4 libs
|
|
|
|
--with-krb4[=DIR] where to look for Kerberos4
|
|
|
|
|
|
|
|
In most cases, /usr/athena is the install prefix and then it works with
|
|
|
|
|
|
|
|
./configure --with-krb4=/usr/athena
|
2000-05-22 21:35:35 +04:00
|
|
|
|
2001-02-05 13:24:12 +03:00
|
|
|
If you're a curl developer and use gcc, you might want to enable more
|
|
|
|
debug options with the --enable-debug option.
|
|
|
|
|
2006-07-09 01:29:45 +04:00
|
|
|
curl can be built to use a whole range of libraries to provide various
|
|
|
|
useful services, and configure will try to auto-detect a decent
|
|
|
|
default. But if you want to alter it, you can select how to deal with
|
|
|
|
each individual library.
|
|
|
|
|
|
|
|
To build with GnuTLS support instead of OpenSSL for SSL/TLS, note that
|
|
|
|
you need to use both --without-ssl and --with-gnutls.
|
|
|
|
|
2008-07-30 00:59:51 +04:00
|
|
|
To build with yassl support instead of OpenSSL or GnuTLS, you must build
|
2006-07-09 01:29:45 +04:00
|
|
|
yassl with its OpenSSL emulation enabled and point to that directory root
|
|
|
|
with configure --with-ssl.
|
|
|
|
|
2007-02-13 01:32:37 +03:00
|
|
|
To build with NSS support instead of OpenSSL for SSL/TLS, note that
|
|
|
|
you need to use both --without-ssl and --with-nss.
|
|
|
|
|
2010-07-27 03:38:29 +04:00
|
|
|
To build with PolarSSL support instead of OpenSSL for SSL/TLS, note that
|
|
|
|
you need to use both --without-ssl and --with-polarssl.
|
|
|
|
|
2010-12-15 18:08:45 +03:00
|
|
|
To build with axTLS support instead of OpenSSL for TLS, note that you
|
|
|
|
need to use both --without-ssl and --with-axtls.
|
|
|
|
|
2007-08-06 19:54:38 +04:00
|
|
|
To get GSSAPI support, build with --with-gssapi and have the MIT or
|
|
|
|
Heimdal Kerberos 5 packages installed.
|
|
|
|
|
|
|
|
To get support for SCP and SFTP, build with --with-libssh2 and have
|
|
|
|
libssh2 0.16 or later installed.
|
2010-02-14 22:40:18 +03:00
|
|
|
|
2008-07-23 22:17:25 +04:00
|
|
|
SPECIAL CASES
|
|
|
|
-------------
|
|
|
|
Some versions of uClibc require configuring with CPPFLAGS=-D_GNU_SOURCE=1
|
|
|
|
to get correct large file support.
|
|
|
|
|
|
|
|
The Open Watcom C compiler on Linux requires configuring with the variables:
|
|
|
|
|
2008-07-30 00:59:51 +04:00
|
|
|
./configure CC=owcc AR="$WATCOM/binl/wlib" AR_FLAGS=-q \
|
|
|
|
RANLIB=/bin/true STRIP="$WATCOM/binl/wstrip" CFLAGS=-Wextra
|
2008-07-23 22:17:25 +04:00
|
|
|
|
2006-08-09 20:10:20 +04:00
|
|
|
|
2000-05-22 21:35:35 +04:00
|
|
|
Win32
|
|
|
|
=====
|
2005-01-08 19:35:03 +03:00
|
|
|
|
2007-04-04 22:03:28 +04:00
|
|
|
Building Windows DLLs and C run-time (CRT) linkage issues
|
|
|
|
---------------------------------------------------------
|
|
|
|
|
|
|
|
As a general rule, building a DLL with static CRT linkage is highly
|
|
|
|
discouraged, and intermixing CRTs in the same app is something to
|
|
|
|
avoid at any cost.
|
|
|
|
|
|
|
|
Reading and comprehension of Microsoft Knowledge Base articles
|
|
|
|
KB94248 and KB140584 is a must for any Windows developer. Especially
|
|
|
|
important is full understanding if you are not going to follow the
|
|
|
|
advice given above.
|
|
|
|
|
|
|
|
KB94248 - How To Use the C Run-Time
|
|
|
|
http://support.microsoft.com/kb/94248/en-us
|
|
|
|
|
|
|
|
KB140584 - How to link with the correct C Run-Time (CRT) library
|
|
|
|
http://support.microsoft.com/kb/140584/en-us
|
|
|
|
|
2009-03-18 16:58:29 +03:00
|
|
|
KB190799 - Potential Errors Passing CRT Objects Across DLL Boundaries
|
|
|
|
http://msdn.microsoft.com/en-us/library/ms235460
|
|
|
|
|
2007-04-04 22:03:28 +04:00
|
|
|
If your app is misbehaving in some strange way, or it is suffering
|
|
|
|
from memory corruption, before asking for further help, please try
|
|
|
|
first to rebuild every single library your app uses as well as your
|
|
|
|
app using the debug multithreaded dynamic C runtime.
|
|
|
|
|
2005-10-30 02:18:58 +04:00
|
|
|
MingW32
|
|
|
|
-------
|
2000-05-22 21:35:35 +04:00
|
|
|
|
2007-09-03 15:10:46 +04:00
|
|
|
Make sure that MinGW32's bin dir is in the search path, for example:
|
|
|
|
|
|
|
|
set PATH=c:\mingw32\bin;%PATH%
|
|
|
|
|
|
|
|
then run 'mingw32-make mingw32' in the root dir. There are other
|
|
|
|
make targets available to build libcurl with more features, use:
|
2007-08-03 15:46:00 +04:00
|
|
|
'mingw32-make mingw32-zlib' to build with Zlib support;
|
|
|
|
'mingw32-make mingw32-ssl-zlib' to build with SSL and Zlib enabled;
|
|
|
|
'mingw32-make mingw32-ssh2-ssl-zlib' to build with SSH2, SSL, Zlib;
|
|
|
|
'mingw32-make mingw32-ssh2-ssl-sspi-zlib' to build with SSH2, SSL, Zlib
|
2007-09-03 15:10:46 +04:00
|
|
|
and SSPI support.
|
2000-05-22 21:35:35 +04:00
|
|
|
|
2005-10-30 02:18:58 +04:00
|
|
|
If you have any problems linking libraries or finding header files, be sure
|
|
|
|
to verify that the provided "Makefile.m32" files use the proper paths, and
|
2010-02-14 22:40:18 +03:00
|
|
|
adjust as necessary. It is also possible to override these paths with
|
2007-01-26 16:55:18 +03:00
|
|
|
environment variables, for example:
|
|
|
|
|
|
|
|
set ZLIB_PATH=c:\zlib-1.2.3
|
2009-07-14 18:01:11 +04:00
|
|
|
set OPENSSL_PATH=c:\openssl-0.9.8k
|
|
|
|
set LIBSSH2_PATH=c:\libssh2-1.1
|
2007-01-26 16:55:18 +03:00
|
|
|
|
|
|
|
ATTENTION: if you want to build with libssh2 support you have to use latest
|
2007-09-03 15:10:46 +04:00
|
|
|
version 0.17 - previous versions will NOT work with 7.17.0 and later!
|
2007-08-03 15:46:00 +04:00
|
|
|
Use 'mingw32-make mingw32-ssh2-ssl-zlib' to build with SSH2 and SSL enabled.
|
2000-05-22 21:35:35 +04:00
|
|
|
|
2007-09-03 15:10:46 +04:00
|
|
|
It is now also possible to build with other LDAP SDKs than MS LDAP;
|
|
|
|
currently it is possible to build with native Win32 OpenLDAP, or with the
|
|
|
|
Novell CLDAP SDK. If you want to use these you need to set these vars:
|
|
|
|
|
|
|
|
set LDAP_SDK=c:\openldap
|
|
|
|
set USE_LDAP_OPENLDAP=1
|
|
|
|
|
|
|
|
or for using the Novell SDK:
|
|
|
|
|
|
|
|
set USE_LDAP_NOVELL=1
|
|
|
|
|
|
|
|
If you want to enable LDAPS support then set LDAPS=1.
|
|
|
|
|
|
|
|
- optional MingW32-built OpenlDAP SDK available from:
|
|
|
|
http://www.gknw.net/mirror/openldap/
|
|
|
|
- optional recent Novell CLDAP SDK available from:
|
|
|
|
http://developer.novell.com/ndk/cldap.htm
|
|
|
|
|
|
|
|
|
2005-10-30 02:18:58 +04:00
|
|
|
Cygwin
|
|
|
|
------
|
2000-05-22 21:35:35 +04:00
|
|
|
|
2005-10-30 02:18:58 +04:00
|
|
|
Almost identical to the unix installation. Run the configure script in the
|
|
|
|
curl root with 'sh configure'. Make sure you have the sh executable in
|
2007-08-14 21:23:32 +04:00
|
|
|
/bin/ or you'll see the configure fail toward the end.
|
2000-05-22 21:35:35 +04:00
|
|
|
|
2005-10-30 02:18:58 +04:00
|
|
|
Run 'make'
|
2000-05-22 21:35:35 +04:00
|
|
|
|
2005-10-30 02:18:58 +04:00
|
|
|
Dev-Cpp
|
|
|
|
-------
|
2001-01-17 11:24:29 +03:00
|
|
|
|
2005-10-30 02:18:58 +04:00
|
|
|
See the separate INSTALL.devcpp file for details.
|
2000-05-22 21:35:35 +04:00
|
|
|
|
2009-09-04 20:59:10 +04:00
|
|
|
MSVC 6 caveats
|
|
|
|
--------------
|
|
|
|
|
2009-10-21 22:46:00 +04:00
|
|
|
If you use MSVC 6 it is required that you use the February 2003 edition PSDK:
|
2009-09-04 20:59:10 +04:00
|
|
|
http://www.microsoft.com/msdownload/platformsdk/sdkupdate/psdk-full.htm
|
2009-10-21 22:46:00 +04:00
|
|
|
|
|
|
|
Building any software with MSVC 6 without having PSDK installed is just
|
|
|
|
asking for trouble down the road once you have released it, you might notice
|
|
|
|
the problems in the first corner or ten miles ahead, depending mostly on your
|
|
|
|
choice of static vs dynamic runtime and third party libraries. Anyone using
|
|
|
|
software built in such way will at some point regret having done so.
|
|
|
|
|
|
|
|
When someone uses MSVC 6 without PSDK he is using a compiler back from 1998.
|
|
|
|
|
|
|
|
If the compiler has been updated with the installation of a service pack as
|
|
|
|
those mentioned in http://support.microsoft.com/kb/194022 the compiler can be
|
|
|
|
safely used to read source code, translate and make it object code.
|
|
|
|
|
|
|
|
But, even with the service packs mentioned above installed, the resulting
|
|
|
|
software generated in such an environment will be using outdated system
|
|
|
|
header files and libraries with bugs and security issues which have already
|
|
|
|
been addressed and fixed long time ago.
|
|
|
|
|
|
|
|
In order to make use of the updated system headers and fixed libraries
|
|
|
|
for MSVC 6, it is required that 'Platform SDK', PSDK from now onwards,
|
|
|
|
is installed. The specific PSDK that must be installed for MSVC 6 is the
|
|
|
|
February 2003 edition, which is the latest one supporting the MSVC 6 compiler,
|
|
|
|
this PSDK is also known as 'Windows Server 2003 PSDK' and can be downloaded
|
|
|
|
from http://www.microsoft.com/msdownload/platformsdk/sdkupdate/psdk-full.htm
|
|
|
|
|
|
|
|
So, building curl and libcurl with MSVC 6 without PSDK is absolutely
|
|
|
|
discouraged for the benefit of anyone using software built in such
|
|
|
|
environment. And it will not be supported in any way, as we could just
|
|
|
|
be hunting bugs which have already been fixed way back in 2003.
|
|
|
|
|
|
|
|
When building with MSVC 6 we attempt to detect if PSDK is not being used,
|
|
|
|
and if this is the case the build process will fail hard with an error
|
|
|
|
message stating that the February 2003 PSDK is required. This is done to
|
|
|
|
protect the unsuspecting and avoid PEBKAC issues.
|
|
|
|
|
|
|
|
Additionally it might happen that a die hard MSVC hacker still wants to
|
|
|
|
build curl and libcurl with MSVC 6 without PSDK installed, even knowing
|
|
|
|
that this is a highly discouraged and unsupported build environment. In
|
|
|
|
this case the brave of heart will be able to build in such an environment
|
|
|
|
with the requisite of defining preprocessor symbol ALLOW_MSVC6_WITHOUT_PSDK
|
|
|
|
in lib/config-win32.h and knowing that LDAP and IPv6 support will be missing.
|
2009-09-04 20:59:10 +04:00
|
|
|
|
2005-10-30 02:18:58 +04:00
|
|
|
MSVC from command line
|
|
|
|
----------------------
|
2000-05-22 21:35:35 +04:00
|
|
|
|
2005-10-30 02:18:58 +04:00
|
|
|
Run the 'vcvars32.bat' file to get a proper environment. The
|
|
|
|
vcvars32.bat file is part of the Microsoft development environment and
|
|
|
|
you may find it in 'C:\Program Files\Microsoft Visual Studio\vc98\bin'
|
|
|
|
provided that you installed Visual C/C++ 6 in the default directory.
|
2000-05-22 21:35:35 +04:00
|
|
|
|
2005-10-30 02:18:58 +04:00
|
|
|
Then run 'nmake vc' in curl's root directory.
|
2000-05-22 21:35:35 +04:00
|
|
|
|
2005-10-30 02:18:58 +04:00
|
|
|
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
|
|
|
|
variable to the location of zlib.h and zlib.lib, for example:
|
2000-05-22 21:35:35 +04:00
|
|
|
|
2007-01-26 16:55:18 +03:00
|
|
|
set ZLIB_PATH=c:\zlib-1.2.3
|
2000-05-22 21:35:35 +04:00
|
|
|
|
2005-10-30 02:18:58 +04:00
|
|
|
Then run 'nmake vc-zlib' in curl's root directory.
|
2000-05-22 21:35:35 +04:00
|
|
|
|
2005-10-30 02:18:58 +04:00
|
|
|
If you want to compile with SSL support you need the OpenSSL package.
|
|
|
|
Please read the OpenSSL documentation on how to compile and install
|
|
|
|
the OpenSSL libraries. The build process of OpenSSL generates the
|
|
|
|
libeay32.dll and ssleay32.dll files in the out32dll subdirectory in
|
|
|
|
the OpenSSL home directory. OpenSSL static libraries (libeay32.lib,
|
|
|
|
ssleay32.lib, RSAglue.lib) are created in the out32 subdirectory.
|
2000-05-22 21:35:35 +04:00
|
|
|
|
2005-10-30 02:18:58 +04:00
|
|
|
Before running nmake define the OPENSSL_PATH environment variable with
|
|
|
|
the root/base directory of OpenSSL, for example:
|
2002-03-22 15:01:30 +03:00
|
|
|
|
2009-07-14 18:01:11 +04:00
|
|
|
set OPENSSL_PATH=c:\openssl-0.9.8k
|
2004-07-11 17:49:52 +04:00
|
|
|
|
2005-10-30 02:18:58 +04:00
|
|
|
Then run 'nmake vc-ssl' or 'nmake vc-ssl-dll' in curl's root
|
|
|
|
directory. 'nmake vc-ssl' will create a libcurl static and dynamic
|
|
|
|
libraries in the lib subdirectory, as well as a statically linked
|
|
|
|
version of curl.exe in the src subdirectory. This statically linked
|
|
|
|
version is a standalone executable not requiring any DLL at
|
|
|
|
runtime. This make method requires that you have the static OpenSSL
|
|
|
|
libraries available in OpenSSL's out32 subdirectory.
|
|
|
|
'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.
|
|
|
|
Run 'nmake vc-ssl-zlib' to build with both ssl and zlib support.
|
2004-07-11 17:49:52 +04:00
|
|
|
|
2008-08-30 08:13:31 +04:00
|
|
|
MSVC 6 IDE
|
|
|
|
----------
|
|
|
|
|
|
|
|
A minimal VC++ 6.0 reference workspace (vc6curl.dsw) is available with the
|
|
|
|
source distribution archive to allow proper building of the two included
|
|
|
|
projects, the libcurl library and the curl tool.
|
|
|
|
|
|
|
|
1) Open the vc6curl.dsw workspace with MSVC6's IDE.
|
|
|
|
2) Select 'Build' from top menu.
|
|
|
|
3) Select 'Batch Build' from dropdown menu.
|
|
|
|
4) Make sure that the eight project configurations are 'checked'.
|
|
|
|
5) Click on the 'Build' button.
|
|
|
|
6) Once the eight project configurations are built you are done.
|
|
|
|
|
|
|
|
Dynamic and static libcurl libraries are built in debug and release flavours,
|
|
|
|
and can be located each one in its own subdirectory, DLL-Debug, DLL-Release,
|
|
|
|
LIB-Debug and LIB-Release, all of them below the 'lib' subdirectory.
|
|
|
|
|
|
|
|
In the same way four curl executables are created, each using its respective
|
|
|
|
library. The resulting curl executables are located in its own subdirectory,
|
|
|
|
DLL-Debug, DLL-Release, LIB-Debug and LIB-Release, below the 'src' subdir.
|
|
|
|
|
|
|
|
These reference VC++ 6.0 configurations are generated using the dynamic CRT.
|
|
|
|
|
|
|
|
Intentionally, these reference VC++ 6.0 projects and configurations don't use
|
|
|
|
third party libraries, such as OpenSSL or Zlib, to allow proper compilation
|
|
|
|
and configuration for all new users without further requirements.
|
|
|
|
|
|
|
|
If you need something more 'involved' you might adjust them for your own use,
|
|
|
|
or explore the world of makefiles described above 'MSVC from command line'.
|
|
|
|
|
2005-10-30 02:18:58 +04:00
|
|
|
Borland C++ compiler
|
|
|
|
---------------------
|
2004-07-11 17:49:52 +04:00
|
|
|
|
2011-01-13 01:28:19 +03:00
|
|
|
Ensure that your build environment is properly set up to use the compiler
|
|
|
|
and associated tools. PATH environment variable must include the path to
|
|
|
|
bin subdirectory of your compiler installation, eg: c:\Borland\BCC55\bin
|
2004-07-11 17:49:52 +04:00
|
|
|
|
2011-01-13 01:28:19 +03:00
|
|
|
It is advisable to set environment variable BCCDIR to the base path of
|
|
|
|
the compiler installation.
|
2004-07-11 17:49:52 +04:00
|
|
|
|
2011-01-13 01:28:19 +03:00
|
|
|
set BCCDIR=c:\Borland\BCC55
|
2001-06-07 10:21:27 +04:00
|
|
|
|
2011-01-13 01:28:19 +03:00
|
|
|
In order to build a plain vanilla version of curl and libcurl run the
|
|
|
|
following command from curl's root directory:
|
2002-02-06 19:01:10 +03:00
|
|
|
|
2011-01-13 01:28:19 +03:00
|
|
|
make borland
|
2002-02-06 19:01:10 +03:00
|
|
|
|
2011-01-13 01:28:19 +03:00
|
|
|
To build curl and libcurl with zlib and OpenSSL support set environment
|
|
|
|
variables ZLIB_PATH and OPENSSL_PATH to the base subdirectories of the
|
|
|
|
already built zlib and OpenSSL libraries and from curl's root directory
|
|
|
|
run command:
|
2001-01-17 11:24:29 +03:00
|
|
|
|
2011-01-13 01:28:19 +03:00
|
|
|
make borland-ssl-zlib
|
|
|
|
|
|
|
|
libcurl library will be built in 'lib' subdirectory while curl tool
|
|
|
|
is built in 'src' subdirectory. In order to use libcurl library it is
|
|
|
|
advisable to modify compiler's configuration file bcc32.cfg located
|
|
|
|
in c:\Borland\BCC55\bin to reflect the location of libraries include
|
|
|
|
paths for example the '-I' line could result in something like:
|
|
|
|
|
|
|
|
-I"c:\Borland\BCC55\include;c:\curl\include;c:\openssl\inc32"
|
|
|
|
|
|
|
|
bcc3.cfg '-L' line could also be modified to reflect the location of
|
|
|
|
of libcurl library resulting for example:
|
|
|
|
|
|
|
|
-L"c:\Borland\BCC55\lib;c:\curl\lib;c:\openssl\out32"
|
|
|
|
|
|
|
|
In order to build sample program 'simple.c' from the docs\examples
|
|
|
|
subdirectory run following command from mentioned subdirectory:
|
|
|
|
|
|
|
|
bcc32 simple.c libcurl.lib cw32mt.lib
|
|
|
|
|
|
|
|
In order to build sample program simplessl.c an SSL enabled libcurl
|
|
|
|
is required, as well as the OpenSSL libeay32.lib and ssleay32.lib
|
|
|
|
libraries.
|
2000-05-22 21:35:35 +04:00
|
|
|
|
2005-01-08 19:35:03 +03:00
|
|
|
|
2008-08-30 08:13:31 +04:00
|
|
|
OTHER MSVC IDEs
|
|
|
|
---------------
|
2005-01-08 19:35:03 +03:00
|
|
|
|
2005-10-30 02:18:58 +04:00
|
|
|
If you use VC++, Borland or similar compilers. Include all lib source
|
|
|
|
files in a static lib "project" (all .c and .h files that is).
|
|
|
|
(you should name it libcurl or similar)
|
2004-01-13 10:58:49 +03:00
|
|
|
|
2005-10-30 02:18:58 +04:00
|
|
|
Make the sources in the src/ drawer be a "win32 console application"
|
|
|
|
project. Name it curl.
|
2005-01-08 19:35:03 +03:00
|
|
|
|
|
|
|
|
2005-10-30 02:18:58 +04:00
|
|
|
Disabling Specific Protocols in Win32 builds
|
|
|
|
--------------------------------------------
|
2005-01-08 19:35:03 +03:00
|
|
|
|
2005-10-30 02:18:58 +04:00
|
|
|
The configure utility, unfortunately, is not available for the Windows
|
|
|
|
environment, therefore, you cannot use the various disable-protocol
|
|
|
|
options of the configure utility on this platform.
|
2005-01-08 19:35:03 +03:00
|
|
|
|
2005-10-30 02:18:58 +04:00
|
|
|
However, you can use the following defines to disable specific
|
|
|
|
protocols:
|
2004-01-13 10:58:49 +03:00
|
|
|
|
2005-10-30 02:18:58 +04:00
|
|
|
HTTP_ONLY disables all protocols except HTTP
|
|
|
|
CURL_DISABLE_FTP disables FTP
|
|
|
|
CURL_DISABLE_LDAP disables LDAP
|
|
|
|
CURL_DISABLE_TELNET disables TELNET
|
|
|
|
CURL_DISABLE_DICT disables DICT
|
|
|
|
CURL_DISABLE_FILE disables FILE
|
2007-07-14 00:09:38 +04:00
|
|
|
CURL_DISABLE_TFTP disables TFTP
|
2008-07-14 16:39:50 +04:00
|
|
|
CURL_DISABLE_HTTP disables HTTP
|
2002-06-14 02:13:46 +04:00
|
|
|
|
2005-10-30 02:18:58 +04:00
|
|
|
If you want to set any of these defines you have the following
|
|
|
|
possibilities:
|
2002-06-14 02:13:46 +04:00
|
|
|
|
2008-07-14 16:39:50 +04:00
|
|
|
- Modify lib/config-win32.h
|
2005-10-30 02:18:58 +04:00
|
|
|
- Modify lib/setup.h
|
|
|
|
- Modify lib/Makefile.vc6
|
|
|
|
- Add defines to Project/Settings/C/C++/General/Preprocessor Definitions
|
2009-05-08 22:55:42 +04:00
|
|
|
in the vc6libcurl.dsw/vc6libcurl.dsp Visual C++ 6 IDE project.
|
2002-06-14 02:13:46 +04:00
|
|
|
|
|
|
|
|
2005-10-30 02:18:58 +04:00
|
|
|
Important static libcurl usage note
|
|
|
|
-----------------------------------
|
2002-06-14 02:13:46 +04:00
|
|
|
|
2005-10-30 02:18:58 +04:00
|
|
|
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.
|
2005-01-08 19:35:03 +03:00
|
|
|
|
|
|
|
|
2000-05-22 21:35:35 +04:00
|
|
|
IBM OS/2
|
|
|
|
========
|
|
|
|
Building under OS/2 is not much different from building under unix.
|
|
|
|
You need:
|
|
|
|
|
|
|
|
- emx 0.9d
|
|
|
|
- GNU make
|
|
|
|
- GNU patch
|
|
|
|
- ksh
|
|
|
|
- GNU bison
|
|
|
|
- GNU file utilities
|
|
|
|
- GNU sed
|
|
|
|
- autoconf 2.13
|
|
|
|
|
|
|
|
If you want to build with OpenSSL or OpenLDAP support, you'll need to
|
|
|
|
download those libraries, too. Dirk Ohme has done some work to port SSL
|
|
|
|
libraries under OS/2, but it looks like he doesn't care about emx. You'll
|
2001-05-04 10:17:01 +04:00
|
|
|
find his patches on: http://come.to/Dirk_Ohme
|
2000-05-22 21:35:35 +04:00
|
|
|
|
|
|
|
If during the linking you get an error about _errno being an undefined
|
|
|
|
symbol referenced from the text segment, you need to add -D__ST_MT_ERRNO__
|
|
|
|
in your definitions.
|
|
|
|
|
|
|
|
If everything seems to work fine but there's no curl.exe, you need to add
|
|
|
|
-Zexe to your linker flags.
|
|
|
|
|
|
|
|
If you're getting huge binaries, probably your makefiles have the -g in
|
|
|
|
CFLAGS.
|
|
|
|
|
2006-08-09 20:10:20 +04:00
|
|
|
|
2001-08-08 11:50:14 +04:00
|
|
|
VMS
|
|
|
|
===
|
|
|
|
(The VMS section is in whole contributed by the friendly Nico Baggus)
|
|
|
|
|
|
|
|
Curl seems to work with FTP & HTTP other protocols are not tested. (the
|
|
|
|
perl http/ftp testing server supplied as testing too cannot work on VMS
|
|
|
|
because vms has no concept of fork(). [ I tried to give it a whack, but
|
|
|
|
thats of no use.
|
|
|
|
|
|
|
|
SSL stuff has not been ported.
|
|
|
|
|
|
|
|
Telnet has about the same issues as for Win32. When the changes for Win32
|
2004-01-09 12:36:07 +03:00
|
|
|
are clear maybe they'll work for VMS too. The basic problem is that select
|
2001-08-08 11:50:14 +04:00
|
|
|
ONLY works for sockets.
|
|
|
|
|
|
|
|
Marked instances of fopen/[f]stat that might become a problem, especially
|
|
|
|
for non stream files. In this regard, the files opened for writing will be
|
|
|
|
created stream/lf and will thus be safe. Just keep in mind that non-binary
|
|
|
|
read/wring from/to files will have a records size limit of 32767 bytes
|
|
|
|
imposed.
|
|
|
|
|
|
|
|
Stat to get the size of the files is again only safe for stream files &
|
|
|
|
fixed record files without implied CC.
|
|
|
|
|
|
|
|
-- My guess is that only allowing access to stream files is the quickest
|
|
|
|
way to get around the most issues. Therefore all files need to to be
|
|
|
|
checked to be sure they will be stream/lf before processing them. This is
|
|
|
|
the easiest way out, I know. The reason for this is that code that needs to
|
|
|
|
report the filesize will become a pain in the ass otherwise.
|
|
|
|
|
|
|
|
Exit status.... Well we needed something done here,
|
|
|
|
|
|
|
|
VMS has a structured exist status:
|
|
|
|
| 3 | 2 | 1 | 0|
|
|
|
|
|1098|765432109876|5432109876543|210|
|
|
|
|
+----+------------+-------------+---+
|
|
|
|
|Ctrl| Facility | Error code |sev|
|
|
|
|
+----+------------+-------------+---+
|
|
|
|
|
|
|
|
With the Ctrl-bits an application can tell if part or the whole message has
|
2004-12-11 00:55:05 +03:00
|
|
|
already been printed from the program, DCL doesn't need to print it again.
|
2001-08-08 11:50:14 +04:00
|
|
|
|
2004-12-11 00:55:05 +03:00
|
|
|
Facility - basically the program ID. A code assigned to the program
|
2001-08-08 11:50:14 +04:00
|
|
|
the name can be fetched from external or internal message libraries
|
2007-08-14 21:23:32 +04:00
|
|
|
Error code - the err codes assigned by the application
|
2001-08-08 11:50:14 +04:00
|
|
|
Sev. - severity: Even = error, off = non error
|
2004-07-11 17:49:52 +04:00
|
|
|
0 = Warning
|
|
|
|
1 = Success
|
|
|
|
2 = Error
|
|
|
|
3 = Information
|
2005-01-08 19:35:03 +03:00
|
|
|
4 = Fatal
|
2004-07-11 17:49:52 +04:00
|
|
|
<5-7> reserved.
|
2001-08-08 11:50:14 +04:00
|
|
|
|
|
|
|
This all presents itself with:
|
2007-08-14 21:23:32 +04:00
|
|
|
%<FACILITY>-<Sev>-<Errorname>, <Error message>
|
2001-08-08 11:50:14 +04:00
|
|
|
|
|
|
|
See also the src/curlmsg.msg file, it has the source for the messages In
|
|
|
|
src/main.c a section is devoted to message status values, the globalvalues
|
|
|
|
create symbols with certain values, referenced from a compiled message
|
|
|
|
file. Have all exit function use a exit status derived from a translation
|
|
|
|
table with the compiled message codes.
|
|
|
|
|
|
|
|
This was all compiled with:
|
|
|
|
|
2004-07-11 17:49:52 +04:00
|
|
|
Compaq C V6.2-003 on OpenVMS Alpha V7.1-1H2
|
2001-08-08 11:50:14 +04:00
|
|
|
|
|
|
|
So far for porting notes as of:
|
|
|
|
13-jul-2001
|
|
|
|
N. Baggus
|
|
|
|
|
2006-08-09 20:10:20 +04:00
|
|
|
|
2002-01-07 18:14:01 +03:00
|
|
|
QNX
|
|
|
|
===
|
|
|
|
(This section was graciously brought to us by David Bentham)
|
|
|
|
|
2004-12-11 00:55:05 +03:00
|
|
|
As QNX is targeted for resource constrained environments, the QNX headers
|
2002-01-09 02:27:42 +03:00
|
|
|
set conservative limits. This includes the FD_SETSIZE macro, set by default
|
|
|
|
to 32. Socket descriptors returned within the CURL library may exceed this,
|
|
|
|
resulting in memory faults/SIGSEGV crashes when passed into select(..)
|
|
|
|
calls using fd_set macros.
|
|
|
|
|
|
|
|
A good all-round solution to this is to override the default when building
|
|
|
|
libcurl, by overriding CFLAGS during configure, example
|
|
|
|
# configure CFLAGS='-DFD_SETSIZE=64 -g -O2'
|
2002-01-07 18:14:01 +03:00
|
|
|
|
2001-10-24 15:54:42 +04:00
|
|
|
|
2003-02-28 16:10:54 +03:00
|
|
|
RISC OS
|
|
|
|
=======
|
|
|
|
The library can be cross-compiled using gccsdk as follows:
|
|
|
|
|
|
|
|
CC=riscos-gcc AR=riscos-ar RANLIB='riscos-ar -s' ./configure \
|
|
|
|
--host=arm-riscos-aof --without-random --disable-shared
|
|
|
|
make
|
|
|
|
|
|
|
|
where riscos-gcc and riscos-ar are links to the gccsdk tools.
|
|
|
|
You can then link your program with curl/lib/.libs/libcurl.a
|
|
|
|
|
2003-12-16 17:51:58 +03:00
|
|
|
|
|
|
|
AmigaOS
|
|
|
|
=======
|
|
|
|
(This section was graciously brought to us by Diego Casorran)
|
|
|
|
|
|
|
|
To build cURL/libcurl on AmigaOS just type 'make amiga' ...
|
|
|
|
|
|
|
|
What you need is: (not tested with others versions)
|
|
|
|
|
|
|
|
GeekGadgets / gcc 2.95.3 (http://www.geekgadgets.org/)
|
|
|
|
|
|
|
|
AmiTCP SDK v4.3 (http://www.aminet.net/comm/tcp/AmiTCP-SDK-4.3.lha)
|
|
|
|
|
|
|
|
Native Developer Kit (http://www.amiga.com/3.9/download/NDK3.9.lha)
|
|
|
|
|
|
|
|
As no ixemul.library is required you will be able to build it for
|
|
|
|
WarpOS/PowerPC (not tested by me), as well a MorphOS version should be
|
|
|
|
possible with no problems.
|
|
|
|
|
|
|
|
To enable SSL support, you need a OpenSSL native version (without ixemul),
|
|
|
|
you can find a precompiled package at http://amiga.sourceforge.net/OpenSSL/
|
|
|
|
|
|
|
|
|
2004-07-05 04:55:48 +04:00
|
|
|
NetWare
|
|
|
|
=======
|
|
|
|
To compile curl.nlm / libcurl.nlm you need:
|
|
|
|
- either any gcc / nlmconv, or CodeWarrior 7 PDK 4 or later.
|
2004-07-12 15:29:36 +04:00
|
|
|
- gnu make and awk running on the platform you compile on;
|
|
|
|
native Win32 versions can be downloaded from:
|
2006-08-09 03:37:11 +04:00
|
|
|
http://www.gknw.net/development/prgtools/
|
2004-12-11 00:55:05 +03:00
|
|
|
- recent Novell LibC SDK available from:
|
2004-07-05 04:55:48 +04:00
|
|
|
http://developer.novell.com/ndk/libc.htm
|
2007-07-01 16:09:25 +04:00
|
|
|
- or recent Novell CLib SDK available from:
|
|
|
|
http://developer.novell.com/ndk/clib.htm
|
2007-08-14 20:43:52 +04:00
|
|
|
- optional recent Novell CLDAP SDK available from:
|
|
|
|
http://developer.novell.com/ndk/cldap.htm
|
2007-07-01 16:09:25 +04:00
|
|
|
- optional zlib sources (static or dynamic linking with zlib.imp);
|
2004-12-11 00:55:05 +03:00
|
|
|
sources with NetWare Makefile can be obtained from:
|
2006-08-09 03:37:11 +04:00
|
|
|
http://www.gknw.net/mirror/zlib/
|
2007-07-01 16:09:25 +04:00
|
|
|
- optional OpenSSL sources (version 0.9.8 or later build with BSD sockets);
|
|
|
|
you can find precompiled packages at:
|
|
|
|
http://www.gknw.net/development/ossl/netware/
|
2009-07-14 18:01:11 +04:00
|
|
|
for CLIB-based builds OpenSSL 0.9.8h or later is required - earlier versions
|
|
|
|
dont support buildunf with CLIB BSD sockets.
|
2007-08-14 20:43:52 +04:00
|
|
|
- optional SSH2 sources (version 0.17 or later);
|
2005-08-18 20:33:45 +04:00
|
|
|
|
|
|
|
Set a search path to your compiler, linker and tools; on Linux make
|
2007-07-01 16:09:25 +04:00
|
|
|
sure that the var OSTYPE contains the string 'linux'; set the var
|
|
|
|
NDKBASE to point to the base of your Novell NDK; and then type
|
2007-08-14 21:23:32 +04:00
|
|
|
'make netware' from the top source directory; other targets available
|
2005-08-18 20:33:45 +04:00
|
|
|
are 'netware-ssl', 'netware-ssl-zlib', 'netware-zlib' and 'netware-ares';
|
|
|
|
if you need other combinations you can control the build with the
|
2007-07-01 16:09:25 +04:00
|
|
|
environment variables WITH_SSL, WITH_ZLIB, WITH_ARES, WITH_SSH2, and
|
|
|
|
ENABLE_IPV6; you can set LINK_STATIC=1 to link curl.nlm statically.
|
2007-08-14 20:43:52 +04:00
|
|
|
By default LDAP support is enabled, however currently you will need a patch
|
|
|
|
in order to use the CLDAP NDK with BSD sockets (Novell Bug 300237):
|
|
|
|
http://www.gknw.net/test/curl/cldap_ndk/ldap_ndk.diff
|
2007-08-14 21:23:32 +04:00
|
|
|
I found on some Linux systems (RH9) that OS detection didn't work although
|
2004-07-05 06:20:20 +04:00
|
|
|
a 'set | grep OSTYPE' shows the var present and set; I simply overwrote it
|
2005-08-18 20:33:45 +04:00
|
|
|
with 'OSTYPE=linux-rh9-gnu' and the detection in the Makefile worked...
|
2004-07-05 04:55:48 +04:00
|
|
|
Any help in testing appreciated!
|
2010-04-11 13:38:11 +04:00
|
|
|
Builds automatically created 8 times a day from current git are here:
|
2006-08-09 03:37:11 +04:00
|
|
|
http://www.gknw.net/mirror/curl/autobuilds/
|
2004-12-11 00:55:05 +03:00
|
|
|
the status of these builds can be viewed at the autobuild table:
|
2004-07-05 04:55:48 +04:00
|
|
|
http://curl.haxx.se/auto/
|
|
|
|
|
|
|
|
|
2006-08-09 20:10:20 +04:00
|
|
|
eCos
|
|
|
|
====
|
|
|
|
curl does not use the eCos build system, so you must first build eCos
|
|
|
|
separately, then link curl to the resulting eCos library. Here's a sample
|
|
|
|
configure line to do so on an x86 Linux box targeting x86:
|
|
|
|
|
|
|
|
GCCLIB=`gcc -print-libgcc-file-name` && \
|
|
|
|
CFLAGS="-D__ECOS=1 -nostdinc -I$ECOS_INSTALL/include \
|
|
|
|
-I`dirname $GCCLIB`/include" \
|
|
|
|
LDFLAGS="-nostdlib -Wl,--gc-sections -Wl,-static \
|
|
|
|
-L$ECOS_INSTALL/lib -Ttarget.ld -ltarget" \
|
|
|
|
./configure --host=i386 --disable-shared \
|
|
|
|
--without-ssl --without-zlib --disable-manual --disable-ldap
|
|
|
|
|
|
|
|
In most cases, eCos users will be using libcurl from within a custom
|
|
|
|
embedded application. Using the standard 'curl' executable from
|
|
|
|
within eCos means facing the limitation of the standard eCos C
|
|
|
|
startup code which does not allow passing arguments in main(). To
|
|
|
|
run 'curl' from eCos and have it do something useful, you will need
|
|
|
|
to either modify the eCos startup code to pass in some arguments, or
|
|
|
|
modify the curl application itself to retrieve its arguments from
|
|
|
|
some location set by the bootloader or hard-code them.
|
|
|
|
|
|
|
|
Something like the following patch could be used to hard-code some
|
|
|
|
arguments. The MTAB_ENTRY line mounts a RAM disk as the root filesystem
|
|
|
|
(without mounting some kind of filesystem, eCos errors out all file
|
|
|
|
operations which curl does not take to well). The next section synthesizes
|
|
|
|
some command-line arguments for curl to use, in this case to direct curl
|
|
|
|
to read further arguments from a file. It then creates that file on the
|
|
|
|
RAM disk and places within it a URL to download: a file: URL that
|
|
|
|
just happens to point to the configuration file itself. The results
|
|
|
|
of running curl in this way is the contents of the configuration file
|
|
|
|
printed to the console.
|
|
|
|
|
2010-02-16 16:32:45 +03:00
|
|
|
--- src/main.c 19 Jul 2006 19:09:56 -0000 1.363
|
|
|
|
+++ src/main.c 24 Jul 2006 21:37:23 -0000
|
2006-08-09 20:10:20 +04:00
|
|
|
@@ -4286,11 +4286,31 @@
|
|
|
|
}
|
2010-02-14 22:40:18 +03:00
|
|
|
|
|
|
|
|
2006-08-09 20:10:20 +04:00
|
|
|
+#ifdef __ECOS
|
|
|
|
+#include <cyg/fileio/fileio.h>
|
|
|
|
+MTAB_ENTRY( testfs_mte1,
|
|
|
|
+ "/",
|
|
|
|
+ "ramfs",
|
|
|
|
+ "",
|
|
|
|
+ 0);
|
|
|
|
+#endif
|
2010-02-14 22:40:18 +03:00
|
|
|
|
2006-08-09 20:10:20 +04:00
|
|
|
int main(int argc, char *argv[])
|
|
|
|
{
|
|
|
|
int res;
|
|
|
|
struct Configurable config;
|
|
|
|
+#ifdef __ECOS
|
|
|
|
+ char *args[] = {"ecos-curl", "-K", "curlconf.txt"};
|
|
|
|
+ FILE *f;
|
|
|
|
+ argc = sizeof(args)/sizeof(args[0]);
|
|
|
|
+ argv = args;
|
|
|
|
+
|
|
|
|
+ f = fopen("curlconf.txt", "w");
|
|
|
|
+ if (f) {
|
|
|
|
+ fprintf(f, "--url file:curlconf.txt");
|
|
|
|
+ fclose(f);
|
|
|
|
+ }
|
|
|
|
+#endif
|
|
|
|
memset(&config, 0, sizeof(struct Configurable));
|
2010-02-14 22:40:18 +03:00
|
|
|
|
2006-08-09 20:10:20 +04:00
|
|
|
config.errors = stderr; /* default errors to stderr */
|
|
|
|
|
|
|
|
|
|
|
|
Minix
|
|
|
|
=====
|
2007-05-17 10:04:44 +04:00
|
|
|
curl can be compiled on Minix 3 using gcc or ACK (starting with
|
2009-10-06 10:54:46 +04:00
|
|
|
ver. 3.1.3). Ensure that GNU gawk and bash are both installed and
|
|
|
|
available in the PATH.
|
2010-02-14 22:40:18 +03:00
|
|
|
|
2007-09-02 01:21:52 +04:00
|
|
|
ACK
|
|
|
|
---
|
2008-07-23 22:17:25 +04:00
|
|
|
Increase the heap sizes of the compiler with the command:
|
2007-09-02 01:21:52 +04:00
|
|
|
|
2008-07-23 22:17:25 +04:00
|
|
|
binsizes xxl
|
2007-09-02 01:21:52 +04:00
|
|
|
|
2009-10-06 10:54:46 +04:00
|
|
|
then configure and compile curl with:
|
2007-09-02 01:21:52 +04:00
|
|
|
|
2009-10-06 10:54:46 +04:00
|
|
|
./configure CC=cc LD=cc AR=/usr/bin/aal GREP=grep \
|
|
|
|
CPPFLAGS='-D_POSIX_SOURCE=1 -I/usr/local/include'
|
2007-09-02 01:21:52 +04:00
|
|
|
make
|
2009-01-15 11:49:22 +03:00
|
|
|
chmem =256000 src/curl
|
2007-09-02 01:21:52 +04:00
|
|
|
|
|
|
|
GCC
|
|
|
|
---
|
|
|
|
Make sure gcc is in your PATH with the command:
|
2010-02-14 22:40:18 +03:00
|
|
|
|
2007-05-17 10:04:44 +04:00
|
|
|
export PATH=/usr/gnu/bin:$PATH
|
2010-02-14 22:40:18 +03:00
|
|
|
|
2007-09-02 01:21:52 +04:00
|
|
|
then configure and compile curl with:
|
2006-08-09 20:10:20 +04:00
|
|
|
|
2009-10-06 10:54:46 +04:00
|
|
|
./configure CC=gcc AR=/usr/gnu/bin/gar GREP=grep
|
2007-05-17 10:04:44 +04:00
|
|
|
make
|
2009-01-15 11:49:22 +03:00
|
|
|
chmem =256000 src/curl
|
2007-05-17 10:04:44 +04:00
|
|
|
|
2006-08-09 20:10:20 +04:00
|
|
|
|
2008-04-23 02:53:53 +04:00
|
|
|
Symbian OS
|
|
|
|
==========
|
|
|
|
The Symbian OS port uses the Symbian build system to compile. From the
|
|
|
|
packages/Symbian/group/ directory, run:
|
|
|
|
|
|
|
|
bldmake bldfiles
|
|
|
|
abld build
|
|
|
|
|
2009-10-06 10:54:46 +04:00
|
|
|
to compile and install curl and libcurl using SBSv1. If your Symbian
|
|
|
|
SDK doesn't include support for P.I.P.S., you will need to contact
|
|
|
|
your SDK vendor to obtain that first.
|
2008-04-23 02:53:53 +04:00
|
|
|
|
|
|
|
|
2009-06-08 19:49:40 +04:00
|
|
|
VxWorks
|
|
|
|
========
|
|
|
|
Build for VxWorks is performed using cross compilation.
|
2010-02-14 22:40:18 +03:00
|
|
|
That means you build on Windows machine using VxWorks tools and
|
2009-06-08 19:49:40 +04:00
|
|
|
run the built image on the VxWorks device.
|
2010-02-14 22:40:18 +03:00
|
|
|
|
2009-06-08 19:49:40 +04:00
|
|
|
To build libcurl for VxWorks you need:
|
2010-02-14 22:40:18 +03:00
|
|
|
|
2009-06-08 19:49:40 +04:00
|
|
|
- CYGWIN (free, http://cygwin.com/)
|
|
|
|
- Wind River Workbench (commercial)
|
|
|
|
|
|
|
|
If you have CYGWIN and Workbench installed on you machine
|
|
|
|
follow after next steps:
|
|
|
|
|
|
|
|
1. Open the Command Prompt window and change directory ('cd')
|
|
|
|
to the libcurl 'lib' folder.
|
|
|
|
2. Add CYGWIN 'bin' folder to the PATH environment variable.
|
|
|
|
For example, type 'set PATH=C:/embedded/cygwin/bin;%PATH%'.
|
|
|
|
3. Adjust environment variables defined in 'Environment' section
|
|
|
|
of the Makefile.vxworks file to point to your software folders.
|
|
|
|
4. Build the libcurl by typing 'make -f ./Makefile.vxworks'
|
2010-02-14 22:40:18 +03:00
|
|
|
|
|
|
|
As a result the libcurl.a library should be created in the 'lib' folder.
|
2009-06-08 19:49:40 +04:00
|
|
|
To clean the build results type 'make -f ./Makefile.vxworks clean'.
|
2010-02-14 22:40:18 +03:00
|
|
|
|
2009-06-08 19:49:40 +04:00
|
|
|
|
2010-07-10 03:11:36 +04:00
|
|
|
Android
|
|
|
|
=======
|
|
|
|
See the build notes in the Android.mk file.
|
|
|
|
|
|
|
|
|
2004-12-11 00:55:05 +03:00
|
|
|
CROSS COMPILE
|
|
|
|
=============
|
|
|
|
(This section was graciously brought to us by Jim Duey, with additions by
|
|
|
|
Dan Fandrich)
|
|
|
|
|
2008-07-23 22:17:25 +04:00
|
|
|
Download and unpack the cURL package.
|
2004-12-11 00:55:05 +03:00
|
|
|
|
|
|
|
'cd' to the new directory. (e.g. cd curl-7.12.3)
|
|
|
|
|
|
|
|
Set environment variables to point to the cross-compile toolchain and call
|
|
|
|
configure with any options you need. Be sure and specify the '--host' and
|
|
|
|
'--build' parameters at configuration time. The following script is an
|
|
|
|
example of cross-compiling for the IBM 405GP PowerPC processor using the
|
|
|
|
toolchain from MonteVista for Hardhat Linux.
|
|
|
|
|
|
|
|
(begin script)
|
|
|
|
|
|
|
|
#! /bin/sh
|
|
|
|
|
|
|
|
export PATH=$PATH:/opt/hardhat/devkit/ppc/405/bin
|
|
|
|
export CPPFLAGS="-I/opt/hardhat/devkit/ppc/405/target/usr/include"
|
|
|
|
export AR=ppc_405-ar
|
|
|
|
export AS=ppc_405-as
|
|
|
|
export LD=ppc_405-ld
|
|
|
|
export RANLIB=ppc_405-ranlib
|
|
|
|
export CC=ppc_405-gcc
|
|
|
|
export NM=ppc_405-nm
|
|
|
|
|
|
|
|
./configure --target=powerpc-hardhat-linux \
|
2010-02-16 16:32:45 +03:00
|
|
|
--host=powerpc-hardhat-linux \
|
|
|
|
--build=i586-pc-linux-gnu \
|
|
|
|
--prefix=/opt/hardhat/devkit/ppc/405/target/usr/local \
|
|
|
|
--exec-prefix=/usr/local
|
2004-12-11 00:55:05 +03:00
|
|
|
|
|
|
|
(end script)
|
|
|
|
|
|
|
|
You may also need to provide a parameter like '--with-random=/dev/urandom'
|
|
|
|
to configure as it cannot detect the presence of a random number
|
|
|
|
generating device for a target system. The '--prefix' parameter
|
|
|
|
specifies where cURL will be installed. If 'configure' completes
|
|
|
|
successfully, do 'make' and 'make install' as usual.
|
|
|
|
|
|
|
|
In some cases, you may be able to simplify the above commands to as
|
|
|
|
little as:
|
|
|
|
|
|
|
|
./configure --host=ARCH-OS
|
|
|
|
|
2006-08-09 20:10:20 +04:00
|
|
|
|
2006-06-13 00:33:04 +04:00
|
|
|
REDUCING SIZE
|
|
|
|
=============
|
2004-12-11 00:55:05 +03:00
|
|
|
There are a number of configure options that can be used to reduce the
|
|
|
|
size of libcurl for embedded applications where binary size is an
|
2006-06-13 00:33:04 +04:00
|
|
|
important factor. First, be sure to set the CFLAGS variable when
|
|
|
|
configuring with any relevant compiler optimization flags to reduce the
|
2008-03-31 07:01:13 +04:00
|
|
|
size of the binary. For gcc, this would mean at minimum the -Os option,
|
2008-07-23 22:17:25 +04:00
|
|
|
and potentially the -march=X and -mdynamic-no-pic options as well, e.g.
|
2004-12-11 00:55:05 +03:00
|
|
|
|
2006-06-13 00:33:04 +04:00
|
|
|
./configure CFLAGS='-Os' ...
|
2004-12-11 00:55:05 +03:00
|
|
|
|
2007-10-16 01:03:40 +04:00
|
|
|
Note that newer compilers often produce smaller code than older versions
|
2008-07-23 22:17:25 +04:00
|
|
|
due to improved optimization.
|
2007-10-16 01:03:40 +04:00
|
|
|
|
2004-12-11 00:55:05 +03:00
|
|
|
Be sure to specify as many --disable- and --without- flags on the configure
|
|
|
|
command-line as you can to disable all the libcurl features that you
|
|
|
|
know your application is not going to need. Besides specifying the
|
|
|
|
--disable-PROTOCOL flags for all the types of URLs your application
|
|
|
|
will not use, here are some other flags that can reduce the size of the
|
|
|
|
library:
|
|
|
|
|
2008-10-08 00:28:25 +04:00
|
|
|
--disable-ares (disables support for the C-ARES DNS library)
|
2004-12-11 00:55:05 +03:00
|
|
|
--disable-cookies (disables support for HTTP cookies)
|
|
|
|
--disable-crypto-auth (disables HTTP cryptographic authentication)
|
|
|
|
--disable-ipv6 (disables support for IPv6)
|
2008-10-08 00:28:25 +04:00
|
|
|
--disable-manual (disables support for the built-in documentation)
|
|
|
|
--disable-proxy (disables support for HTTP and SOCKS proxies)
|
2004-12-11 00:55:05 +03:00
|
|
|
--disable-verbose (eliminates debugging strings and error code strings)
|
2006-08-09 20:10:20 +04:00
|
|
|
--enable-hidden-symbols (eliminates unneeded symbols in the shared library)
|
2004-12-11 00:55:05 +03:00
|
|
|
--without-libidn (disables support for the libidn DNS library)
|
|
|
|
--without-ssl (disables support for SSL/TLS)
|
|
|
|
--without-zlib (disables support for on-the-fly decompression)
|
|
|
|
|
2008-11-15 02:19:18 +03:00
|
|
|
The GNU compiler and linker have a number of options that can reduce the
|
|
|
|
size of the libcurl dynamic libraries on some platforms even further.
|
|
|
|
Specify them by providing appropriate CFLAGS and LDFLAGS variables on the
|
|
|
|
configure command-line:
|
|
|
|
CFLAGS="-ffunction-sections -fdata-sections" \
|
|
|
|
LDFLAGS="-Wl,-s -Wl,-Bsymbolic -Wl,--gc-sections"
|
|
|
|
|
2006-06-13 00:33:04 +04:00
|
|
|
Be sure also to strip debugging symbols from your binaries after
|
|
|
|
compiling using 'strip' (or the appropriate variant if cross-compiling).
|
|
|
|
If space is really tight, you may be able to remove some unneeded
|
2006-08-09 20:10:20 +04:00
|
|
|
sections of the shared library using the -R option to objcopy (e.g. the
|
2006-06-13 00:33:04 +04:00
|
|
|
.comment section).
|
|
|
|
|
2008-10-23 01:36:37 +04:00
|
|
|
Using these techniques it is possible to create a basic HTTP-only shared
|
2010-01-26 02:28:09 +03:00
|
|
|
libcurl library for i386 Linux platforms that is only 98 KiB in size, and
|
|
|
|
an FTP-only library that is 94 KiB in size (as of libcurl version 7.20.0,
|
|
|
|
using gcc 4.3.3).
|
2006-06-13 00:33:04 +04:00
|
|
|
|
2004-12-11 00:55:05 +03:00
|
|
|
You may find that statically linking libcurl to your application will
|
2008-10-23 01:36:37 +04:00
|
|
|
result in a lower total size than dynamically linking.
|
2004-12-11 00:55:05 +03:00
|
|
|
|
2008-10-08 00:28:25 +04:00
|
|
|
Note that the curl test harness can detect the use of some, but not all, of
|
|
|
|
the --disable statements suggested above. Use will cause tests relying on
|
|
|
|
those features to fail. The test harness can be manually forced to skip
|
|
|
|
the relevant tests by specifying certain key words on the runtests.pl
|
|
|
|
command line. Following is a list of appropriate key words:
|
|
|
|
|
|
|
|
--disable-cookies !cookies
|
2008-10-23 01:36:37 +04:00
|
|
|
--disable-crypto-auth !HTTP\ Digest\ auth !HTTP\ proxy\ Digest\ auth
|
2008-10-08 00:28:25 +04:00
|
|
|
--disable-manual !--manual
|
2008-10-23 01:36:37 +04:00
|
|
|
--disable-proxy !HTTP\ proxy !proxytunnel !SOCKS4 !SOCKS5
|
2008-10-08 00:28:25 +04:00
|
|
|
|
2004-12-11 00:55:05 +03:00
|
|
|
|
2000-11-27 16:39:11 +03:00
|
|
|
PORTS
|
|
|
|
=====
|
2001-08-06 14:09:43 +04:00
|
|
|
This is a probably incomplete list of known hardware and operating systems
|
2002-04-24 14:15:37 +04:00
|
|
|
that curl has been compiled for. If you know a system curl compiles and
|
2001-12-06 15:48:41 +03:00
|
|
|
runs on, that isn't listed, please let us know!
|
2000-11-27 16:39:11 +03:00
|
|
|
|
|
|
|
- Alpha DEC OSF 4
|
|
|
|
- Alpha Digital UNIX v3.2
|
2002-04-24 14:15:37 +04:00
|
|
|
- Alpha FreeBSD 4.1, 4.5
|
|
|
|
- Alpha Linux 2.2, 2.4
|
|
|
|
- Alpha NetBSD 1.5.2
|
2002-04-26 16:58:07 +04:00
|
|
|
- Alpha OpenBSD 3.0
|
2001-08-06 14:09:43 +04:00
|
|
|
- Alpha OpenVMS V7.1-1H2
|
2000-11-27 16:39:11 +03:00
|
|
|
- Alpha Tru64 v5.0 5.1
|
2008-10-23 01:36:37 +04:00
|
|
|
- AVR32 Linux
|
2010-07-10 03:11:36 +04:00
|
|
|
- ARM Android 1.5, 2.1
|
2008-11-15 02:19:18 +03:00
|
|
|
- ARM INTEGRITY
|
2008-12-01 01:51:54 +03:00
|
|
|
- ARM iPhone OS
|
2008-11-15 02:19:18 +03:00
|
|
|
- Cell Linux
|
2008-11-18 00:41:03 +03:00
|
|
|
- Cell Cell OS
|
2000-11-27 16:39:11 +03:00
|
|
|
- HP-PA HP-UX 9.X 10.X 11.X
|
2001-11-22 16:03:11 +03:00
|
|
|
- HP-PA Linux
|
2004-02-02 18:34:09 +03:00
|
|
|
- HP3000 MPE/iX
|
2008-11-18 00:43:39 +03:00
|
|
|
- MicroBlaze uClinux
|
2000-11-27 16:39:11 +03:00
|
|
|
- MIPS IRIX 6.2, 6.5
|
2001-11-22 16:03:11 +03:00
|
|
|
- MIPS Linux
|
2007-08-23 21:26:42 +04:00
|
|
|
- OS/400
|
2002-03-06 15:33:34 +03:00
|
|
|
- Pocket PC/Win CE 3.0
|
2005-05-09 17:26:41 +04:00
|
|
|
- Power AIX 3.2.5, 4.2, 4.3.1, 4.3.2, 5.1, 5.2
|
2000-11-27 16:39:11 +03:00
|
|
|
- PowerPC Darwin 1.0
|
2008-07-02 01:53:47 +04:00
|
|
|
- PowerPC INTEGRITY
|
2000-11-27 16:39:11 +03:00
|
|
|
- PowerPC Linux
|
2001-11-22 16:03:11 +03:00
|
|
|
- PowerPC Mac OS 9
|
2000-11-27 16:39:11 +03:00
|
|
|
- PowerPC Mac OS X
|
2008-05-01 01:32:35 +04:00
|
|
|
- SH4 Linux 2.6.X
|
|
|
|
- SH4 OS21
|
2001-10-24 18:16:57 +04:00
|
|
|
- SINIX-Z v5
|
2000-11-27 16:39:11 +03:00
|
|
|
- Sparc Linux
|
2005-05-09 17:26:41 +04:00
|
|
|
- Sparc Solaris 2.4, 2.5, 2.5.1, 2.6, 7, 8, 9, 10
|
2001-01-11 15:33:26 +03:00
|
|
|
- Sparc SunOS 4.1.X
|
2001-10-24 18:16:57 +04:00
|
|
|
- StrongARM (and other ARM) RISC OS 3.1, 4.02
|
2005-06-23 02:30:52 +04:00
|
|
|
- StrongARM/ARM7/ARM9 Linux 2.4, 2.6
|
2001-10-24 18:16:57 +04:00
|
|
|
- StrongARM NetBSD 1.4.1
|
2008-07-23 22:17:25 +04:00
|
|
|
- Symbian OS (P.I.P.S.) 9.x
|
2007-08-23 21:26:42 +04:00
|
|
|
- TPF
|
2001-10-24 18:16:57 +04:00
|
|
|
- Ultrix 4.3a
|
2006-08-16 22:48:27 +04:00
|
|
|
- UNICOS 9.0
|
2000-11-27 16:39:11 +03:00
|
|
|
- i386 BeOS
|
2003-05-27 11:37:34 +04:00
|
|
|
- i386 DOS
|
2006-08-09 20:10:20 +04:00
|
|
|
- i386 eCos 1.3.1
|
2004-12-11 00:55:05 +03:00
|
|
|
- i386 Esix 4.1
|
2000-11-27 16:39:11 +03:00
|
|
|
- i386 FreeBSD
|
2001-12-06 10:11:33 +03:00
|
|
|
- i386 HURD
|
2008-05-26 19:06:51 +04:00
|
|
|
- i386 Haiku OS
|
2005-05-09 17:26:41 +04:00
|
|
|
- i386 Linux 1.3, 2.0, 2.2, 2.3, 2.4, 2.6
|
2007-05-17 10:04:44 +04:00
|
|
|
- i386 MINIX 3.1
|
2000-11-27 16:39:11 +03:00
|
|
|
- i386 NetBSD
|
2004-03-17 15:46:42 +03:00
|
|
|
- i386 Novell NetWare
|
2000-11-27 16:39:11 +03:00
|
|
|
- i386 OS/2
|
|
|
|
- i386 OpenBSD
|
2008-05-26 19:06:51 +04:00
|
|
|
- i386 QNX 6
|
2001-01-11 15:33:26 +03:00
|
|
|
- i386 SCO unix
|
2000-11-27 16:39:11 +03:00
|
|
|
- i386 Solaris 2.7
|
2005-05-09 17:26:41 +04:00
|
|
|
- i386 Windows 95, 98, ME, NT, 2000, XP, 2003
|
2003-04-30 11:32:43 +04:00
|
|
|
- i486 ncr-sysv4.3.03 (NCR MP-RAS)
|
2000-11-27 16:39:11 +03:00
|
|
|
- ia64 Linux 2.3.99
|
|
|
|
- m68k AmigaOS 3
|
2001-11-22 16:03:11 +03:00
|
|
|
- m68k Linux
|
2008-01-26 01:10:10 +03:00
|
|
|
- m68k uClinux
|
2000-11-27 16:39:11 +03:00
|
|
|
- m68k OpenBSD
|
2003-04-30 11:32:43 +04:00
|
|
|
- m88k dg-dgux5.4R3.00
|
2005-01-08 19:35:03 +03:00
|
|
|
- s390 Linux
|
2008-11-15 02:19:18 +03:00
|
|
|
- x86_64 Linux
|
2003-02-05 11:09:33 +03:00
|
|
|
- XScale/PXA250 Linux 2.4
|
2008-01-26 01:10:10 +03:00
|
|
|
- Nios II uClinux
|
2000-11-27 16:39:11 +03:00
|
|
|
|
2004-08-13 15:56:15 +04:00
|
|
|
Useful URLs
|
|
|
|
===========
|
2004-08-13 15:53:33 +04:00
|
|
|
|
2010-08-24 02:07:14 +04:00
|
|
|
c-ares http://daniel.haxx.se/projects/c-ares/license.html
|
|
|
|
GNU GSS http://www.gnu.org/software/gss/
|
|
|
|
GnuTLS http://www.gnu.org/software/gnutls/
|
|
|
|
Heimdal http://www.pdc.kth.se/heimdal/
|
|
|
|
libidn http://www.gnu.org/software/libidn/
|
|
|
|
libssh2 http://www.libssh2.org
|
2004-08-13 15:56:15 +04:00
|
|
|
MingW http://www.mingw.org
|
2010-08-24 02:07:14 +04:00
|
|
|
MIT Kerberos http://web.mit.edu/kerberos/www/dist/
|
|
|
|
NSS http://www.mozilla.org/projects/security/pki/nss/
|
2004-08-13 15:56:15 +04:00
|
|
|
OpenLDAP http://www.openldap.org
|
2010-08-24 02:07:14 +04:00
|
|
|
OpenSSL http://www.openssl.org
|
|
|
|
PolarSSL http://polarssl.org
|
|
|
|
yassl http://www.yassl.com/
|
2004-08-13 15:56:15 +04:00
|
|
|
Zlib http://www.gzip.org/zlib/
|