summaryrefslogtreecommitdiff
path: root/README
diff options
context:
space:
mode:
authorWilliam A. Rowe Jr <wrowe@apache.org>2009-08-03 20:31:21 +0000
committerWilliam A. Rowe Jr <wrowe@apache.org>2009-08-03 20:31:21 +0000
commitf2d461019c6f90d7d477d718883f2483956a03e7 (patch)
tree3fb7dccbde0ace64639d1085870c75e14bbaa9d4 /README
parentbac2365d5c7d50f701764812f5783439efbc35f7 (diff)
downloadapr-f2d461019c6f90d7d477d718883f2483956a03e7.tar.gz
Reflect merger of apr-util/STATUS into apr/STATUS
git-svn-id: https://svn.apache.org/repos/asf/apr/apr/trunk@800539 13f79535-47bb-0310-9956-ffa450edef68
Diffstat (limited to 'README')
-rw-r--r--README70
1 files changed, 69 insertions, 1 deletions
diff --git a/README b/README
index 5fa59bfb7..a49c84e60 100644
--- a/README
+++ b/README
@@ -1,5 +1,5 @@
Apache Portable Runtime Library (APR)
--------------------------------------
+=====================================
The Apache Portable Runtime Library provides a predictable and
consistent interface to underlying platform-specific
@@ -35,6 +35,26 @@ Apache Portable Runtime Library (APR)
Thread and Process management
Various data structures (tables, hashes, priority queues, etc)
+ APR 2.0 also provides a number of utility functions and library
+ compatibility interfaces. These were formerly part of APR-util,
+ a seperate utility library in version 1 releases. These include;
+
+ Hashing and UUID services
+ Multiple SQL DBD client interfaces
+ Multiple flat-database DBM client interfaces
+ Typesafe function Hooks abstraction
+ LDAP SSL connections for a variety of LDAP toolkits
+ MemCache interface
+ Date parsing rourtines
+ Resource Lists
+ Thread Pools
+ Queues
+ Relocatable Memory Management functions
+ String filename-style pattern matching
+ URI Parsing
+ Charset translation (iconv based)
+ XML parsing (expat based)
+
For a more complete list, please refer to the following URLs:
http://apr.apache.org/docs/apr/modules.html
@@ -55,6 +75,20 @@ Apache Portable Runtime Library (APR)
if you find our libraries useful in your own projects!
+Database Providers
+==================
+Interfaces for copy-left licensed MySQL and gdbm DBD drivers, and
+Berkeley DB DBM all ship as part of the distribution. To avoid licensing
+incompatibilities, these are not built by default. To enable support,
+the corresponding use the --with-{provider} option, but be aware that
+these licenses may introduce licensing implications for your compiled code.
+Similarly, the bindings for propritary drivers such as Oracle must also be
+explicitly enabled.
+
+Whenever distributing apr-util in combination with database client
+drivers, always review the license requirements of all components.
+
+
Using a Subversion Checkout on Unix
===================================
@@ -133,6 +167,11 @@ 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.
+On windows, selection of database drivers is via the environment values
+DBD_LIST (for freetds, mysql, oracle, pgsql, sqlite2 and/or sqlite3)
+and DBM_LIST (db and/or gdbm). DBD odbc and DBM sdbm are unconditionally
+compiled and installed, do not include these in the list.
+
Generating Test Coverage information with gcc
=============================================
@@ -149,3 +188,32 @@ If you want to generate test coverage data, use the following steps:
make gcov
+Cryptographic Software Notice
+=============================
+This distribution includes cryptographic software. The country in
+which you currently reside may have restrictions on the import,
+possession, use, and/or re-export to another country, of
+encryption software. BEFORE using any encryption software, please
+check your country's laws, regulations and policies concerning the
+import, possession, or use, and re-export of encryption software, to
+see if this is permitted. See http://www.wassenaar.org/ for more
+information.
+
+The U.S. Government Department of Commerce, Bureau of Industry and
+Security (BIS), has classified this software as Export Commodity
+Control Number (ECCN) 5D002.C.1, which includes information security
+software using or performing cryptographic functions with asymmetric
+algorithms. The form and manner of this Apache Software Foundation
+distribution makes it eligible for export under the License Exception
+ENC Technology Software Unrestricted (TSU) exception (see the BIS
+Export Administration Regulations, Section 740.13) for both object
+code and source code.
+
+The following provides more details on the included cryptographic
+software:
+
+ APR-Util provides an abstract interface for SSL encrypted LDAP (ldaps
+ and STARTTLS style) connections, which can be powered by OpenLDAP,
+ Netscape LDAP SDK, Mozilla LDAP SDK, or other platform specific ldap
+ interfaces.
+