esphinx.addnodesdocument)}( rawsourcechildren]( translations LanguagesNode)}(hhh](h pending_xref)}(hhh]docutils.nodesTextChinese (Simplified)}parenthsba attributes}(ids]classes]names]dupnames]backrefs] refdomainstdreftypedoc reftarget$/translations/zh_CN/crypto/api-intromodnameN classnameN refexplicitutagnamehhh ubh)}(hhh]hChinese (Traditional)}hh2sbah}(h]h ]h"]h$]h&] refdomainh)reftypeh+ reftarget$/translations/zh_TW/crypto/api-intromodnameN classnameN refexplicituh1hhh ubh)}(hhh]hItalian}hhFsbah}(h]h ]h"]h$]h&] refdomainh)reftypeh+ reftarget$/translations/it_IT/crypto/api-intromodnameN classnameN refexplicituh1hhh ubh)}(hhh]hJapanese}hhZsbah}(h]h ]h"]h$]h&] refdomainh)reftypeh+ reftarget$/translations/ja_JP/crypto/api-intromodnameN classnameN refexplicituh1hhh ubh)}(hhh]hKorean}hhnsbah}(h]h ]h"]h$]h&] refdomainh)reftypeh+ reftarget$/translations/ko_KR/crypto/api-intromodnameN classnameN refexplicituh1hhh ubh)}(hhh]hPortuguese (Brazilian)}hhsbah}(h]h ]h"]h$]h&] refdomainh)reftypeh+ reftarget$/translations/pt_BR/crypto/api-intromodnameN classnameN refexplicituh1hhh ubh)}(hhh]hSpanish}hhsbah}(h]h ]h"]h$]h&] refdomainh)reftypeh+ reftarget$/translations/sp_SP/crypto/api-intromodnameN classnameN refexplicituh1hhh ubeh}(h]h ]h"]h$]h&]current_languageEnglishuh1h hh _documenthsourceNlineNubhcomment)}(h SPDX-License-Identifier: GPL-2.0h]h SPDX-License-Identifier: GPL-2.0}hhsbah}(h]h ]h"]h$]h&] xml:spacepreserveuh1hhhhhh>/var/lib/git/docbuild/linux/Documentation/crypto/api-intro.rsthKubhsection)}(hhh](htitle)}(hScatterlist Cryptographic APIh]hScatterlist Cryptographic API}(hhhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhhhhhKubh)}(hhh](h)}(h Introductionh]h Introduction}(hhhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhhhhhKubh paragraph)}(hThe Scatterlist Crypto API takes page vectors (scatterlists) as arguments, and works directly on pages. In some cases (e.g. ECB mode ciphers), this will allow for pages to be encrypted in-place with no copying.h]hThe Scatterlist Crypto API takes page vectors (scatterlists) as arguments, and works directly on pages. In some cases (e.g. ECB mode ciphers), this will allow for pages to be encrypted in-place with no copying.}(hhhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK hhhhubh)}(hOne of the initial goals of this design was to readily support IPsec, so that processing can be applied to paged skb's without the need for linearization.h]hOne of the initial goals of this design was to readily support IPsec, so that processing can be applied to paged skb’s without the need for linearization.}(hhhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhhhhubeh}(h] introductionah ]h"] introductionah$]h&]uh1hhhhhhhhKubh)}(hhh](h)}(hDetailsh]hDetails}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhhhhhKubh)}(hLAt the lowest level are algorithms, which register dynamically with the API.h]hLAt the lowest level are algorithms, which register dynamically with the API.}(hj%hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjhhubh)}(h'Transforms' are user-instantiated objects, which maintain state, handle all of the implementation logic (e.g. manipulating page vectors) and provide an abstraction to the underlying algorithms. However, at the user level they are very simple.h]h‘Transforms’ are user-instantiated objects, which maintain state, handle all of the implementation logic (e.g. manipulating page vectors) and provide an abstraction to the underlying algorithms. However, at the user level they are very simple.}(hj3hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjhhubh)}(h0Conceptually, the API layering looks like this::h]h/Conceptually, the API layering looks like this:}(hjAhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjhhubh literal_block)}(h[transform api] (user interface) [transform ops] (per-type logic glue e.g. cipher.c, compress.c) [algorithm api] (for registering algorithms)h]h[transform api] (user interface) [transform ops] (per-type logic glue e.g. cipher.c, compress.c) [algorithm api] (for registering algorithms)}hjQsbah}(h]h ]h"]h$]h&]hhuh1jOhhhK!hjhhubh)}(hThe idea is to make the user interface and algorithm registration API very simple, while hiding the core logic from both. Many good ideas from existing APIs such as Cryptoapi and Nettle have been adapted for this.h]hThe idea is to make the user interface and algorithm registration API very simple, while hiding the core logic from both. Many good ideas from existing APIs such as Cryptoapi and Nettle have been adapted for this.}(hj_hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK%hjhhubh)}(hThe API currently supports five main types of transforms: AEAD (Authenticated Encryption with Associated Data), Block Ciphers, Ciphers, Compressors and Hashes.h]hThe API currently supports five main types of transforms: AEAD (Authenticated Encryption with Associated Data), Block Ciphers, Ciphers, Compressors and Hashes.}(hjmhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK)hjhhubh)}(hXPlease note that Block Ciphers is somewhat of a misnomer. It is in fact meant to support all ciphers including stream ciphers. The difference between Block Ciphers and Ciphers is that the latter operates on exactly one block while the former can operate on an arbitrary amount of data, subject to block size requirements (i.e., non-stream ciphers can only process multiples of blocks).h]hXPlease note that Block Ciphers is somewhat of a misnomer. It is in fact meant to support all ciphers including stream ciphers. The difference between Block Ciphers and Ciphers is that the latter operates on exactly one block while the former can operate on an arbitrary amount of data, subject to block size requirements (i.e., non-stream ciphers can only process multiples of blocks).}(hj{hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK-hjhhubh)}(h)Here's an example of how to use the API::h]h*Here’s an example of how to use the API:}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK4hjhhubjP)}(hX5#include #include #include struct scatterlist sg[2]; char result[128]; struct crypto_ahash *tfm; struct ahash_request *req; tfm = crypto_alloc_ahash("md5", 0, CRYPTO_ALG_ASYNC); if (IS_ERR(tfm)) fail(); /* ... set up the scatterlists ... */ req = ahash_request_alloc(tfm, GFP_ATOMIC); if (!req) fail(); ahash_request_set_callback(req, 0, NULL, NULL); ahash_request_set_crypt(req, sg, result, 2); if (crypto_ahash_digest(req)) fail(); ahash_request_free(req); crypto_free_ahash(tfm);h]hX5#include #include #include struct scatterlist sg[2]; char result[128]; struct crypto_ahash *tfm; struct ahash_request *req; tfm = crypto_alloc_ahash("md5", 0, CRYPTO_ALG_ASYNC); if (IS_ERR(tfm)) fail(); /* ... set up the scatterlists ... */ req = ahash_request_alloc(tfm, GFP_ATOMIC); if (!req) fail(); ahash_request_set_callback(req, 0, NULL, NULL); ahash_request_set_crypt(req, sg, result, 2); if (crypto_ahash_digest(req)) fail(); ahash_request_free(req); crypto_free_ahash(tfm);}hjsbah}(h]h ]h"]h$]h&]hhuh1jOhhhK6hjhhubh)}(hJMany real examples are available in the regression test module (tcrypt.c).h]hJMany real examples are available in the regression test module (tcrypt.c).}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKShjhhubeh}(h]detailsah ]h"]detailsah$]h&]uh1hhhhhhhhKubh)}(hhh](h)}(hDeveloper Notesh]hDeveloper Notes}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhhhhhKWubh)}(hTransforms may only be allocated in user context, and cryptographic methods may only be called from softirq and user contexts. For transforms with a setkey method it too should only be called from user context.h]hTransforms may only be allocated in user context, and cryptographic methods may only be called from softirq and user contexts. For transforms with a setkey method it too should only be called from user context.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKYhjhhubh)}(hWhen using the API for ciphers, performance will be optimal if each scatterlist contains data which is a multiple of the cipher's block size (typically 8 bytes). This prevents having to do any copying across non-aligned page fragment boundaries.h]hWhen using the API for ciphers, performance will be optimal if each scatterlist contains data which is a multiple of the cipher’s block size (typically 8 bytes). This prevents having to do any copying across non-aligned page fragment boundaries.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK^hjhhubeh}(h]developer-notesah ]h"]developer notesah$]h&]uh1hhhhhhhhKWubh)}(hhh](h)}(hAdding New Algorithmsh]hAdding New Algorithms}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhhhhhKeubh)}(hWhen submitting a new algorithm for inclusion, a mandatory requirement is that at least a few test vectors from known sources (preferably standards) be included.h]hWhen submitting a new algorithm for inclusion, a mandatory requirement is that at least a few test vectors from known sources (preferably standards) be included.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKghjhhubh)}(hConverting existing well known code is preferred, as it is more likely to have been reviewed and widely tested. If submitting code from LGPL sources, please consider changing the license to GPL (see section 3 of the LGPL).h]hConverting existing well known code is preferred, as it is more likely to have been reviewed and widely tested. If submitting code from LGPL sources, please consider changing the license to GPL (see section 3 of the LGPL).}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKkhjhhubh)}(hAlgorithms submitted must also be generally patent-free (e.g. IDEA will not be included in the mainline until around 2011), and be based on a recognized standard and/or have been subjected to appropriate peer review.h]hAlgorithms submitted must also be generally patent-free (e.g. IDEA will not be included in the mainline until around 2011), and be based on a recognized standard and/or have been subjected to appropriate peer review.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKphjhhubh)}(hAlso check for any RFCs which may relate to the use of specific algorithms, as well as general application notes such as RFC2451 ("The ESP CBC-Mode Cipher Algorithms").h]hAlso check for any RFCs which may relate to the use of specific algorithms, as well as general application notes such as RFC2451 (“The ESP CBC-Mode Cipher Algorithms”).}(hj+hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKuhjhhubh)}(hIt's a good idea to avoid using lots of macros and use inlined functions instead, as gcc does a good job with inlining, while excessive use of macros can cause compilation problems on some platforms.h]hIt’s a good idea to avoid using lots of macros and use inlined functions instead, as gcc does a good job with inlining, while excessive use of macros can cause compilation problems on some platforms.}(hj9hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKyhjhhubh)}(heAlso check the TODO list at the web site listed below to see what people might already be working on.h]heAlso check the TODO list at the web site listed below to see what people might already be working on.}(hjGhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK}hjhhubeh}(h]adding-new-algorithmsah ]h"]adding new algorithmsah$]h&]uh1hhhhhhhhKeubh)}(hhh](h)}(hBugsh]hBugs}(hj`hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj]hhhhhKubhdefinition_list)}(hhh](hdefinition_list_item)}(h2Send bug reports to: linux-crypto@vger.kernel.org h](hterm)}(hSend bug reports to:h]hSend bug reports to:}(hj{hhhNhNubah}(h]h ]h"]h$]h&]uh1jyhhhKhjuubh definition)}(hhh]h)}(hlinux-crypto@vger.kernel.orgh]h reference)}(hjh]hlinux-crypto@vger.kernel.org}(hjhhhNhNubah}(h]h ]h"]h$]h&]refuri#mailto:linux-crypto@vger.kernel.orguh1jhjubah}(h]h ]h"]h$]h&]uh1hhhhKhjubah}(h]h ]h"]h$]h&]uh1jhjuubeh}(h]h ]h"]h$]h&]uh1jshhhKhjpubjt)}(hRCc: Herbert Xu , David S. Miller h](jz)}(hCc:h]hCc:}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jyhhhKhjubj)}(hhh]h)}(hLHerbert Xu , David S. Miller h](h Herbert Xu <}(hjhhhNhNubj)}(hherbert@gondor.apana.org.auh]hherbert@gondor.apana.org.au}(hjhhhNhNubah}(h]h ]h"]h$]h&]refuri"mailto:herbert@gondor.apana.org.auuh1jhjubh>, David S. Miller <}(hjhhhNhNubj)}(hdavem@redhat.comh]hdavem@redhat.com}(hjhhhNhNubah}(h]h ]h"]h$]h&]refurimailto:davem@redhat.comuh1jhjubh>}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhhhKhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jshhhKhjphhubeh}(h]h ]h"]h$]h&]uh1jnhj]hhhhhNubeh}(h]bugsah ]h"]bugsah$]h&]uh1hhhhhhhhKubh)}(hhh](h)}(hFurther Informationh]hFurther Information}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhhhhhKubh)}(hzFor further patches and various updates, including the current TODO list, see: http://gondor.apana.org.au/~herbert/crypto/h](hOFor further patches and various updates, including the current TODO list, see: }(hj+hhhNhNubj)}(h+http://gondor.apana.org.au/~herbert/crypto/h]h+http://gondor.apana.org.au/~herbert/crypto/}(hj3hhhNhNubah}(h]h ]h"]h$]h&]refurij5uh1jhj+ubeh}(h]h ]h"]h$]h&]uh1hhhhKhjhhubeh}(h]further-informationah ]h"]further informationah$]h&]uh1hhhhhhhhKubh)}(hhh](h)}(hAuthorsh]hAuthors}(hjShhhNhNubah}(h]h ]h"]h$]h&]uh1hhjPhhhhhKubh bullet_list)}(hhh](h list_item)}(h James Morrish]h)}(hjjh]h James Morris}(hjlhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjhubah}(h]h ]h"]h$]h&]uh1jfhjchhhhhNubjg)}(hDavid S. Millerh]h)}(hjh]hDavid S. Miller}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjubah}(h]h ]h"]h$]h&]uh1jfhjchhhhhNubjg)}(h Herbert Xu h]h)}(h Herbert Xuh]h Herbert Xu}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjubah}(h]h ]h"]h$]h&]uh1jfhjchhhhhNubeh}(h]h ]h"]h$]h&]bullet-uh1jahhhKhjPhhubeh}(h]authorsah ]h"]authorsah$]h&]uh1hhhhhhhhKubh)}(hhh](h)}(hCreditsh]hCredits}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhhhhhKubh)}(hTThe following people provided invaluable feedback during the development of the API:h]hTThe following people provided invaluable feedback during the development of the API:}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjhhubh block_quote)}(h- Alexey Kuznetzov - Rusty Russell - Herbert Valerio Riedel - Jeff Garzik - Michael Richardson - Andrew Morton - Ingo Oeser - Christoph Hellwig h]jb)}(hhh](jg)}(hAlexey Kuznetzovh]h)}(hjh]hAlexey Kuznetzov}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjubah}(h]h ]h"]h$]h&]uh1jfhjubjg)}(h Rusty Russellh]h)}(hjh]h Rusty Russell}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjubah}(h]h ]h"]h$]h&]uh1jfhjubjg)}(hHerbert Valerio Riedelh]h)}(hjh]hHerbert Valerio Riedel}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjubah}(h]h ]h"]h$]h&]uh1jfhjubjg)}(h Jeff Garzikh]h)}(hj-h]h Jeff Garzik}(hj/hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhj+ubah}(h]h ]h"]h$]h&]uh1jfhjubjg)}(hMichael Richardsonh]h)}(hjDh]hMichael Richardson}(hjFhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjBubah}(h]h ]h"]h$]h&]uh1jfhjubjg)}(h Andrew Mortonh]h)}(hj[h]h Andrew Morton}(hj]hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjYubah}(h]h ]h"]h$]h&]uh1jfhjubjg)}(h Ingo Oeserh]h)}(hjrh]h Ingo Oeser}(hjthhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjpubah}(h]h ]h"]h$]h&]uh1jfhjubjg)}(hChristoph Hellwig h]h)}(hChristoph Hellwigh]hChristoph Hellwig}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjubah}(h]h ]h"]h$]h&]uh1jfhjubeh}(h]h ]h"]h$]h&]jjuh1jahhhKhjubah}(h]h ]h"]h$]h&]uh1jhhhKhjhhubh)}(h>Portions of this API were derived from the following projects:h]h>Portions of this API were derived from the following projects:}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjhhubj)}(hKerneli Cryptoapi (http://www.kerneli.org/) - Alexander Kjeldaas - Herbert Valerio Riedel - Kyle McMartin - Jean-Luc Cooke - David Bryson - Clemens Fruhwirth - Tobias Ringstrom - Harald Welte h]jo)}(hhh]jt)}(hKerneli Cryptoapi (http://www.kerneli.org/) - Alexander Kjeldaas - Herbert Valerio Riedel - Kyle McMartin - Jean-Luc Cooke - David Bryson - Clemens Fruhwirth - Tobias Ringstrom - Harald Welte h](jz)}(h+Kerneli Cryptoapi (http://www.kerneli.org/)h](hKerneli Cryptoapi (}(hjhhhNhNubj)}(hhttp://www.kerneli.org/h]hhttp://www.kerneli.org/}(hjhhhNhNubah}(h]h ]h"]h$]h&]refurijuh1jhjubh)}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1jyhhhKhjubj)}(hhh]jb)}(hhh](jg)}(hAlexander Kjeldaash]h)}(hjh]hAlexander Kjeldaas}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjubah}(h]h ]h"]h$]h&]uh1jfhjubjg)}(hHerbert Valerio Riedelh]h)}(hjh]hHerbert Valerio Riedel}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjubah}(h]h ]h"]h$]h&]uh1jfhjubjg)}(h Kyle McMartinh]h)}(hjh]h Kyle McMartin}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjubah}(h]h ]h"]h$]h&]uh1jfhjubjg)}(hJean-Luc Cookeh]h)}(hj2h]hJean-Luc Cooke}(hj4hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhj0ubah}(h]h ]h"]h$]h&]uh1jfhjubjg)}(h David Brysonh]h)}(hjIh]h David Bryson}(hjKhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjGubah}(h]h ]h"]h$]h&]uh1jfhjubjg)}(hClemens Fruhwirthh]h)}(hj`h]hClemens Fruhwirth}(hjbhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhj^ubah}(h]h ]h"]h$]h&]uh1jfhjubjg)}(hTobias Ringstromh]h)}(hjwh]hTobias Ringstrom}(hjyhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjuubah}(h]h ]h"]h$]h&]uh1jfhjubjg)}(h Harald Welte h]h)}(h Harald Welteh]h Harald Welte}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjubah}(h]h ]h"]h$]h&]uh1jfhjubeh}(h]h ]h"]h$]h&]jjuh1jahhhKhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jshhhKhjubah}(h]h ]h"]h$]h&]uh1jnhjubah}(h]h ]h"]h$]h&]uh1jhhhKhjhhubh)}(hand;h]hand;}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjhhubj)}(hDNettle (https://www.lysator.liu.se/~nisse/nettle/) - Niels Möller h]jo)}(hhh]jt)}(hCNettle (https://www.lysator.liu.se/~nisse/nettle/) - Niels Möller h](jz)}(h2Nettle (https://www.lysator.liu.se/~nisse/nettle/)h](hNettle (}(hjhhhNhNubj)}(h)https://www.lysator.liu.se/~nisse/nettle/h]h)https://www.lysator.liu.se/~nisse/nettle/}(hjhhhNhNubah}(h]h ]h"]h$]h&]refurijuh1jhjubh)}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1jyhhhKhjubj)}(hhh]jb)}(hhh]jg)}(hNiels Möller h]h)}(h Niels Möllerh]h Niels Möller}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjubah}(h]h ]h"]h$]h&]uh1jfhjubah}(h]h ]h"]h$]h&]jjuh1jahhhKhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jshhhKhjubah}(h]h ]h"]h$]h&]uh1jnhjubah}(h]h ]h"]h$]h&]uh1jhhhKhjhhubh)}(h-Original developers of the crypto algorithms:h]h-Original developers of the crypto algorithms:}(hj8hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjhhubj)}(hX- Dana L. How (DES) - Andrew Tridgell and Steve French (MD4) - Colin Plumb (MD5) - Steve Reid (SHA1) - Jean-Luc Cooke (SHA256, SHA384, SHA512) - Kazunori Miyazawa / USAGI (HMAC) - Matthew Skala (Twofish) - Dag Arne Osvik (Serpent) - Brian Gladman (AES) - Kartikey Mahendra Bhatt (CAST6) - Jon Oberheide (ARC4) - Jouni Malinen (Michael MIC) - NTT(Nippon Telegraph and Telephone Corporation) (Camellia) h]jb)}(hhh](jg)}(hDana L. How (DES)h]h)}(hjOh]hDana L. How (DES)}(hjQhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjMubah}(h]h ]h"]h$]h&]uh1jfhjJubjg)}(h&Andrew Tridgell and Steve French (MD4)h]h)}(hjfh]h&Andrew Tridgell and Steve French (MD4)}(hjhhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjdubah}(h]h ]h"]h$]h&]uh1jfhjJubjg)}(hColin Plumb (MD5)h]h)}(hj}h]hColin Plumb (MD5)}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhj{ubah}(h]h ]h"]h$]h&]uh1jfhjJubjg)}(hSteve Reid (SHA1)h]h)}(hjh]hSteve Reid (SHA1)}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjubah}(h]h ]h"]h$]h&]uh1jfhjJubjg)}(h'Jean-Luc Cooke (SHA256, SHA384, SHA512)h]h)}(hjh]h'Jean-Luc Cooke (SHA256, SHA384, SHA512)}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjubah}(h]h ]h"]h$]h&]uh1jfhjJubjg)}(h Kazunori Miyazawa / USAGI (HMAC)h]h)}(hjh]h Kazunori Miyazawa / USAGI (HMAC)}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjubah}(h]h ]h"]h$]h&]uh1jfhjJubjg)}(hMatthew Skala (Twofish)h]h)}(hjh]hMatthew Skala (Twofish)}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjubah}(h]h ]h"]h$]h&]uh1jfhjJubjg)}(hDag Arne Osvik (Serpent)h]h)}(hjh]hDag Arne Osvik (Serpent)}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjubah}(h]h ]h"]h$]h&]uh1jfhjJubjg)}(hBrian Gladman (AES)h]h)}(hjh]hBrian Gladman (AES)}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjubah}(h]h ]h"]h$]h&]uh1jfhjJubjg)}(hKartikey Mahendra Bhatt (CAST6)h]h)}(hjh]hKartikey Mahendra Bhatt (CAST6)}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjubah}(h]h ]h"]h$]h&]uh1jfhjJubjg)}(hJon Oberheide (ARC4)h]h)}(hj5h]hJon Oberheide (ARC4)}(hj7hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhj3ubah}(h]h ]h"]h$]h&]uh1jfhjJubjg)}(hJouni Malinen (Michael MIC)h]h)}(hjLh]hJouni Malinen (Michael MIC)}(hjNhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjJubah}(h]h ]h"]h$]h&]uh1jfhjJubjg)}(h;NTT(Nippon Telegraph and Telephone Corporation) (Camellia) h]h)}(h:NTT(Nippon Telegraph and Telephone Corporation) (Camellia)h]h:NTT(Nippon Telegraph and Telephone Corporation) (Camellia)}(hjehhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjaubah}(h]h ]h"]h$]h&]uh1jfhjJubeh}(h]h ]h"]h$]h&]jjuh1jahhhKhjFubah}(h]h ]h"]h$]h&]uh1jhhhKhjhhubjo)}(hhh](jt)}(h2SHA1 algorithm contributors: - Jean-Francois Dive h](jz)}(hSHA1 algorithm contributors:h]hSHA1 algorithm contributors:}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jyhhhKhjubj)}(hhh]jb)}(hhh]jg)}(hJean-Francois Dive h]h)}(hJean-Francois Diveh]hJean-Francois Dive}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjubah}(h]h ]h"]h$]h&]uh1jfhjubah}(h]h ]h"]h$]h&]jjuh1jahhhKhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jshhhKhjubjt)}(hPDES algorithm contributors: - Raimar Falke - Gisle Sælensminde - Niels Möller h](jz)}(hDES algorithm contributors:h]hDES algorithm contributors:}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jyhhhKhjubj)}(hhh]jb)}(hhh](jg)}(h Raimar Falkeh]h)}(hjh]h Raimar Falke}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjubah}(h]h ]h"]h$]h&]uh1jfhjubjg)}(hGisle Sælensmindeh]h)}(hjh]hGisle Sælensminde}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjubah}(h]h ]h"]h$]h&]uh1jfhjubjg)}(hNiels Möller h]h)}(h Niels Möllerh]h Niels Möller}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjubah}(h]h ]h"]h$]h&]uh1jfhjubeh}(h]h ]h"]h$]h&]jjuh1jahhhKhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jshhhKhjhhubjt)}(hJBlowfish algorithm contributors: - Herbert Valerio Riedel - Kyle McMartin h](jz)}(h Blowfish algorithm contributors:h]h Blowfish algorithm contributors:}(hj>hhhNhNubah}(h]h ]h"]h$]h&]uh1jyhhhKhj:ubj)}(hhh]jb)}(hhh](jg)}(hHerbert Valerio Riedelh]h)}(hjTh]hHerbert Valerio Riedel}(hjVhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjRubah}(h]h ]h"]h$]h&]uh1jfhjOubjg)}(hKyle McMartin h]h)}(h Kyle McMartinh]h Kyle McMartin}(hjmhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjiubah}(h]h ]h"]h$]h&]uh1jfhjOubeh}(h]h ]h"]h$]h&]jjuh1jahhhKhjLubah}(h]h ]h"]h$]h&]uh1jhj:ubeh}(h]h ]h"]h$]h&]uh1jshhhKhjhhubjt)}(h:Twofish algorithm contributors: - Werner Koch - Marc Mutz h](jz)}(hTwofish algorithm contributors:h]hTwofish algorithm contributors:}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jyhhhKhjubj)}(hhh]jb)}(hhh](jg)}(h Werner Kochh]h)}(hjh]h Werner Koch}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjubah}(h]h ]h"]h$]h&]uh1jfhjubjg)}(h Marc Mutz h]h)}(h Marc Mutzh]h Marc Mutz}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjubah}(h]h ]h"]h$]h&]uh1jfhjubeh}(h]h ]h"]h$]h&]jjuh1jahhhKhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jshhhKhjhhubjt)}(hbSHA256/384/512 algorithm contributors: - Andrew McDonald - Kyle McMartin - Herbert Valerio Riedel h](jz)}(h&SHA256/384/512 algorithm contributors:h]h&SHA256/384/512 algorithm contributors:}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jyhhhKhjubj)}(hhh]jb)}(hhh](jg)}(hAndrew McDonaldh]h)}(hj h]hAndrew McDonald}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhj ubah}(h]h ]h"]h$]h&]uh1jfhj ubjg)}(h Kyle McMartinh]h)}(hj h]h Kyle McMartin}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhj ubah}(h]h ]h"]h$]h&]uh1jfhj ubjg)}(hHerbert Valerio Riedel h]h)}(hHerbert Valerio Riedelh]hHerbert Valerio Riedel}(hj6 hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhj2 ubah}(h]h ]h"]h$]h&]uh1jfhj ubeh}(h]h ]h"]h$]h&]jjuh1jahhhKhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jshhhKhjhhubjt)}(hAES algorithm contributors: - Alexander Kjeldaas - Herbert Valerio Riedel - Kyle McMartin - Adam J. Richter - Fruhwirth Clemens (i586) - Linus Torvalds (i586) h](jz)}(hAES algorithm contributors:h]hAES algorithm contributors:}(hj` hhhNhNubah}(h]h ]h"]h$]h&]uh1jyhhhKhj\ ubj)}(hhh]jb)}(hhh](jg)}(hAlexander Kjeldaash]h)}(hjv h]hAlexander Kjeldaas}(hjx hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjt ubah}(h]h ]h"]h$]h&]uh1jfhjq ubjg)}(hHerbert Valerio Riedelh]h)}(hj h]hHerbert Valerio Riedel}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhj ubah}(h]h ]h"]h$]h&]uh1jfhjq ubjg)}(h Kyle McMartinh]h)}(hj h]h Kyle McMartin}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhj ubah}(h]h ]h"]h$]h&]uh1jfhjq ubjg)}(hAdam J. Richterh]h)}(hj h]hAdam J. Richter}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhj ubah}(h]h ]h"]h$]h&]uh1jfhjq ubjg)}(hFruhwirth Clemens (i586)h]h)}(hj h]hFruhwirth Clemens (i586)}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhj ubah}(h]h ]h"]h$]h&]uh1jfhjq ubjg)}(hLinus Torvalds (i586) h]h)}(hLinus Torvalds (i586)h]hLinus Torvalds (i586)}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhj ubah}(h]h ]h"]h$]h&]uh1jfhjq ubeh}(h]h ]h"]h$]h&]jjuh1jahhhKhjn ubah}(h]h ]h"]h$]h&]uh1jhj\ ubeh}(h]h ]h"]h$]h&]uh1jshhhKhjhhubjt)}(hfCAST5 algorithm contributors: - Kartikey Mahendra Bhatt (original developers unknown, FSF copyright). h](jz)}(hCAST5 algorithm contributors:h]hCAST5 algorithm contributors:}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jyhhhKhj ubj)}(hhh]jb)}(hhh]jg)}(hFKartikey Mahendra Bhatt (original developers unknown, FSF copyright). h]h)}(hEKartikey Mahendra Bhatt (original developers unknown, FSF copyright).h]hEKartikey Mahendra Bhatt (original developers unknown, FSF copyright).}(hj- hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhj) ubah}(h]h ]h"]h$]h&]uh1jfhj& ubah}(h]h ]h"]h$]h&]jjuh1jahhhKhj# ubah}(h]h ]h"]h$]h&]uh1jhj ubeh}(h]h ]h"]h$]h&]uh1jshhhKhjhhubjt)}(h@TEA/XTEA algorithm contributors: - Aaron Grothe - Michael Ringe h](jz)}(h TEA/XTEA algorithm contributors:h]h TEA/XTEA algorithm contributors:}(hjW hhhNhNubah}(h]h ]h"]h$]h&]uh1jyhhhKhjS ubj)}(hhh]jb)}(hhh](jg)}(h Aaron Grotheh]h)}(hjm h]h Aaron Grothe}(hjo hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjk ubah}(h]h ]h"]h$]h&]uh1jfhjh ubjg)}(hMichael Ringe h]h)}(h Michael Ringeh]h Michael Ringe}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhj ubah}(h]h ]h"]h$]h&]uh1jfhjh ubeh}(h]h ]h"]h$]h&]jjuh1jahhhKhje ubah}(h]h ]h"]h$]h&]uh1jhjS ubeh}(h]h ]h"]h$]h&]uh1jshhhKhjhhubjt)}(h.Khazad algorithm contributors: - Aaron Grothe h](jz)}(hKhazad algorithm contributors:h]hKhazad algorithm contributors:}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jyhhhKhj ubj)}(hhh]jb)}(hhh]jg)}(h Aaron Grothe h]h)}(h Aaron Grotheh]h Aaron Grothe}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhj ubah}(h]h ]h"]h$]h&]uh1jfhj ubah}(h]h ]h"]h$]h&]jjuh1jahhhKhj ubah}(h]h ]h"]h$]h&]uh1jhj ubeh}(h]h ]h"]h$]h&]uh1jshhhKhjhhubjt)}(hBWhirlpool algorithm contributors: - Aaron Grothe - Jean-Luc Cooke h](jz)}(h!Whirlpool algorithm contributors:h]h!Whirlpool algorithm contributors:}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jyhhhKhj ubj)}(hhh]jb)}(hhh](jg)}(h Aaron Grotheh]h)}(hj h]h Aaron Grothe}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhj ubah}(h]h ]h"]h$]h&]uh1jfhj ubjg)}(hJean-Luc Cooke h]h)}(hJean-Luc Cookeh]hJean-Luc Cooke}(hj! hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhj ubah}(h]h ]h"]h$]h&]uh1jfhj ubeh}(h]h ]h"]h$]h&]jjuh1jahhhKhj ubah}(h]h ]h"]h$]h&]uh1jhj ubeh}(h]h ]h"]h$]h&]uh1jshhhKhjhhubjt)}(h.Anubis algorithm contributors: - Aaron Grothe h](jz)}(hAnubis algorithm contributors:h]hAnubis algorithm contributors:}(hjK hhhNhNubah}(h]h ]h"]h$]h&]uh1jyhhhKhjG ubj)}(hhh]jb)}(hhh]jg)}(h Aaron Grothe h]h)}(h Aaron Grotheh]h Aaron Grothe}(hjc hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhj_ ubah}(h]h ]h"]h$]h&]uh1jfhj\ ubah}(h]h ]h"]h$]h&]jjuh1jahhhKhjY ubah}(h]h ]h"]h$]h&]uh1jhjG ubeh}(h]h ]h"]h$]h&]uh1jshhhKhjhhubjt)}(h-Tiger algorithm contributors: - Aaron Grothe h](jz)}(hTiger algorithm contributors:h]hTiger algorithm contributors:}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jyhhhKhj ubj)}(hhh]jb)}(hhh]jg)}(h Aaron Grothe h]h)}(h Aaron Grotheh]h Aaron Grothe}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhj ubah}(h]h ]h"]h$]h&]uh1jfhj ubah}(h]h ]h"]h$]h&]jjuh1jahhhKhj ubah}(h]h ]h"]h$]h&]uh1jhj ubeh}(h]h ]h"]h$]h&]uh1jshhhKhjhhubjt)}(h*VIA PadLock contributors: - Michal Ludvig h](jz)}(hVIA PadLock contributors:h]hVIA PadLock contributors:}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jyhhhKhj ubj)}(hhh]jb)}(hhh]jg)}(hMichal Ludvig h]h)}(h Michal Ludvigh]h Michal Ludvig}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhj ubah}(h]h ]h"]h$]h&]uh1jfhj ubah}(h]h ]h"]h$]h&]jjuh1jahhhKhj ubah}(h]h ]h"]h$]h&]uh1jhj ubeh}(h]h ]h"]h$]h&]uh1jshhhKhjhhubjt)}(h^Camellia algorithm contributors: - NTT(Nippon Telegraph and Telephone Corporation) (Camellia) h](jz)}(h Camellia algorithm contributors:h]h Camellia algorithm contributors:}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jyhhhMhj ubj)}(hhh]jb)}(hhh]jg)}(h;NTT(Nippon Telegraph and Telephone Corporation) (Camellia) h]h)}(h:NTT(Nippon Telegraph and Telephone Corporation) (Camellia)h]h:NTT(Nippon Telegraph and Telephone Corporation) (Camellia)}(hj) hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMhj% ubah}(h]h ]h"]h$]h&]uh1jfhj" ubah}(h]h ]h"]h$]h&]jjuh1jahhhMhj ubah}(h]h ]h"]h$]h&]uh1jhj ubeh}(h]h ]h"]h$]h&]uh1jshhhMhjhhubeh}(h]h ]h"]h$]h&]uh1jnhjhhhNhNubh)}(h@Generic scatterwalk code by Adam J. Richter h](h-Generic scatterwalk code by Adam J. Richter <}(hjU hhhNhNubj)}(hadam@yggdrasil.comh]hadam@yggdrasil.com}(hj] hhhNhNubah}(h]h ]h"]h$]h&]refurimailto:adam@yggdrasil.comuh1jhjU ubh>}(hjU hhhNhNubeh}(h]h ]h"]h$]h&]uh1hhhhMhjhhubh)}(h[Please send any credits updates or corrections to: Herbert Xu h](h?Please send any credits updates or corrections to: Herbert Xu <}(hjw hhhNhNubj)}(hherbert@gondor.apana.org.auh]hherbert@gondor.apana.org.au}(hj hhhNhNubah}(h]h ]h"]h$]h&]refuri"mailto:herbert@gondor.apana.org.auuh1jhjw ubh>}(hjw hhhNhNubeh}(h]h ]h"]h$]h&]uh1hhhhMhjhhubeh}(h]creditsah ]h"]creditsah$]h&]uh1hhhhhhhhKubeh}(h]scatterlist-cryptographic-apiah ]h"]scatterlist cryptographic apiah$]h&]uh1hhhhhhhhKubeh}(h]h ]h"]h$]h&]sourcehuh1hcurrent_sourceN current_lineNsettingsdocutils.frontendValues)}(hN generatorN datestampN source_linkN source_urlN toc_backlinksentryfootnote_backlinksK sectnum_xformKstrip_commentsNstrip_elements_with_classesN strip_classesN report_levelK halt_levelKexit_status_levelKdebugNwarning_streamN tracebackinput_encoding utf-8-siginput_encoding_error_handlerstrictoutput_encodingutf-8output_encoding_error_handlerj error_encodingutf-8error_encoding_error_handlerbackslashreplace language_codeenrecord_dependenciesNconfigN id_prefixhauto_id_prefixid dump_settingsNdump_internalsNdump_transformsNdump_pseudo_xmlNexpose_internalsNstrict_visitorN_disable_configN_sourcehnj _destinationN _config_files]7/var/lib/git/docbuild/linux/Documentation/docutils.confafile_insertion_enabled raw_enabledKline_length_limitM'pep_referencesN pep_base_urlhttps://peps.python.org/pep_file_url_templatepep-%04drfc_referencesN rfc_base_url&https://datatracker.ietf.org/doc/html/ tab_widthKtrim_footnote_reference_spacesyntax_highlightlong smart_quotessmartquotes_locales]character_level_inline_markupdoctitle_xform docinfo_xformKsectsubtitle_xform image_loadinglinkembed_stylesheetcloak_email_addressessection_self_linkenvNubreporterNindirect_targets]substitution_defs}substitution_names}refnames}refids}nameids}(j j jjjjjjjZjWjjjMjJjjj j u nametypes}(j jjjjZjjMjj uh}(j hjhjjjjjWjjj]jJjjjPj ju footnote_refs} citation_refs} autofootnotes]autofootnote_refs]symbol_footnotes]symbol_footnote_refs] footnotes] citations]autofootnote_startKsymbol_footnote_startK id_counter collectionsCounter}Rparse_messages]transform_messages] transformerN include_log] decorationNhhub.