spelling errors corrected

  should be replaced with the name of your debugger, in most cases that will

  be 'gdb', but 'dbx' and others also occur.

  When the debugger has finnished loading the core file and presents you a

  When the debugger has finished loading the core file and presents you a

  prompt, you can give the compiler instructions. Enter 'where' (without the

  quotes) and press return.

  The list that is presented is the stack trace. If everything worked, it is

  supposed to contain the chaing of functions that were called when curl

  supposed to contain the chain of functions that were called when curl

  crashed.

  actually already told me about!

- H. Daphne Luong <daphne@tellme.com> brought me a fix that now makes curl

  ingore select() errors in the download if errno is EINTR, which turns out to

  ignore select() errors in the download if errno is EINTR, which turns out to

  happen every now and then when using libcurl multi-threaded...

Daniel (22 March 2000):

Daniel (21 March 2000):

- Paul Harrington <paul@pizza.org> quickly pointed out to me that 6.5.1

  crashes hard. I upload 6.5.2 now as quickly as possible! The problem was

  the -D adjustments in src/main.c, see also a separate 6.5.1-patch on the

  web site.

  the -D adjustments in src/main.c.

Version 6.5.1

Daniel (20 March 2000):

- An anynomous post on sourceforge correctly pointed out a possible buffer

  overflow in the curl_unescape() function for URL convertions. The main

- An anonymous post on sourceforge correctly pointed out a possible buffer

  overflow in the curl_unescape() function for URL conversions. The main

  problem with this bug is that the ftp download uses that function and this

  single- byte overflow could lead to very odd bugs (as one reported by Janne

  Johansson).

- Wham Bang <wham_bang@yahoo.com> supplied a patch for the lib/Makefile.vc6

  file. We still need some fixes for the config-win32.h since it appears that

  VC++ and mingw32 have different opinions about (at least) unistd.h's

  existance.

  existence.

Daniel (15 March 2000):

- I modified the -D/--dump-header workings so that it doesn't write anything

- Jörn Hartroth <Joern.Hartroth@telekom.de>, Chris <cbayliss@csc.come> and Ulf

  Möller from the openssl development team helped bringing me the details for

  fixing an OpenSSL usage flaw. It became appearant when they released openssl

  0.9.5 since that barfed on curl's bad behaviour (not seeding a random number

  fixing an OpenSSL usage flaw. It became apparent when they released openssl

  0.9.5 since that barfed on curl's bad behavior (not seeding a random number

  thing).

- Yet another option: -N/--no-buffer disables buffering in the output stream.

  Probably most useful for very slow transfers when you really want to get

  every byte curl receives within some prefered time. Andrew <tmr@gci.net>

  every byte curl receives within some preferred time. Andrew <tmr@gci.net>

  suggested this.

- Damien Adant <dams@usa.net> mailed me his fixes for making curl compile

- I added the -w/--write-out flag and some variables to go with it. -w is a

  single string, whatever you enter there will be written out when curl has

  completed a successful request. There are some variable substitutions and

  they are specifed as '%{variable}' (without the quotes). Variables that

  they are specified as '%{variable}' (without the quotes). Variables that

  exist as of this moment are:

        total_time     - total transfer time in seconds (with 2 decimals)

- Eetu Ojanen <esojanen@jyu.fi>'s suggestion of supporting the @-style for -b

  is implemented. Now -b@<filename> works as well as the old style. -b@- also

  similarily reads the cookies from stdin.

  similarly reads the cookies from stdin.

- Reminder: -D should not write to the file until it needs to, in the same way

  -o does. That would enable curl to use -b and -D on the same file...

- Ellis Pritchard <ellis@citria.com> made getdate.y work for MacOS X.

- Paul Harrington <paul@pizza.org> helped me out finding the crash in the

  cookie parser. He also pointed out curl's habbit of sending empty cookies to

  cookie parser. He also pointed out curl's habit of sending empty cookies to

  the server.

Daniel (8 February 2000):

   and let them get "uploaded" in Transfer() as well.

 - Zhibiao Wu <wuzb@erols.com> pointed out a curl bug in the location: area,

   although I did not get a reproducable way to do this why I have to wait

   although I did not get a reproducible way to do this why I have to wait

   with fixing anything.

 - Bob Schader <rschader@product-des.com> suggested I should implement resume

 - Jim Gallagher <jmgallag@usa.net> properly tracked down a bug in autoconf

   2.13. The AC_CHECK_LIB() macro wrongfully uses the -l flag before the -L

   flag to 'ld' which causes the HP-UX 10.20 flavour to fail on all libchecks

   and thefore you can't make the configure script find the openssl libs!

   and therefore you can't make the configure script find the openssl libs!

Daniel (28 December 1999):

 - Tim Verhoeven <dj@walhalla.sin.khk.be> correctly identified that curl

Daniel (27 December 1999):

 - When curl parsed cookies straight off a remote site, it corrupted the input

   data, which, if the downloaded headers were stored made very odd characters

   in the saved data. Correctfully identified and reported by Paul Harrington

   in the saved data. Correctly identified and reported by Paul Harrington

   <paul@pizza.org>.

