| Paul Bakker | 37ca75d | 2011-01-06 12:28:03 +0000 | [diff] [blame] | 1 | /** |
| 2 | * @file |
| 3 | * Hashing module documentation file. |
| 4 | */ |
| 5 | |
| 6 | /** |
| 7 | * @addtogroup hashing_module Hashing module |
| Paul Bakker | dcbfdcc | 2013-09-10 16:16:50 +0200 | [diff] [blame] | 8 | * |
| Paul Bakker | 37ca75d | 2011-01-06 12:28:03 +0000 | [diff] [blame] | 9 | * The Hashing module provides one-way hashing functions. Such functions can be |
| Paul Bakker | dcbfdcc | 2013-09-10 16:16:50 +0200 | [diff] [blame] | 10 | * used for creating a hash message authentication code (HMAC) when sending a |
| Paul Bakker | 37ca75d | 2011-01-06 12:28:03 +0000 | [diff] [blame] | 11 | * message. Such a HMAC can be used in combination with a private key |
| Paul Bakker | dcbfdcc | 2013-09-10 16:16:50 +0200 | [diff] [blame] | 12 | * for authentication, which is a message integrity control. |
| 13 | * |
| 14 | * All hash algorithms can be accessed via the generic MD layer (see |
| 15 | * \c md_init_ctx()) |
| 16 | * |
| Paul Bakker | 37ca75d | 2011-01-06 12:28:03 +0000 | [diff] [blame] | 17 | * The following hashing-algorithms are provided: |
| Manuel Pégourié-Gonnard | d4b9173 | 2015-03-25 16:25:23 +0100 | [diff] [blame^] | 18 | * - MD2, MD4, MD5 128-bit one-way hash functions by Ron Rivest. |
| Paul Bakker | dcbfdcc | 2013-09-10 16:16:50 +0200 | [diff] [blame] | 19 | * - SHA-1, SHA-256, SHA-384/512 160-bit or more one-way hash functions by |
| Manuel Pégourié-Gonnard | d4b9173 | 2015-03-25 16:25:23 +0100 | [diff] [blame^] | 20 | * NIST and NSA. |
| Paul Bakker | 37ca75d | 2011-01-06 12:28:03 +0000 | [diff] [blame] | 21 | * |
| 22 | * This module provides one-way hashing which can be used for authentication. |
| 23 | */ |