diff options
| author | Dan Fandrich <dan@coneharvesters.com> | 2008-10-07 20:28:25 +0000 |
|---|---|---|
| committer | Dan Fandrich <dan@coneharvesters.com> | 2008-10-07 20:28:25 +0000 |
| commit | feeabd08ab66207771825bf0616fb08acb460c37 (patch) | |
| tree | 7bc3c8ea01341a44b71991c20bf04671cd65bd8e /docs/INSTALL | |
| parent | 31a3432a8e16f5c02a1fed267a8a1716ae16c255 (diff) | |
Document how to disable tests when certain --disable-* flags are used.
Diffstat (limited to 'docs/INSTALL')
| -rw-r--r-- | docs/INSTALL | 19 |
1 files changed, 17 insertions, 2 deletions
diff --git a/docs/INSTALL b/docs/INSTALL index 92484ad7d..9634585b2 100644 --- a/docs/INSTALL +++ b/docs/INSTALL @@ -770,10 +770,12 @@ REDUCING SIZE will not use, here are some other flags that can reduce the size of the library: - --disable-ares (disables support for the ARES DNS library) + --disable-ares (disables support for the C-ARES DNS library) --disable-cookies (disables support for HTTP cookies) --disable-crypto-auth (disables HTTP cryptographic authentication) --disable-ipv6 (disables support for IPv6) + --disable-manual (disables support for the built-in documentation) + --disable-proxy (disables support for HTTP and SOCKS proxies) --disable-verbose (eliminates debugging strings and error code strings) --enable-hidden-symbols (eliminates unneeded symbols in the shared library) --without-libidn (disables support for the libidn DNS library) @@ -791,11 +793,24 @@ REDUCING SIZE Using these techniques it is possible to create an HTTP-only shared libcurl library for i386 Linux platforms that is only 96 KiB in size (as of libcurl - version 7.17.1, using gcc 4.2.2). + version pre-7.19.1, using gcc 4.2.2). You may find that statically linking libcurl to your application will result in a lower total size. + 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 + --disable-crypto-auth !HTTP\ Digest\ auth !HTTP\ NTLM\ auth + !HTTP\ proxy\ Digest\ auth + !HTTP\ proxy\ NTLM\ auth + --disable-manual !--manual + --disable-proxy !HTTP\ proxy !SOCKS4 !SOCKS5 + PORTS ===== |