VirtualBox

source: vbox/trunk/include/iprt/md4.h@ 103224

Last change on this file since 103224 was 98103, checked in by vboxsync, 21 months ago

Copyright year updates by scm.

  • Property svn:eol-style set to native
  • Property svn:keywords set to Author Date Id Revision
File size: 4.2 KB
Line 
1/** @file
2 * IPRT - Message-Digest Algorithm 4.
3 */
4
5/*
6 * Copyright (C) 2006-2023 Oracle and/or its affiliates.
7 *
8 * This file is part of VirtualBox base platform packages, as
9 * available from https://www.virtualbox.org.
10 *
11 * This program is free software; you can redistribute it and/or
12 * modify it under the terms of the GNU General Public License
13 * as published by the Free Software Foundation, in version 3 of the
14 * License.
15 *
16 * This program is distributed in the hope that it will be useful, but
17 * WITHOUT ANY WARRANTY; without even the implied warranty of
18 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
19 * General Public License for more details.
20 *
21 * You should have received a copy of the GNU General Public License
22 * along with this program; if not, see <https://www.gnu.org/licenses>.
23 *
24 * The contents of this file may alternatively be used under the terms
25 * of the Common Development and Distribution License Version 1.0
26 * (CDDL), a copy of it is provided in the "COPYING.CDDL" file included
27 * in the VirtualBox distribution, in which case the provisions of the
28 * CDDL are applicable instead of those of the GPL.
29 *
30 * You may elect to license modified versions of this file under the
31 * terms and conditions of either the GPL or the CDDL or both.
32 *
33 * SPDX-License-Identifier: GPL-3.0-only OR CDDL-1.0
34 */
35
36#ifndef IPRT_INCLUDED_md4_h
37#define IPRT_INCLUDED_md4_h
38#ifndef RT_WITHOUT_PRAGMA_ONCE
39# pragma once
40#endif
41
42#include <iprt/types.h>
43
44RT_C_DECLS_BEGIN
45
46/** @defgroup grp_rt_md4 RTMd4 - Message-Digest algorithm 4
47 * @ingroup grp_rt
48 *
49 * @note This is just for backwards compatibility and completeness.
50 *
51 * @{
52 */
53
54/** Size of a MD4 hash. */
55#define RTMD4_HASH_SIZE 16
56/** The length of a MD4 digest string. The terminator is not included. */
57#define RTMD4_DIGEST_LEN 32
58
59/**
60 * MD4 hash algorithm context.
61 */
62typedef union RTMD4CONTEXT
63{
64 uint64_t u64BetterAlignment;
65 uint8_t abPadding[22*4 + 64 + 8];
66#ifdef RT_MD4_PRIVATE_CONTEXT
67 MD4_CTX Private;
68#endif
69#ifdef RT_MD4_PRIVATE_ALT_CONTEXT
70 RTMD4ALTPRIVATECTX AltPrivate;
71#endif
72} RTMD4CONTEXT;
73
74/** Pointer to MD4 hash algorithm context. */
75typedef RTMD4CONTEXT *PRTMD4CONTEXT;
76
77
78/**
79 * Compute the MD4 hash of the data.
80 *
81 * @param pvBuf Pointer to data.
82 * @param cbBuf Length of data (in bytes).
83 * @param pabDigest Where to store the hash.
84 * (What's passed is a pointer to the caller's buffer.)
85 */
86RTDECL(void) RTMd4(const void *pvBuf, size_t cbBuf, uint8_t pabDigest[RTMD4_HASH_SIZE]);
87
88/**
89 * Initialize MD4 context.
90 *
91 * @param pCtx Pointer to the MD4 context to initialize.
92 */
93RTDECL(void) RTMd4Init(PRTMD4CONTEXT pCtx);
94
95/**
96 * Feed data into the MD4 computation.
97 *
98 * @param pCtx Pointer to the MD4 context.
99 * @param pvBuf Pointer to data.
100 * @param cbBuf Length of data (in bytes).
101 */
102RTDECL(void) RTMd4Update(PRTMD4CONTEXT pCtx, const void *pvBuf, size_t cbBuf);
103
104/**
105 * Compute the MD4 hash of the data.
106 *
107 * @param pCtx Pointer to the MD4 context.
108 * @param pabDigest Where to store the hash. (What's passed is a pointer to
109 * the caller's buffer.)
110 */
111RTDECL(void) RTMd4Final(PRTMD4CONTEXT pCtx, uint8_t pabDigest[RTMD4_HASH_SIZE]);
112
113/**
114 * Converts a MD4 hash to a digest string.
115 *
116 * @returns IPRT status code.
117 *
118 * @param pabDigest The binary digest returned by RTMd4Final or RTMd4.
119 * @param pszDigest Where to return the stringified digest.
120 * @param cchDigest The size of the output buffer. Should be at least
121 * RTMD4_STRING_LEN + 1 bytes.
122 */
123RTDECL(int) RTMd4ToString(uint8_t const pabDigest[RTMD4_HASH_SIZE], char *pszDigest, size_t cchDigest);
124
125/**
126 * Converts a MD4 hash to a digest string.
127 *
128 * @returns IPRT status code.
129 *
130 * @param pszDigest The stringified digest. Leading and trailing spaces are
131 * ignored.
132 * @param pabDigest Where to store the hash. (What is passed is a pointer to
133 * the caller's buffer.)
134 */
135RTDECL(int) RTMd4FromString(char const *pszDigest, uint8_t pabDigest[RTMD4_HASH_SIZE]);
136
137/** @} */
138
139RT_C_DECLS_END
140
141#endif /* !IPRT_INCLUDED_md4_h */
142
Note: See TracBrowser for help on using the repository browser.

© 2024 Oracle Support Privacy / Do Not Sell My Info Terms of Use Trademark Policy Automated Access Etiquette