https://github.com/apache/serf

Mirror of Apache Serf
https://github.com/apache/serf

c library serf

Last synced: about 1 month ago
JSON representation

Mirror of Apache Serf

• Host: GitHub
• URL: https://github.com/apache/serf
• Owner: apache
• License: apache-2.0
• Created: 2016-10-14T07:00:06.000Z (about 8 years ago)
• Default Branch: trunk
• Last Pushed: 2024-07-10T12:38:04.000Z (4 months ago)
• Last Synced: 2024-09-30T01:21:17.354Z (about 2 months ago)
• Topics: c, library, serf
• Language: C
• Size: 3.21 MB
• Stars: 26
• Watchers: 5
• Forks: 9
• Open Issues: 0
• Metadata Files:
  • Readme: README
  • Changelog: CHANGES
  • License: LICENSE

Awesome Lists containing this project

• awesome-http - Apache Serf - activity/y/apache/serf) (Programming Languages / C++)

README

        
Welcome to Apache Serf, a high-performance asynchronous HTTP client library.

The Apache 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.

  * Site: https://serf.apache.org/

  * Code: https://svn.apache.org/repos/asf/serf/

  * Official Git Mirror: https://github.com/apache/serf/

  * Issues: https://issues.apache.org/jira/browse/SERF

  * Mail: [email protected]

  * People: Justin Erenkrantz, Greg Stein 

----

1. INSTALL

1.1. SCons build system

Apache Serf uses SCons 2.3 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.3.0.tar.gz

1.2 Building Apache 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

If you plan to install the library on a system that uses different

paths for architecture dependent files, specify LIBDIR. LIBDIR defaults

to /usr/local/lib otherwise. Example for a 64 bit GNU/Linux system:

$ scons PREFIX=/usr/ LIBDIR=/usr/lib64

At any point, the current settings can be examined:

$ scons --help

1.3 Running the test suite

$ scons check

1.4 Installing Apache 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

Distribution package maintainers regulary install to a buildroot, and

would normally use something like below in their build systems, with

placeholders for the specific paths:

$ scons PREFIX=/usr/ LIBDIR=/usr/lib64

$ scons install --install-sandbox=/path/to/buildroot

1.4 Cleaning up the build

$ scons -c