4 * \brief MD4 message digest algorithm (hash function)
6 * \warning MD4 is considered a weak message digest and its use constitutes a
7 * security risk. We recommend considering stronger message digests
11 * Copyright (C) 2006-2015, ARM Limited, All Rights Reserved
12 * SPDX-License-Identifier: Apache-2.0
14 * Licensed under the Apache License, Version 2.0 (the "License"); you may
15 * not use this file except in compliance with the License.
16 * You may obtain a copy of the License at
18 * http://www.apache.org/licenses/LICENSE-2.0
20 * Unless required by applicable law or agreed to in writing, software
21 * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
22 * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
23 * See the License for the specific language governing permissions and
24 * limitations under the License.
26 * This file is part of mbed TLS (https://tls.mbed.org)
32 #if !defined(MBEDTLS_CONFIG_FILE)
35 #include MBEDTLS_CONFIG_FILE
41 /* MBEDTLS_ERR_MD4_HW_ACCEL_FAILED is deprecated and should not be used. */
42 #define MBEDTLS_ERR_MD4_HW_ACCEL_FAILED -0x002D /**< MD4 hardware accelerator failed */
48 #if !defined(MBEDTLS_MD4_ALT)
49 // Regular implementation
53 * \brief MD4 context structure
55 * \warning MD4 is considered a weak message digest and its use
56 * constitutes a security risk. We recommend considering
57 * stronger message digests instead.
60 typedef struct mbedtls_md4_context
62 uint32_t total[2]; /*!< number of bytes processed */
63 uint32_t state[4]; /*!< intermediate digest state */
64 unsigned char buffer[64]; /*!< data block being processed */
68 #else /* MBEDTLS_MD4_ALT */
70 #endif /* MBEDTLS_MD4_ALT */
73 * \brief Initialize MD4 context
75 * \param ctx MD4 context to be initialized
77 * \warning MD4 is considered a weak message digest and its use
78 * constitutes a security risk. We recommend considering
79 * stronger message digests instead.
82 void mbedtls_md4_init( mbedtls_md4_context *ctx );
85 * \brief Clear MD4 context
87 * \param ctx MD4 context to be cleared
89 * \warning MD4 is considered a weak message digest and its use
90 * constitutes a security risk. We recommend considering
91 * stronger message digests instead.
94 void mbedtls_md4_free( mbedtls_md4_context *ctx );
97 * \brief Clone (the state of) an MD4 context
99 * \param dst The destination context
100 * \param src The context to be cloned
102 * \warning MD4 is considered a weak message digest and its use
103 * constitutes a security risk. We recommend considering
104 * stronger message digests instead.
107 void mbedtls_md4_clone( mbedtls_md4_context *dst,
108 const mbedtls_md4_context *src );
111 * \brief MD4 context setup
113 * \param ctx context to be initialized
115 * \return 0 if successful
117 * \warning MD4 is considered a weak message digest and its use
118 * constitutes a security risk. We recommend considering
119 * stronger message digests instead.
121 int mbedtls_md4_starts_ret( mbedtls_md4_context *ctx );
124 * \brief MD4 process buffer
126 * \param ctx MD4 context
127 * \param input buffer holding the data
128 * \param ilen length of the input data
130 * \return 0 if successful
132 * \warning MD4 is considered a weak message digest and its use
133 * constitutes a security risk. We recommend considering
134 * stronger message digests instead.
137 int mbedtls_md4_update_ret( mbedtls_md4_context *ctx,
138 const unsigned char *input,
142 * \brief MD4 final digest
144 * \param ctx MD4 context
145 * \param output MD4 checksum result
147 * \return 0 if successful
149 * \warning MD4 is considered a weak message digest and its use
150 * constitutes a security risk. We recommend considering
151 * stronger message digests instead.
154 int mbedtls_md4_finish_ret( mbedtls_md4_context *ctx,
155 unsigned char output[16] );
158 * \brief MD4 process data block (internal use only)
160 * \param ctx MD4 context
161 * \param data buffer holding one block of data
163 * \return 0 if successful
165 * \warning MD4 is considered a weak message digest and its use
166 * constitutes a security risk. We recommend considering
167 * stronger message digests instead.
170 int mbedtls_internal_md4_process( mbedtls_md4_context *ctx,
171 const unsigned char data[64] );
173 #if !defined(MBEDTLS_DEPRECATED_REMOVED)
174 #if defined(MBEDTLS_DEPRECATED_WARNING)
175 #define MBEDTLS_DEPRECATED __attribute__((deprecated))
177 #define MBEDTLS_DEPRECATED
180 * \brief MD4 context setup
182 * \deprecated Superseded by mbedtls_md4_starts_ret() in 2.7.0
184 * \param ctx context to be initialized
186 * \warning MD4 is considered a weak message digest and its use
187 * constitutes a security risk. We recommend considering
188 * stronger message digests instead.
191 MBEDTLS_DEPRECATED void mbedtls_md4_starts( mbedtls_md4_context *ctx );
194 * \brief MD4 process buffer
196 * \deprecated Superseded by mbedtls_md4_update_ret() in 2.7.0
198 * \param ctx MD4 context
199 * \param input buffer holding the data
200 * \param ilen length of the input data
202 * \warning MD4 is considered a weak message digest and its use
203 * constitutes a security risk. We recommend considering
204 * stronger message digests instead.
207 MBEDTLS_DEPRECATED void mbedtls_md4_update( mbedtls_md4_context *ctx,
208 const unsigned char *input,
212 * \brief MD4 final digest
214 * \deprecated Superseded by mbedtls_md4_finish_ret() in 2.7.0
216 * \param ctx MD4 context
217 * \param output MD4 checksum result
219 * \warning MD4 is considered a weak message digest and its use
220 * constitutes a security risk. We recommend considering
221 * stronger message digests instead.
224 MBEDTLS_DEPRECATED void mbedtls_md4_finish( mbedtls_md4_context *ctx,
225 unsigned char output[16] );
228 * \brief MD4 process data block (internal use only)
230 * \deprecated Superseded by mbedtls_internal_md4_process() in 2.7.0
232 * \param ctx MD4 context
233 * \param data buffer holding one block of data
235 * \warning MD4 is considered a weak message digest and its use
236 * constitutes a security risk. We recommend considering
237 * stronger message digests instead.
240 MBEDTLS_DEPRECATED void mbedtls_md4_process( mbedtls_md4_context *ctx,
241 const unsigned char data[64] );
243 #undef MBEDTLS_DEPRECATED
244 #endif /* !MBEDTLS_DEPRECATED_REMOVED */
247 * \brief Output = MD4( input buffer )
249 * \param input buffer holding the data
250 * \param ilen length of the input data
251 * \param output MD4 checksum result
253 * \return 0 if successful
255 * \warning MD4 is considered a weak message digest and its use
256 * constitutes a security risk. We recommend considering
257 * stronger message digests instead.
260 int mbedtls_md4_ret( const unsigned char *input,
262 unsigned char output[16] );
264 #if !defined(MBEDTLS_DEPRECATED_REMOVED)
265 #if defined(MBEDTLS_DEPRECATED_WARNING)
266 #define MBEDTLS_DEPRECATED __attribute__((deprecated))
268 #define MBEDTLS_DEPRECATED
271 * \brief Output = MD4( input buffer )
273 * \deprecated Superseded by mbedtls_md4_ret() in 2.7.0
275 * \param input buffer holding the data
276 * \param ilen length of the input data
277 * \param output MD4 checksum result
279 * \warning MD4 is considered a weak message digest and its use
280 * constitutes a security risk. We recommend considering
281 * stronger message digests instead.
284 MBEDTLS_DEPRECATED void mbedtls_md4( const unsigned char *input,
286 unsigned char output[16] );
288 #undef MBEDTLS_DEPRECATED
289 #endif /* !MBEDTLS_DEPRECATED_REMOVED */
291 #if defined(MBEDTLS_SELF_TEST)
294 * \brief Checkup routine
296 * \return 0 if successful, or 1 if the test failed
298 * \warning MD4 is considered a weak message digest and its use
299 * constitutes a security risk. We recommend considering
300 * stronger message digests instead.
303 int mbedtls_md4_self_test( int verbose );
305 #endif /* MBEDTLS_SELF_TEST */
311 #endif /* mbedtls_md4.h */