Using the Apache Portable Runtime (APR)

The goal of the [ APR] project is to provide an API to which software developers may code and be assured of predictable if not identical behaviour regardless of the platform on which their software is built, relieving them of the need to code special-case conditions to work around or take advantage of platform-specific deficiencies or features.

It contains, among other things, the following functionality:

Missing documentation/introductory material

Unfortunately, the official documentation consists of only a Doxygen generated description of the complete [ API] (which is, function by function, quite thorough). There is a tutorial at, but strangely this is not mentioned on the project web site. Moreover, this tutorial is from 2005.

There seems to be no official tutorial.

For specific questions, it might be helpful to browse the [ mailing list archives] (which are not searchable, unfortunately).

A good example of a bad documentation is the description of the functions apr_setup_signal_thread() and apr_signal_thread() in the section [ Threads and Process Functions]. What the hell does this mean?

APR Hello World

The following is a minimal program that makes use of the APR library:

#include <stdio.h>
#include <apr_general.h>

int main(int argc, const char *argv[])
    apr_status_t rv;

    rv = apr_initialize();
    if( rv != APR_SUCCESS ) {
      char errbuf[256];
      apr_strerror(rv, errbuf, sizeof(errbuf));
      puts(errbuf);  /* show the error description */
      return -1;

    printf( "Hello APR world!\n");

    return 0;

Compiling under Unix

You have to define the macro LARGEFILE64_SOURCE and link against the apr-1 library::

cc -o try-helloworld-APR try-helloworld-APR.c -D_LARGEFILE64_SOURCE -I/usr/include/apr-1.0/ -lapr-1

Compiling under Windows

I (Joachim) do not know. I managed to build the libs and run the test suite with Visual Studio as described on, but I do not know where the headers and libs have gone to and how I can link against them. This is more a problem of "How do I develop under Windows" than an APR specific problem.

Nevertheless, the project web site merely says

 Integrating the Library

    We should tell ya'll 'bout this, no?


Q: How can I do getpid() with APR?

Q: Which versions of MS-Windows are POSIX compliant? What does this mean for UNIX library function like sleep()? do they exist on windows and have the same behavior? (Are they portable?)

Q: How do I sleep() with APR?

Q: How do I send and catch signals with APR?

Q: Where can I read the latest POSIX.1 specification online?

CompleteSearch: completesearch/UsingAPR (last edited 2008-01-22 16:41:29 by mpiat1403)