|
Packit |
383869 |
Apache Portable Runtime Utility Library README
|
|
Packit |
383869 |
----------------------------------------------
|
|
Packit |
383869 |
|
|
Packit |
383869 |
The Apache Portable Runtime Utility Library provides a predictable
|
|
Packit |
383869 |
and consistent interface to underlying client library interfaces.
|
|
Packit |
383869 |
This API assures predictable if not identical behavior regardless
|
|
Packit |
383869 |
of which libraries are available on a given platform.
|
|
Packit |
383869 |
|
|
Packit |
383869 |
APR and its companion libraries are implemented entirely in C
|
|
Packit |
383869 |
and provide a common programming interface across a wide variety
|
|
Packit |
383869 |
of operating system platforms without sacrificing performance.
|
|
Packit |
383869 |
Currently supported platforms include:
|
|
Packit |
383869 |
|
|
Packit |
383869 |
UNIX variants
|
|
Packit |
383869 |
Windows
|
|
Packit |
383869 |
Netware
|
|
Packit |
383869 |
Mac OS X
|
|
Packit |
383869 |
OS/2
|
|
Packit |
383869 |
|
|
Packit |
383869 |
To give a brief overview, the primary core
|
|
Packit |
383869 |
subsystems of APR-util 1.3 include the following:
|
|
Packit |
383869 |
|
|
Packit |
383869 |
Hashing and UUID services
|
|
Packit |
383869 |
Multiple SQL DBD client interfaces
|
|
Packit |
383869 |
Multiple flat-database DBM client interfaces
|
|
Packit |
383869 |
Typesafe function Hooks abstraction
|
|
Packit |
383869 |
LDAP SSL connections for a variety of LDAP toolkits
|
|
Packit |
383869 |
MemCache interface
|
|
Packit |
383869 |
Date parsing rourtines
|
|
Packit |
383869 |
Resource Lists
|
|
Packit |
383869 |
Thread Pools
|
|
Packit |
383869 |
Queues
|
|
Packit |
383869 |
Relocatable Memory Management functions
|
|
Packit |
383869 |
String filename-style pattern matching
|
|
Packit |
383869 |
URI Parsing
|
|
Packit |
383869 |
Charset translation (iconv based)
|
|
Packit |
383869 |
XML parsing (expat)
|
|
Packit |
383869 |
|
|
Packit |
383869 |
For a more complete list, please refer to the following URLs:
|
|
Packit |
383869 |
|
|
Packit |
383869 |
http://apr.apache.org/docs/apr-util/modules.html
|
|
Packit |
383869 |
|
|
Packit |
383869 |
Users of APR 0.9 should be aware that migrating to the APR 1.x
|
|
Packit |
383869 |
programming interfaces may require some adjustments; APR 1.x is
|
|
Packit |
383869 |
neither source nor binary compatible with earlier APR 0.9 releases.
|
|
Packit |
383869 |
Users of APR 1.x can expect consistent interfaces and binary backwards
|
|
Packit |
383869 |
compatibility throughout the entire APR 1.x release cycle, as defined
|
|
Packit |
383869 |
in our versioning rules:
|
|
Packit |
383869 |
|
|
Packit |
383869 |
http://apr.apache.org/versioning.html
|
|
Packit |
383869 |
|
|
Packit |
383869 |
APR is already used extensively by the Apache HTTP Server
|
|
Packit |
383869 |
version 2 and the Subversion revision control system, to
|
|
Packit |
383869 |
name but a few. We list all known projects using APR at
|
|
Packit |
383869 |
http://apr.apache.org/projects.html -- so please let us know
|
|
Packit |
383869 |
if you find our libraries useful in your own projects!
|
|
Packit |
383869 |
|
|
Packit |
383869 |
|
|
Packit |
383869 |
Database Providers
|
|
Packit |
383869 |
------------------
|
|
Packit |
383869 |
As of apr-util version 1.2.11, MySQL DBD driver is shipped as part of the
|
|
Packit |
383869 |
distribution. However, to avoid licensing incompatibilities, it is not
|
|
Packit |
383869 |
built by default. To enable MySQL support, use the --with-mysql option,
|
|
Packit |
383869 |
but be aware that the MySQL license may introduce licensing implications
|
|
Packit |
383869 |
for your compiled code. Similarly, the bindings for propritary drivers
|
|
Packit |
383869 |
such as Oracle (--with-oracle option) must also be explicitly enabled.
|
|
Packit |
383869 |
|
|
Packit |
383869 |
On windows, selection of supported drivers is via the environment values
|
|
Packit |
383869 |
DBD_LIST (for mysql, oracle, pgsql, sqlite2 and/or sqlite3)
|
|
Packit |
383869 |
and DBM_LIST (db and/or gdbm). DBD odbc and DBM sdbm are unconditionally
|
|
Packit |
383869 |
compiled and installed, do not include these in the list.
|
|
Packit |
383869 |
|
|
Packit |
383869 |
Whenever distributing apr-util in combination with database client
|
|
Packit |
383869 |
drivers, always review the license requirements of all components.
|
|
Packit |
383869 |
|
|
Packit |
383869 |
|
|
Packit |
383869 |
Cryptographic Software Notice
|
|
Packit |
383869 |
-----------------------------
|
|
Packit |
383869 |
This distribution includes cryptographic software. The country in
|
|
Packit |
383869 |
which you currently reside may have restrictions on the import,
|
|
Packit |
383869 |
possession, use, and/or re-export to another country, of
|
|
Packit |
383869 |
encryption software. BEFORE using any encryption software, please
|
|
Packit |
383869 |
check your country's laws, regulations and policies concerning the
|
|
Packit |
383869 |
import, possession, or use, and re-export of encryption software, to
|
|
Packit |
383869 |
see if this is permitted. See http://www.wassenaar.org/ for more
|
|
Packit |
383869 |
information.
|
|
Packit |
383869 |
|
|
Packit |
383869 |
The U.S. Government Department of Commerce, Bureau of Industry and
|
|
Packit |
383869 |
Security (BIS), has classified this software as Export Commodity
|
|
Packit |
383869 |
Control Number (ECCN) 5D002.C.1, which includes information security
|
|
Packit |
383869 |
software using or performing cryptographic functions with asymmetric
|
|
Packit |
383869 |
algorithms. The form and manner of this Apache Software Foundation
|
|
Packit |
383869 |
distribution makes it eligible for export under the License Exception
|
|
Packit |
383869 |
ENC Technology Software Unrestricted (TSU) exception (see the BIS
|
|
Packit |
383869 |
Export Administration Regulations, Section 740.13) for both object
|
|
Packit |
383869 |
code and source code.
|
|
Packit |
383869 |
|
|
Packit |
383869 |
The following provides more details on the included cryptographic
|
|
Packit |
383869 |
software:
|
|
Packit |
383869 |
|
|
Packit |
383869 |
APR-Util provides an abstract interface for symmetrical cryptographic
|
|
Packit |
383869 |
functions that make use of a general-purpose encryption library,
|
|
Packit |
383869 |
such as OpenSSL, NSS, or the operating system's platform-specific
|
|
Packit |
383869 |
facilities. This interface is known as the apr_crypto interface,
|
|
Packit |
383869 |
with implementation beneath the /crypto directory.
|
|
Packit |
383869 |
|
|
Packit |
383869 |
APR-Util provides an abstract interface for SSL encrypted LDAP (ldaps
|
|
Packit |
383869 |
and STARTTLS style) connections, which can be powered by OpenLDAP,
|
|
Packit |
383869 |
Netscape LDAP SDK, Mozilla LDAP SDK, or other platform specific ldap
|
|
Packit |
383869 |
interfaces.
|
|
Packit |
383869 |
|