VirtualBox

source: vbox/trunk/include/iprt/crypto/misc.h@ 94480

Last change on this file since 94480 was 93115, checked in by vboxsync, 3 years ago

scm --update-copyright-year

  • Property svn:eol-style set to native
  • Property svn:keywords set to Author Date Id Revision
File size: 2.2 KB
Line 
1/** @file
2 * IPRT - Crypto - Miscellaneous.
3 */
4
5/*
6 * Copyright (C) 2018-2022 Oracle Corporation
7 *
8 * This file is part of VirtualBox Open Source Edition (OSE), as
9 * available from http://www.virtualbox.org. This file is free software;
10 * you can redistribute it and/or modify it under the terms of the GNU
11 * General Public License (GPL) as published by the Free Software
12 * Foundation, in version 2 as it comes in the "COPYING" file of the
13 * VirtualBox OSE distribution. VirtualBox OSE is distributed in the
14 * hope that it will be useful, but WITHOUT ANY WARRANTY of any kind.
15 *
16 * The contents of this file may alternatively be used under the terms
17 * of the Common Development and Distribution License Version 1.0
18 * (CDDL) only, as it comes in the "COPYING.CDDL" file of the
19 * VirtualBox OSE distribution, in which case the provisions of the
20 * CDDL are applicable instead of those of the GPL.
21 *
22 * You may elect to license modified versions of this file under the
23 * terms and conditions of either the GPL or the CDDL or both.
24 */
25
26#ifndef IPRT_INCLUDED_crypto_misc_h
27#define IPRT_INCLUDED_crypto_misc_h
28#ifndef RT_WITHOUT_PRAGMA_ONCE
29# pragma once
30#endif
31
32#include <iprt/types.h>
33
34
35RT_C_DECLS_BEGIN
36
37/** @defgroup grp_rt_crmisc RTCrMisc - Miscellaneous
38 * @ingroup grp_rt_crypto
39 * @{
40 */
41
42/**
43 * Get cryptographically strong random bytes.
44 *
45 * The buffer will always be filled with random bytes, however only
46 * on @c VINF_SUCCESS is it guaranteed to be strong random bytes.
47 *
48 * @retval VINF_SUCCESS
49 * @retval VERR_CR_RANDOM_FAILED if insufficient strong random bytes or some similar failure.
50 * @retval VERR_CR_RANDOM_SETUP_FAILED if setting up strong random failed
51 * and no strong bytes returned.
52 *
53 * @param pvDst Where to return the random bytes.
54 * @param cbDst How many random bytes to return.
55 */
56RTDECL(int) RTCrRandBytes(void *pvDst, size_t cbDst);
57
58RTDECL(int) RTCrPkcs5Pbkdf2Hmac(void const *pvInput, size_t cbInput, void const *pvSalt, size_t cbSalt, uint32_t cIterations,
59 RTDIGESTTYPE enmDigestType, size_t cbKeyLen, void *pvOutput);
60
61/** @} */
62
63RT_C_DECLS_END
64
65#endif /* !IPRT_INCLUDED_crypto_misc_h */
66
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