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 -- To unsubscribe from this list: send the line "unsubscribe linux-crypto" in the body of a message to majordomo@xxxxxxxxxxxxxxx More majordomo info at http://vger.kernel.org/majordomo-info.html