README
                               LIBKSBA
                              ---------

         Copyright 2001, 2006, 2007, 2008, 2009, 2010, 2011,
                   2012, 2013, 2014, 2015  g10 Code GmbH

This file is free software; as a special exception the author gives
unlimited permission to copy and/or distribute it, with or without
modifications, as long as this notice is preserved.

This file is distributed in the hope that it will be useful, but
WITHOUT ANY WARRANTY, to the extent permitted by law; without even the
implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR
PURPOSE.

Libksba itself is distributed under the terms of the GNU General
Public License, see the file AUTHORS for details.


                            KSBA Overview
                            -------------

KSBA (pronounced Kasbah) is a library to make X.509 certificates as
well as the CMS easily accessible by other applications.  Both
specifications are building blocks of S/MIME and TLS.

KSBA is made available as a standard shared library and reserves
identifiers starting with "ksba" and "_ksba" (also uppercase and mixed
case).  It does not rely on another cryptographic library.


                            Documentation
                            -------------

A standard info format reference manual is included.  However the OCSP
feature has not yet been documented.  See the comments in src/ocsp.c
and the example tests/t-ocsp.c.  The GnuPG's dirmngr module makes
extensive use of the OCSP feature and may be used as another example.