[PATCH v3 00/13] crypto: Documentation of kernel crypto API

[Stephan Mueller <smueller@chronox.de>]

Hi,

The following patch set adds documentation files under Documentation/crypto/
covering the high-level description of the API. In addition, it contains
source code comments added to the header files of the kernel crypto API
documenting the API functions.

The documentation is provided in a DocBook whose output can be reviewed at:

http://www.chronox.de/crypto-API/index.html

Changes v2:
 * Split out the user space documentation into separate document including
   the user space example code
 * Change the license of the user space interface code to match the license
   of the code that I used as a reference.
 * Addition of a precise pointer to the user space interface code reference
   code.
 * Add a missing memset(0) to the user space example code.
 * Move the API function call documentation into the header files in the hope
   for a better maintainability.
 * Merge the developer-related documentation from Marek Vasut

Changes v3:
 * Replaced user space example code with reference to libkcapi as a reference
   implementation and a simple library hiding the Netlink details.
 * Converted all kernel documentation into a basis for a DocBook as suggested
   by Jonathan Corbet
 * Included (hopefully) all suggestions provided over the last two weeks

Stephan Mueller (13):
  crypto: Documentation - crypto API high level spec
  crypto: Documentation - compile crypto API spec
  crypto: Documentation - userspace interface spec
  crypto: Documentation - RNG API documentation
  crypto: Documentation - hash data structures
  crypto: Documentation - AHASH API documentation
  crypto: Documentation - SHASH API documentation
  crypto: Documentation - cipher data structures
  crypto: Documentation - ABLKCIPHER API documentation
  crypto: Documentation - AEAD API documentation
  crypto: Documentation - BLKCIPHER API documentation
  crypto: Documentation - CIPHER API documentation
  crypto: Documentation - HASH API documentation

 Documentation/DocBook/Makefile                |    2 +-
 Documentation/DocBook/crypto-API.tmpl         | 1253 +++++++++++++++++++++++++
 Documentation/crypto/crypto-API-userspace.txt |  205 ++++
 include/crypto/hash.h                         |  487 ++++++++++
 include/crypto/rng.h                          |   80 ++
 include/linux/crypto.h                        | 1099 +++++++++++++++++++++-
 6 files changed, 3122 insertions(+), 4 deletions(-)
 create mode 100644 Documentation/DocBook/crypto-API.tmpl
 create mode 100644 Documentation/crypto/crypto-API-userspace.txt

-- 
2.1.0