mirror of
https://github.com/moparisthebest/curl
synced 2024-11-18 07:25:14 -05:00
27302abb94
We're mostly saying just "curl" in lower case these days so here's a big cleanup to adapt to this reality. A few instances are left as the project could still formally be considered called cURL.
115 lines
4.3 KiB
Plaintext
115 lines
4.3 KiB
Plaintext
Curl is a tool for transferring files with URL syntax, supporting
|
|
FTP, FTPS, HTTP, HTTPS, TELNET, DICT, FILE and LDAP.
|
|
Curl supports HTTPS certificates, HTTP POST, HTTP PUT,
|
|
FTP uploading, kerberos, HTTP form based upload, proxies,
|
|
cookies, user+password authentication, file transfer resume,
|
|
http proxy tunneling and a busload of other useful tricks.
|
|
|
|
See /usr/doc/curl-$(VERSION)/FEATURES for more info.
|
|
|
|
|
|
Dependencies:
|
|
- Cygwin
|
|
- OpenSSL 0.9.6b-2+ (*)
|
|
|
|
(*) curl can be built without SSL support, see below for details
|
|
|
|
|
|
Canonical Homepage and Downloads:
|
|
https://curl.haxx.se/
|
|
https://curl.haxx.se/download.html
|
|
|
|
|
|
Cygwin specific source files (a .README template and a Makefile
|
|
for building binary tarballs) are maintained in the upstream
|
|
CVS at: <srctop>/packages/Win32/cygwin/
|
|
|
|
|
|
Build Instructions (to recompile from the cygwin source tarball):
|
|
---STANDARD (with SSL) RELEASE---
|
|
Download the source (either the official release or the cygwin version),
|
|
unpack it (done for you if using setup.exe), then:
|
|
|
|
$ ./configure --prefix=/usr --mandir=/usr/share/man # (*)
|
|
$ make
|
|
$ make test # optional
|
|
$ make install # (**)
|
|
|
|
(*) The Cygwin project now (as of sometime in 2003) prefers man pages
|
|
within /usr/share/man, as opposed to the default /usr/man.
|
|
|
|
(**) LibTool 1.4.2 had a bug related to cygwin's use of ".exe" extensions,
|
|
such that "make install" blew up at curl.exe. See this URL for details:
|
|
http://mail.gnu.org/pipermail/libtool/2001-September/005549.html
|
|
The copy of ltmain.sh that is distributed with curl includes this patch.
|
|
|
|
As of curl 7.9.1, the official source compiles (under Cygwin) and tests
|
|
100% cleanly OOTB (Out Of The Box)
|
|
|
|
---NO SSL RELEASE---
|
|
Same as standard, except for the configure step, which changes to:
|
|
|
|
$ ./configure --prefix=/usr --mandir=/usr/share/man --without-ssl
|
|
|
|
NOTE: the standard release is what is available via Cygwin's setup.exe;
|
|
the no-ssl release is only available from the curl website
|
|
|
|
|
|
Packaging Instructions:
|
|
---BINARY---
|
|
Compile cleanly as described above, then:
|
|
|
|
$ make cygwinbin CYGBUILD=n
|
|
|
|
where n is the cygwin release number (e.g. the "1" in curl-7.9-1),
|
|
and "CYGBUILD=n" is optional (n defaults to 1 if not specified)
|
|
|
|
Assuming everything worked, you'll find your binary tarballs in
|
|
$(buildtop)/packages/Win32/cygwin/
|
|
|
|
---SOURCE---
|
|
1. download & unpack the pristine source
|
|
2. rename the source dir to add the "-$(REL)" suffix, e.g.:
|
|
$ mv curl-7.9 curl-7.9-1
|
|
3. unpack the pristine source once more, so you'll end up
|
|
with 2 directories: "curl-7.9" and "curl-7.9-1" in this example
|
|
3. add a CYGWIN-PATCHES directory, and add this readme to it
|
|
$ cd curl-7.9-1; mkdir CYGWIN-PATCHES
|
|
$ cp packages/Win32/cygwin/README CYGWIN-PATCHES/curl-7.9-1.README
|
|
4. if applicable, document any changes in the README file
|
|
5. create a patch which, when applied
|
|
(using `patch -p1 < curl-7.9-$(REL).patch`)
|
|
will remove any changes you've made to the pristine source:
|
|
$ cd ..
|
|
$ diff -Nrup curl-7.9-1 curl-7.9 > curl-7.9-1.patch
|
|
and then move it into the CYGWIN-PATCHES directory
|
|
$ mv curl-7.9-1.patch curl-7.9-1/CYGWIN-PATCHES
|
|
6. pack the new source dir into a tar.bz2 file:
|
|
$ tar cfj curl-7.9-1-src.tar.bz2 curl-7.9-1
|
|
|
|
---SETUP.HINT---
|
|
@ curl
|
|
sdesc: "a client that groks URLs"
|
|
ldesc: "Curl is a tool for transferring files with URL syntax,
|
|
supporting FTP, FTPS, HTTP, HTTPS, TELNET, DICT, FILE
|
|
and LDAP. Curl supports HTTPS certificates, HTTP POST, HTTP PUT,
|
|
FTP uploading, kerberos, HTTP form based upload, proxies,
|
|
cookies, user+password authentication, file transfer resume,
|
|
http proxy tunneling and a busload of other useful tricks."
|
|
category: Web Libs
|
|
requires: cygwin openssl
|
|
|
|
@ curl-devel
|
|
sdesc: "(lib)curl headers, static libraries, developer docs and samples"
|
|
ldesc: "curl-devel is the developer-oriented (non-run-time) parts
|
|
of the curl package. It includes header files, static libraries,
|
|
example source code snippets, and the libcurl man pages."
|
|
category: Web Libs Devel
|
|
requires: cygwin openssl curl
|
|
|
|
|
|
Cygwin port maintained by:
|
|
Kevin Roth <kproth @ users . sourceforge . net>
|
|
Questions about curl should be directed to curl-users@cool.haxx.se.
|
|
Questions about this cygwin package go to cygwin@cygwin.com.
|