47 lines
1.6 KiB
C
47 lines
1.6 KiB
C
#ifndef ARGON2_THREAD_H
|
|
#define ARGON2_THREAD_H
|
|
/*
|
|
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>
|
|
#include <stdint.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
|