mirror of
https://gitlab.com/cryptsetup/cryptsetup.git
synced 2025-12-06 00:10:04 +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>
58 lines
2.0 KiB
C
58 lines
2.0 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 ENCODING_H
|
|
#define ENCODING_H
|
|
#include "argon2.h"
|
|
|
|
#define ARGON2_MAX_DECODED_LANES UINT32_C(255)
|
|
#define ARGON2_MIN_DECODED_SALT_LEN UINT32_C(8)
|
|
#define ARGON2_MIN_DECODED_OUT_LEN UINT32_C(12)
|
|
|
|
/*
|
|
* encode an Argon2 hash string into the provided buffer. 'dst_len'
|
|
* contains the size, in characters, of the 'dst' buffer; if 'dst_len'
|
|
* is less than the number of required characters (including the
|
|
* terminating 0), then this function returns ARGON2_ENCODING_ERROR.
|
|
*
|
|
* on success, ARGON2_OK is returned.
|
|
*/
|
|
int encode_string(char *dst, size_t dst_len, argon2_context *ctx,
|
|
argon2_type type);
|
|
|
|
/*
|
|
* Decodes an Argon2 hash string into the provided structure 'ctx'.
|
|
* The only fields that must be set prior to this call are ctx.saltlen and
|
|
* ctx.outlen (which must be the maximal salt and out length values that are
|
|
* allowed), ctx.salt and ctx.out (which must be buffers of the specified
|
|
* length), and ctx.pwd and ctx.pwdlen which must hold a valid password.
|
|
*
|
|
* Invalid input string causes an error. On success, the ctx is valid and all
|
|
* fields have been initialized.
|
|
*
|
|
* Returned value is ARGON2_OK on success, other ARGON2_ codes on error.
|
|
*/
|
|
int decode_string(argon2_context *ctx, const char *str, argon2_type type);
|
|
|
|
/* Returns the length of the encoded byte stream with length len */
|
|
size_t b64len(uint32_t len);
|
|
|
|
/* Returns the length of the encoded number num */
|
|
size_t numlen(uint32_t num);
|
|
|
|
#endif
|