1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
|
Apache Portable Runtime
=======================
Using a Subversion Checkout on Unix
===================================
If you are building APR from SVN, you need to perform a prerequisite
step. You must have autoconf, libtool and python installed for this
to work. The prerequisite is simply;
./buildconf
If you are building APR from a distribution tarball, buildconf is
already run for you, and you do not need autoconf, libtool or python
installed or to run buildconf unless you have patched APR's buildconf
inputs (such as configure.in, build.conf, virtually any file within
the build/ tree, or you add or remove source files).
Remember when updating from svn that you must rerun ./buildconf again
to effect any changes made to the build schema in your fresh update.
Configuring and Building APR on Unix
====================================
Simply;
./configure --prefix=/desired/path/of/apr
make
make test
make install
Configure has additional options, ./configure --help will offer you
those choices. You may also add CC=compiler CFLAGS="compiler flags"
etc. prior to the ./configure statement (on the same line). Please
be warned, some flags must be passed as part of the CC command,
itself, in order for autoconf to make the right determinations. Eg.;
CC="gcc -m64" ./configure --prefix=/desired/path/of/apr
will inform APR that you are compiling to a 64 bit CPU, and autoconf
must consider that when setting up all of APR's internal and external
type declarations.
For more verbose output from testall, you may wish to invoke testall
with the flag;
cd test
./testall -v
Configuring and Building APR on Windows
=======================================
Using Visual Studio, you can build and run the test validation of APR.
The Makefile.win make file has a bunch of documentation about it's
options, but a trivial build is simply;
nmake -f Makefile.win
nmake -f Makefile.win PREFIX=c:\desired\path\of\apr install
Note you must manually modify the include\apr.hw file before you
build to change default options, see the #define APR_HAS_... or the
#define APR_HAVE_... statements. Be careful, many of these aren't
appropriate to be modified. The most common change is
#define APR_HAVE_IPV6 1
rather than 0 if this build of APR will be used strictly on machines
with the IPv6 adapter support installed.
It's trivial to include the apr.dsp (for a static library) or the
libapr.dsp (for a dynamic library) in your own build project, or you
can load apr.dsw in Visual Studio 2002 (.NET) or later, which will
convert these for you into apr.sln and associated .vcproj files.
When using APR as a dynamic library, nothing special is required,
simply link to libapr.lib. To use it as a static library, simply
define APR_DECLARE_STATIC before you include any apr header files
in your source, and link to apr.lib instead.
Generating Test Coverage information with gcc
=============================================
If you want to generate test coverage data, use the following steps:
./buildconf
CFLAGS="-fprofile-arcs -ftest-coverage" ./configure
make
cd test
make
./testall
cd ..
make gcov
|
