You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@santuario.apache.org by sc...@apache.org on 2007/10/31 18:14:22 UTC
svn commit: r590753 - in /xml/security/trunk/doc/site:
src/documentation/content/xdocs/c/index.xml
src/documentation/content/xdocs/c/installation.xml
src/documentation/content/xdocs/c/releases.xml status.xml
Author: scantor
Date: Wed Oct 31 10:14:20 2007
New Revision: 590753
URL: http://svn.apache.org/viewvc?rev=590753&view=rev
Log:
Updated for C ++ v1.4.0
Modified:
xml/security/trunk/doc/site/src/documentation/content/xdocs/c/index.xml
xml/security/trunk/doc/site/src/documentation/content/xdocs/c/installation.xml
xml/security/trunk/doc/site/src/documentation/content/xdocs/c/releases.xml
xml/security/trunk/doc/site/status.xml
Modified: xml/security/trunk/doc/site/src/documentation/content/xdocs/c/index.xml
URL: http://svn.apache.org/viewvc/xml/security/trunk/doc/site/src/documentation/content/xdocs/c/index.xml?rev=590753&r1=590752&r2=590753&view=diff
==============================================================================
--- xml/security/trunk/doc/site/src/documentation/content/xdocs/c/index.xml (original)
+++ xml/security/trunk/doc/site/src/documentation/content/xdocs/c/index.xml Wed Oct 31 10:14:20 2007
@@ -22,12 +22,12 @@
<body>
<section>
- <title>Version 1.3.1 Released</title>
+ <title>Version 1.4.0 Released</title>
<p>
The Apache XML Security team are proud to announce the release
- of version 1.3.1 of the xml-security-c library. This release
- provides some bug fixes and an updated Automake based build on
- Linux/Solaris/BSD.
+ of version 1.4.0 of the xml-security-c library. This release
+ provides more bug fixes, improved automake and RPM packaging,
+ and better error reporting.
</p>
<p>
This version also provides initial support for Xerces 3.0. If
@@ -58,6 +58,20 @@
</section>
<section>
<title>Old News</title>
+ <section>
+ <title>Version 1.3.1 Released</title>
+ <p>
+ The Apache XML Security team are proud to announce the release
+ of version 1.3.1 of the xml-security-c library. This release
+ provides some bug fixes and an updated Automake based build on
+ Linux/Solaris/BSD.
+ </p>
+ <p>
+ This version also provides initial support for Xerces 3.0. If
+ you are building for the 3.0 library under Windows, you will need
+ to change the Xerces library (in link includes) to xerces_3?.lib.
+ </p>
+ </section>
<section>
<title>Version 1.3 Released</title>
<p>
Modified: xml/security/trunk/doc/site/src/documentation/content/xdocs/c/installation.xml
URL: http://svn.apache.org/viewvc/xml/security/trunk/doc/site/src/documentation/content/xdocs/c/installation.xml?rev=590753&r1=590752&r2=590753&view=diff
==============================================================================
--- xml/security/trunk/doc/site/src/documentation/content/xdocs/c/installation.xml (original)
+++ xml/security/trunk/doc/site/src/documentation/content/xdocs/c/installation.xml Wed Oct 31 10:14:20 2007
@@ -32,9 +32,8 @@
is also required if XPath and/or XSLT transformations are required.
</p>
<p>
- Version 1.2.0 of the library has been tested with version 2.5 and 2.6
- of Xerces-C, version 1.9 of Xalan-C and Version 0.9.6 (and above) of
- OpenSSL.
+ Version 1.4.0 of the library has been tested with version 2.8
+ of Xerces-C, and Version 0.9.7 (and above) of OpenSSL.
</p>
</section>
@@ -48,19 +47,12 @@
</jump>.
</p>
<p>
- This project's CVS repository can be checked out through anonymous
- (pserver) CVS with the following instruction set. The module you wish
- to check out must be specified as the modulename. When prompted for a
- password for anonymous, simply enter "anoncvs" without quotes:
+ This project's SVN repository can be checked out directly from
+ https://svn.apache.org/repos/asf/xml/security/trunk/c
</p>
- <source>cvs -d :pserver:anoncvs@cvs.apache.org:/home/cvspublic login
- password: anoncvs
- cvs -d :pserver:anoncvs@cvs.apache.org:/home/cvspublic checkout
- xml-security
- </source>
<p>
A HTTP interface to browse the sources online is available via
- <jump href="site:getting-involved/SVN">http://cvs.apache.org/viewcvs.cgi/xml-security/</jump>
+ <jump href="site:getting-involved/SVN">http://svn.apache.org/viewvc/xml/security/trunk/c/</jump>
</p>
</section>
@@ -70,44 +62,14 @@
XML-Security-C is currently fully supported on Linux, FreeBSD and
Solaris. It is partially supported (in cases where Xalan is not
required) on NetBSD and Cygwin. It has been built and
- tested using GNU gcc 3.x, gcc 2.95.4, Forte C++ 5.4 (Solaris) and
- GNU make.
+ tested using GNU gcc 3.x/4.x, Sun Workshop (Solaris), and GNU make.
</p>
- <note>
- The UNIX XML-Security-C build process has changed radically since
- beta 0.0.2 as the Makefiles and configure scripts have been completely
- rewritten.
- </note>
<section>
<title>Set up the Environment</title>
<p>
- The build process has been automated as much as possible. To
- start the process, three environment variables <em>can</em> be set :
+ The build process has been automated as much as possible to rely on
+ standard configure and make commands and not environment variables.
</p>
- <ul>
- <li><em>XERCESCROOT</em> - points to the base of your Xerces distribution</li>
- <li><em>XALANCROOT</em> - points to the base of your Xalan distribution</li>
- <li><em>OPENSSL</em> - points to the base of your OpenSSL distribution</li>
- </ul>
- <p>
- For example (on my Debian Linux box under Bash) :
- </p>
- <source><![CDATA[
-export XERCESCROOT=~/prog/extlibs/xerces-c-src2_6_0
-export XALANCROOT=~/prog/extlibs/xalan-c-src1_9/c
-export OPENSSL=~/prog/extlibs/openssl-0.9.7g
- ]]></source>
- <p>
- If these environment variables are not set, configure will try to
- find the necessary include and library files in the system directories.
- The configure script is created through <em>autoconf</em> so you
- can also tell your compiler where to find these things via
- the <em>CXXFLAGS</em> and <em>LDFLAGS</em> environment variables.
- </p>
- <note>
- As of version 1.3.1 the Xerces and OpenSSL directories can be
- defined on the configure command line - see below.
- </note>
<p>
If configure cannot find anything for Xalan, it will assume that
you are not interested in XPath or XSLT support and will compile
@@ -118,7 +80,7 @@
<section>
<title>Configure</title>
<p>
- Now go to the $XSECCROOT directory and run the command
+ Now go to the root directory and run the command
<em>./configure</em>. This will create the necessary makefiles
and header files necessary to build the package.
</p>
@@ -160,7 +122,7 @@
<li><em>lib</em> - Where the shared library is place</li>
</ol>
<p>
- You will need to set up your <em>LD_LIBRARY_PATH</em> environment
+ You may need to set up your <em>LD_LIBRARY_PATH</em> environment
variable to ensure ld.so will find the new shared libraries.
</p>
<p>
@@ -182,9 +144,9 @@
<title>Building for Windows</title>
<p>
XML-Security-C has been built and tested on Microsoft's Visual C++ 6.0
- compiler only. (VC++ .NET support is currently being worked on.)
- The following subsections briefly describe how to
+ and 2005 compilers. The following subsections briefly describe how to
rebuild the library, tools and samples using the supplied workspaces.
+ The specific information is for VC6, but the process for 2005 is similar.
</p>
<note>
As of version 0.2, the library can be built without OpenSSL on a
Modified: xml/security/trunk/doc/site/src/documentation/content/xdocs/c/releases.xml
URL: http://svn.apache.org/viewvc/xml/security/trunk/doc/site/src/documentation/content/xdocs/c/releases.xml?rev=590753&r1=590752&r2=590753&view=diff
==============================================================================
--- xml/security/trunk/doc/site/src/documentation/content/xdocs/c/releases.xml (original)
+++ xml/security/trunk/doc/site/src/documentation/content/xdocs/c/releases.xml Wed Oct 31 10:14:20 2007
@@ -24,167 +24,9 @@
<section>
<title>Changes</title>
<p>
- This section describes the changes that have occurred between the
- various releases of the library
+ Please see the CHANGELOG that accompanies the software for a history
+ of changes.
</p>
- <section>
- <title>Version 1.2.0</title>
- <p>
- Version 1.2 provides bug fixes to signature and encryption, and
- provides support for XKMS message generation and processing.
- </p>
- <p>
- Changes from version 1.1.0 include :
- </p>
- <ul>
- <li>Classes to generate and process XKMS messages</li>
- <li>A client tool - <em>xklient</em> - to communicate
- queries to an XKMS server and print the results to stdout.
- </li>
- <li>Multiple bug fixes</li>
- <li>Support for SHA-512/384 when using a beta of OpenSSL
- 0.9.8</li>
- <li>Updated to support Xerces 2.6 and Xalan 1.8/9</li>
- </ul>
- </section>
- <section>
- <title>Version 1.1.0</title>
- <p>
- Version 1.1 provides bug fixes to signature functionality +
- beta support for XML Encryption.
- </p>
- <p>
- Changes from version 1.0.0 include :
- </p>
- <ul>
- <li>Beta implementation of XML Encryption, using an interface
- similar to that used in the Apache Java xml-security library</li>
- <li>Fix for bug where large text elements would be truncated during
- canonicalisation</li>
- <li>Provision of a <em>cipher</em> tool that can be used to encrypt
- and decrypt XML documents</li>
- <li>Updated and improved the Windows Crypto API interface</li>
- <li>Other bug fixes to signature functionality</li>
- <li>Updated to support Xerces 2.4/2.5 and Xalan 1.7</li>
- </ul>
- </section>
- <section>
- <title>Changes from 0.10 - 1.00</title>
- <p>
- Version 1.00 is the first release of the library considered basically
- stable. The interface is fairly simple, but all the mandatory
- requirements of the XML Digital Signature standard, canonicalised
- XML, exclusive canonicalised XML and XPath-Filter2 are implemented.
- </p>
- <p>
- Changes from version 0.20 include :
- </p>
- <ul>
- <li>Implementation of remaining KeyInfo elements (SPKIData,
- PGPData and MgmtData</li>
- <li>Re-implementation of XSECXPathNodeList using a binary search
- to speed up list searches</li>
- <li>Support for Intel Compiler 6.0 on
- Linux and Forte CC (CC 5.4) on Solaris</li>
- <li>Limited support (i.e. without Xalan integration for NetBSD,
- FreeBSD and Cygwin</li>
- <li>A number of minor bug fixes</li>
- </ul>
- </section>
- <section>
- <title>Changes from 0.10 - 0.20</title>
- <p>
- Includes a number of bug-fixes and a first cut at a provider for the
- Windows Crypto API.
- </p>
- </section>
- <section>
- <title>Beta release 0.10</title>
- <p>
- The current release of the xml-security-c library is a beta of the
- XML Digital Signature code, and is the first version of the library
- produced within Apache's XML project.
- </p>
- <p>
- Previous versions were created within Sourceforge as the
- xml-security-c project at that site.
- </p>
- </section>
- <section>
- <title>Changes from 0.03-0.10</title>
- <p>
- The following changes occurred between versions 0.03 and 0.10 :
- </p>
- <ul>
- <li>A <em>threadTest</em> tool, which is primarily used to show
- how multiple threads can access the library under Windows</li>
- <li>Windows and UNIX URI Resolvers, based on the Xerces resolver,
- but which can handle HTTP re-directs</li>
- <li>Completed a basic level of API documentation</li>
- <li>Reviewed library to ensure usage of UTF-16 internally</li>
- <li>Closed a number of memory-leaks caused by exceptions being
- thrown</li>
- </ul>
- </section>
- <section>
- <title>Changes from 0.02-0.03</title>
- <p>
- The following changes occurred between 0.02->0.03
- </p>
- <ul>
- <li>A <em>txfmout</em> tool to output the transformed references</li>
- <li>Updates to <em>templatesign</em> to support KeyInfo elements
- and RSA signatures</li>
- <li>Library support for RSA signatures</li>
- <li>API support form manipulating KeyInfo elements</li>
- <li>Pluggable KeyInfo Resolvers (to allow an application to supply
- an object that will resolve a given KeyInfo to a key)</li>
- <li>Pluggable URI resolvers</li>
- <li>API support for creating references and transformations</li>
- <li>Re-written Makefiles for *NIX</li>
- <li>Improved API docs</li>
- <li>Envelope Transform that no longer uses XPath transforms (much
- quicker)</li>
- <li>Uses new Xerces DOMNode objects - has made for significant
- speed improvements</li>
- </ul>
- </section>
- <section>
- <title>Changes from 0.01-0.02</title>
- <ul>
- <li>Signing functionality</li>
- <li>Update C14n canonicalisation</li>
- <li>Exclusive Canonicalisation</li>
- <li>Basic ability to create a signature via the API (rather than just
- from an XML template file</li>
- <li>SHA-1 HMAC support</li>
- <li>Basic Documentation of core API</li>
- <li>A <em>templatesign</em> tool</li>
- </ul>
- </section>
- </section>
- <section>
- <title>Future Release Plans</title>
- <p>A number of items are planned for after the 1.0 major release.</p>
- <ul>
- <li>XML Encryption Support</li>
- <li>decoupled, pluggable interface for transforms and signature types.
- Currently these are hard coded into the library, so it is not
- possible for calling applications to "plug-in" their own signature
- types or transforms</li>
- <li>Implement a SAX based canonicaliser for situations where an XML
- document needs to be read in and directly canonicalised (i.e. where
- the signature is not part of the document being processed</li>
- <li>Improved <em>KeyInfo</em> resolver interface leading to...</li>
- <li>XKMS client support</li>
- <li>Implementation of libgcrypt as a crypto provider</li>
- <li>Support for PGP/GPG key based signatures (using libgcrypt and
- gpgme)</li>
- <li>Bring the API in-line with JCP 105 (if appropriate)</li>
- <li>Eventually (the GRAND PLAN) an XKMS server implementation</li>
- <li>Implementation of a core set of encryption primitives to allow
- decoupling from OpenSSL for "light" applications</li>
- </ul>
</section>
</body>
</document>
Modified: xml/security/trunk/doc/site/status.xml
URL: http://svn.apache.org/viewvc/xml/security/trunk/doc/site/status.xml?rev=590753&r1=590752&r2=590753&view=diff
==============================================================================
--- xml/security/trunk/doc/site/status.xml (original)
+++ xml/security/trunk/doc/site/status.xml Wed Oct 31 10:14:20 2007
@@ -26,12 +26,33 @@
<person name="Vishal Mahajan" email="vmahajan@amberpoint.com" id="VM"/>
<person name="Milan Tomic" email="milan@setcce.org" id="MT"/>
<person name="Sean Mullan" email="sean.mullan@sun.com" id="SM"/>
+ <person name="Scott Cantor" email="cantor.2@osu.edu" id="SC"/>
<!-- Add more people here -->
</developers>
<changes>
<!-- Add new releases here; action attributes: type:(add | fix | update); -->
<!-- context:(docs | java_something | c_something ) -->
+
+ <release version="C++ 1.4.0" date="November 2007">
+ <action dev="BL" type="fix" context="c_rel">
+ Fix exclusive c14n namespace bug (rev. 526939)
+ </action>
+ <action dev="SC" type="add" context="c_rel">
+ Add const specifiers and methods to various classes
+ </action>
+ <action dev="SC" type="add" context="c_rel">
+ Add better extraction of openssl build settings using pkg-config
+ </action>
+ <action dev="SC" type="fix" context="c_rel">
+ Fix XSECnew macro to stop catching arbitrary errors and report
+ crypto exceptions instead of turning them into allocation errors
+ </action>
+ <action dev="SC" type="fix" context="c_rel">
+ Add various missing files to dist target
+ </action>
+ </release>
+
<release version="Java 1.4.1" date="May 2007">
<action dev="SM" type="fix" fixes-bug="41892" context="java_general" due-to="Derek Morr">
XML Security 1.4.0 does not build with IBM's JDK.
@@ -63,8 +84,8 @@
<action dev="RB" type="fix" fixes-bug="41462" context="java_general" due-to="Karol Rewera">
Xml canonization - UTF-8 encoding issue in Xml security 1.4.0.
</action>
-
</release>
+
<release version="C++ 1.3.1" date="January 2007">
<action dev="BL" type="update" context="c_rel">
Refactor NIX build to use automake and libtool