Daniel (13 December 1999):

 Daniel (8 November 1999):

 - I made the -b/--cookie option capable of reading netscape formatted cookie

   files as well as normal http-header files. It should be able to

   transparantly figure out what kind of file it got as input.

   transparently figure out what kind of file it got as input.

 Daniel (29 October 1999):

 - Another one of Sebastiaan van Erk's ideas (that has been requested before

   makes sense since if you access ftp through a HTTP proxy, you'd get the

   file size the same way.

   I changed the order of the QUOTE command execusions. They're now executed

   I changed the order of the QUOTE command executions. They're now executed

   just after the login and before any other command. I made this to enable

   quote commands to run before the -I stuff is done too.

   OpenSSL. Now why couldn't they simply add a *new* function instead of

   modifying the parameters of an already existing function? This way, we get

   a compiler warning if compiling with 0.9.4 but not with earlier. So, I had

   to come up with a #if contruction that deals with this...

   to come up with a #if construction that deals with this...

 - Made curl output the SSL version number get displayed properly with 0.9.4.

 T. Yamada <tai@imasy.or.jp> (30 July 1999)

 - It breaks with segfault when 1) curl is using .netrc to obtain

   username/password (option '-n'), and 2) is auto-matically redirected to

   username/password (option '-n'), and 2) is automatically redirected to

   another location (option '-L').

   There is a small bug in lib/url.c (block starting from line 641), which

General Style

 Keep your functions small. If they're small you avoid a lot of mistakes and

 you don't accidentaly mix up variables.

 you don't accidentally mix up variables.

Non-clobbering All Over

                                How To Compile

Curl has been compiled and built on numerous different operating systems. The

way to proceed is mainly devided in two different ways: the unix way or the

way to proceed is mainly divided in two different ways: the unix way or the

windows way.

If you're using Windows (95, 98, NT) or OS/2, you should continue reading from

the Win32 header below. All other systems should be capable of being installed

as described un the the UNIX header.

as described in the the UNIX header.

PORTS

=====

   Just to show off, this is a probably incomplete list of known hardware and

   operating systems that curl has been compiled for:

        Sparc Solaris 2.4, 2.5, 2.5.1, 2.6, 7

        Sparc SunOS 4.1.*

        i386 Linux 1.3, 2.0, 2.2

        MIPS IRIX 6.2, 6.5

        HP-PA HP-UX

        - Ultrix

        - SINIX-Z v5

        Alpha DEC OSF 4

        i386 Solaris 2.7

        HP-PA HP-UX

        MIPS IRIX 6.2, 6.5

        Power AIX 4.2, 4.3.1

        PowerPC Mac OS X

        Power AIX 4.3.1

        - Ultrix

        Sparc Solaris 2.4, 2.5, 2.5.1, 2.6, 7

        Sparc SunOS 4.1.*

        i386 FreeBSD

        i386 Linux 1.3, 2.0, 2.2

        i386 NetBSD

        i386 OS/2

        i386 OpenBSD

        m68k OpenBSD

        i386 Solaris 2.7

        i386 Windows 95, 98, NT

        i386 OS/2

        m68k AmigaOS 3

        m68k OpenBSD

UNIX

====

   The configure script *always* tries to find a working SSL library unless

   explicitely told not to.  If you have SSLeay or OpenSSL installed in the

   default search path for your compiler/linker, you don't need to do anything

   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 you have SSLeay or OpenSSL installed in /usr/local/ssl, you can

   run configure like so:

   If you have OpenSSL installed in /usr/local/ssl, you can run configure

   like:

	./configure --with-ssl

   If you have SSLeay or OpenSSL installed somewhere else (for example,

   /opt/OpenSSL,) you can run configure like this:

   If you have OpenSSL installed somewhere else (for example, /opt/OpenSSL,)

   you can run configure like this:

	./configure --with-ssl=/opt/OpenSSL

        ./configure --without-ssl

   If you have SSLeay or OpenSSL installed, but with the libraries in

   one place and the header files somewhere else, you'll have to set the

   LDFLAGS and CPPFLAGS environment variables prior to running configure.

   Something like this should work:

   If you have OpenSSL installed, but with the libraries in one place and the

   header files somewhere else, you'll have to set the LDFLAGS and CPPFLAGS

   environment variables prior to running configure.  Something like this

   should work:

     (with the Bourne shell and its clones):

      Microsoft / Borland style

      -------------------------

        If you have OpenSSL/SSLeay, and want curl to take advantage of it,

        edit your project properties to use the SSL include path, link with

        the SSL libs and define the USE_SSLEAY symbol.

        If you have OpenSSL, and want curl to take advantage of it, edit your

        project properties to use the SSL include path, link with the SSL libs

        and define the USE_SSLEAY symbol.

IBM OS/2

      - GNU sed

      - autoconf 2.13

   If you want to build with OpenSSL, SSLeay, 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 find his patches on: http://come.to/Dirk.Ohme

   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

   find his patches on: http://come.to/Dirk.Ohme

   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__

   If you're getting huge binaries, probably your makefiles have the -g in

   CFLAGS.

OpenSSL/SSLeay

==============

OpenSSL

=======

   You'll find OpenSSL information at: