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

lists.openwall.net		lists / announce owl-users owl-dev john-users john-dev passwdqc-users yescrypt popa3d-users / oss-security kernel-hardening musl sabotage tlsify passwords / crypt-dev xvendor / Bugtraq Full-Disclosure linux-kernel linux-netdev linux-ext4 linux-hardening linux-cve-announce PHC
Open Source and information security mailing list archives

Hash Suite: Windows password security audit tool. GUI, reports in PDF.

[<prev] [next>] [thread-next>] [day] [month] [year] [list]

Message-ID: <1800066.efQ8hkST4U@tachyon.chronox.de>
Date:	Wed, 12 Nov 2014 05:22 +0100
From:	Stephan Mueller <smueller@...onox.de>
To:	Herbert Xu <herbert@...dor.apana.org.au>
Cc:	Marek Vasut <marex@...x.de>,
	"David S. Miller" <davem@...emloft.net>,
	Jason Cooper <cryptography@...edaemon.net>,
	Grant Likely <grant.likely@...retlab.ca>,
	'Geert Uytterhoeven' <geert@...ux-m68k.org>,
	"Joy M. Latten" <jmlatten@...ux.vnet.ibm.com>,
	Jonathan Corbet <corbet@....net>,
	LKML <linux-kernel@...r.kernel.org>, linux-crypto@...r.kernel.org
Subject: [PATCH v3 00/13] crypto: Documentation of kernel crypto API

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-kernel" in
the body of a message to majordomo@...r.kernel.org
More majordomo info at  http://vger.kernel.org/majordomo-info.html
Please read the FAQ at  http://www.tux.org/lkml/