gcc 4.4: Remove a nop memset size 0 that annoys gcc
[asterisk/asterisk.git] / doc / hoard.txt
1 Using the Hoard Memory Allocator with Asterisk
2 ==============================================
3
4 1) Install the Hoard Memory Allocator
5
6    Download Hoard from http://www.hoard.org/ either via a package or the source
7    tarball.
8
9    If downloading the source, unpack the tarball and follow the instructions in
10    the README file to build libhoard for your platform.
11
12 2) Configure asterisk
13
14    Run ./configure in the root of the asterisk source directory, passing the
15    --with-hoard option specifying the location of the libhoard shared library.
16
17    For example:
18
19            ./configure --with-hoard=/usr/src/hoard-371/src/
20
21    Note that we don't specify the full path to libhoard.so, just the directory
22    where it resides.
23
24 3) Enable Hoard in menuselect
25
26    Run 'make menuselect' in the root of the asterisk source distribution.  Under
27    'Compiler Flags' select the 'USE_HOARD_ALLOCATOR' option.  If the option is
28    not available (shows up with XXX next to it) this means that configure was
29    not able to find libhoard.so.  Check that the path you passed to the
30    --with-hoard option is correct.  Re-run ./configure with the correct option
31    and then repeat step 3.
32
33 4) Make and install asterisk
34
35    Run the standard build commands:
36
37            # make
38            # make install