mirror of
https://gitlab.com/cryptsetup/cryptsetup.git
synced 2025-12-13 20:00:08 +01:00
09d14a0b6c
The Argon2i/id is a password hashing function that won Password Hashing Competiton. It will be (optionally) used in LUKS2 for passworrd-based key derivation. We have to bundle code for now (similar PBKDF2 years ago) because there is yet no usable implementation in common crypto libraries. (Once there is native implementation, cryptsetup will switch to the crypto library version.) For now, we use reference (not optimized but portable) implementation. This patch contains bundled Argon2 algorithm library copied from https://github.com/P-H-C/phc-winner-argon2 For more info see Password Hashing Competition site: https://password-hashing.net/ and draft of RFC document https://datatracker.ietf.org/doc/draft-irtf-cfrg-argon2/ Signed-off-by: Milan Broz <gmazyland@gmail.com>
68 lines
2.3 KiB
C
68 lines
2.3 KiB
C
/*
|
|
* Argon2 reference source code package - reference C implementations
|
|
*
|
|
* Copyright 2015
|
|
* Daniel Dinu, Dmitry Khovratovich, Jean-Philippe Aumasson, and Samuel Neves
|
|
*
|
|
* You may use this work under the terms of a Creative Commons CC0 1.0
|
|
* License/Waiver or the Apache Public License 2.0, at your option. The terms of
|
|
* these licenses can be found at:
|
|
*
|
|
* - CC0 1.0 Universal : http://creativecommons.org/publicdomain/zero/1.0
|
|
* - Apache 2.0 : http://www.apache.org/licenses/LICENSE-2.0
|
|
*
|
|
* You should have received a copy of both of these licenses along with this
|
|
* software. If not, they may be obtained at the above URLs.
|
|
*/
|
|
|
|
#ifndef ARGON2_THREAD_H
|
|
#define ARGON2_THREAD_H
|
|
|
|
#if !defined(ARGON2_NO_THREADS)
|
|
|
|
/*
|
|
Here we implement an abstraction layer for the simpĺe requirements
|
|
of the Argon2 code. We only require 3 primitives---thread creation,
|
|
joining, and termination---so full emulation of the pthreads API
|
|
is unwarranted. Currently we wrap pthreads and Win32 threads.
|
|
|
|
The API defines 2 types: the function pointer type,
|
|
argon2_thread_func_t,
|
|
and the type of the thread handle---argon2_thread_handle_t.
|
|
*/
|
|
#if defined(_WIN32)
|
|
#include <process.h>
|
|
typedef unsigned(__stdcall *argon2_thread_func_t)(void *);
|
|
typedef uintptr_t argon2_thread_handle_t;
|
|
#else
|
|
#include <pthread.h>
|
|
typedef void *(*argon2_thread_func_t)(void *);
|
|
typedef pthread_t argon2_thread_handle_t;
|
|
#endif
|
|
|
|
/* Creates a thread
|
|
* @param handle pointer to a thread handle, which is the output of this
|
|
* function. Must not be NULL.
|
|
* @param func A function pointer for the thread's entry point. Must not be
|
|
* NULL.
|
|
* @param args Pointer that is passed as an argument to @func. May be NULL.
|
|
* @return 0 if @handle and @func are valid pointers and a thread is successfuly
|
|
* created.
|
|
*/
|
|
int argon2_thread_create(argon2_thread_handle_t *handle,
|
|
argon2_thread_func_t func, void *args);
|
|
|
|
/* Waits for a thread to terminate
|
|
* @param handle Handle to a thread created with argon2_thread_create.
|
|
* @return 0 if @handle is a valid handle, and joining completed successfully.
|
|
*/
|
|
int argon2_thread_join(argon2_thread_handle_t handle);
|
|
|
|
/* Terminate the current thread. Must be run inside a thread created by
|
|
* argon2_thread_create.
|
|
*/
|
|
void argon2_thread_exit(void);
|
|
|
|
#endif /* ARGON2_NO_THREADS */
|
|
#endif
|