[apple/security.git] / libsecurity_keychain / libDER / README.txt

                             libDER Library Notes
			    Last update to this file Jan. 26 2006 by dmitch

This module is a very lightweight implementation of a DER encoder and 
decoder. Unlike most other DER packages, this one does no malloc or 
copies when it encodes or decodes; decoding an item yields a pointer 
and a byte count which refer to memory inside of the "thing" being 
decoded. Likewise, when encoding, the caller mustsupply a target buffer
to which the encoded item is written. 

Support for encoding sequences and for decoding sequences and sets of 
known items is also included; when you decode a sequence, you get a
sequence of pointers and byte counts - again, no mallocs or copies occur. 

The directory libDER contains the DER decoding library proper. The main
API is in DER_Decode.h. Support for RSA keys, X509 certs, X509 CRLs, and
miscellaneous OIDs can also be found in libDER. 

Command line programs to parse and display the contents of X509 certificates
and CRLs, using libDER, can be found in the Tests directory. 

Revision History
----------------

  Date        svk tag		Changes
--------    -----------		----------------------------------------
01/26/06	 libDER-5		Avoid varargs macros for portability. 
01/03/06	 libDER-4		Initial distribution in RSACertLib.
12/23/05	 libDER-3		Fix DER_DECODE_ENABLE ifdef for DER_Decode.c.
							Add MD2, MD5 OID and DigestInfo capabilities.
12/13/05	 libDER-2		Added Apple Custom RSA public key formats. 
							Added PKCS1 RSA private keys. 
11/28/05	 libDER-1		Initial tag.
Commit	Line	Data
b1ab9ed8 A	1	libDER Library Notes
	2	Last update to this file Jan. 26 2006 by dmitch
	3
	4	This module is a very lightweight implementation of a DER encoder and
	5	decoder. Unlike most other DER packages, this one does no malloc or
	6	copies when it encodes or decodes; decoding an item yields a pointer
	7	and a byte count which refer to memory inside of the "thing" being
	8	decoded. Likewise, when encoding, the caller mustsupply a target buffer
	9	to which the encoded item is written.
	10
	11	Support for encoding sequences and for decoding sequences and sets of
	12	known items is also included; when you decode a sequence, you get a
	13	sequence of pointers and byte counts - again, no mallocs or copies occur.
	14
	15	The directory libDER contains the DER decoding library proper. The main
	16	API is in DER_Decode.h. Support for RSA keys, X509 certs, X509 CRLs, and
	17	miscellaneous OIDs can also be found in libDER.
	18
	19	Command line programs to parse and display the contents of X509 certificates
	20	and CRLs, using libDER, can be found in the Tests directory.
	21
	22	Revision History
	23	----------------
	24
	25	Date svk tag Changes
	26	-------- ----------- ----------------------------------------
	27	01/26/06 libDER-5 Avoid varargs macros for portability.
	28	01/03/06 libDER-4 Initial distribution in RSACertLib.
	29	12/23/05 libDER-3 Fix DER_DECODE_ENABLE ifdef for DER_Decode.c.
	30	Add MD2, MD5 OID and DigestInfo capabilities.
	31	12/13/05 libDER-2 Added Apple Custom RSA public key formats.
	32	Added PKCS1 RSA private keys.
	33	11/28/05 libDER-1 Initial tag.
	34