mirror of
https://git.FreeBSD.org/src.git
synced 2024-12-20 11:11:24 +00:00
81 lines
2.3 KiB
Plaintext
81 lines
2.3 KiB
Plaintext
Welcome to serf, a high-performance asynchronous HTTP client library.
|
|
|
|
The serf library is a C-based HTTP client library built upon the Apache
|
|
Portable Runtime (APR) library. It multiplexes connections, running the
|
|
read/write communication asynchronously. Memory copies and transformations are
|
|
kept to a minimum to provide high performance operation.
|
|
|
|
* Status: http://code.google.com/p/serf/wiki/
|
|
* Site: http://code.google.com/p/serf/
|
|
* Code: http://serf.googlecode.com/svn/
|
|
* Issues: http://code.google.com/p/serf/issues/list
|
|
* Mail: serf-dev@googlegroups.com
|
|
* People: Justin Erenkrantz, Greg Stein
|
|
|
|
----
|
|
|
|
1. INSTALL
|
|
|
|
1.1. SCons build system
|
|
|
|
serf uses SCons 2.x for its build system. If it is not installed on
|
|
your system, then you can install it onto your system. If you do not
|
|
have permissions, then you can download and install the "local"
|
|
version into your home directory. When installed privately, simply
|
|
create a symlink for 'scons' in your PATH to /path/to/scons/scons.py.
|
|
|
|
Fetch the scons-local package:
|
|
http://prdownloads.sourceforge.net/scons/scons-local-2.0.1.tar.gz
|
|
|
|
|
|
1.2 Building serf
|
|
|
|
To build serf:
|
|
|
|
$ scons APR=/path/to/apr APU=/path/to/apu OPENSSL=/openssl/base PREFIX=/path/to/prefix
|
|
|
|
The switches are recorded into .saved_config, so they only need to be
|
|
specified the first time scons is run.
|
|
|
|
PREFIX should specify where serf should be installed. PREFIX defaults to
|
|
/usr/local.
|
|
|
|
The default for the other three switches (APR, APU, OPENSSL) is /usr.
|
|
|
|
The build system looks for apr-1-config at $APR/bin/apr-1-config, or
|
|
the path should indicate apr-1-config itself. Similarly for the path
|
|
to apu-1-config.
|
|
|
|
OPENSSL should specify the root of the install (eg. /opt/local). The
|
|
includes will be found OPENSSL/include and libraries at OPENSSL/lib.
|
|
|
|
If you wish to use VPATH-style builds (where objects are created in a
|
|
distinct directory from the source), you can use:
|
|
|
|
$ scons -Y /path/to/serf/source
|
|
|
|
At any point, the current settings can be examined:
|
|
|
|
$ scons --help
|
|
|
|
|
|
1.3 Running the test suite
|
|
|
|
$ scons check
|
|
|
|
|
|
1.4 Installing serf
|
|
|
|
$ scons install
|
|
|
|
Note that the PREFIX variable should have been specified in a previous
|
|
invocation of scons (and saved into .saved_config), or it can be
|
|
specified on the install command line:
|
|
|
|
$ scons PREFIX=/some/path install
|
|
|
|
|
|
1.4 Cleaning up the build
|
|
|
|
$ scons -c
|