pwcrypt.h

Go to the documentation of this file.

/*
   Copyright 2020 Raphael Beck
 
   Licensed under the Apache License, Version 2.0 (the "License");
   you may not use this file except in compliance with the License.
   You may obtain a copy of the License at
 
       http://www.apache.org/licenses/LICENSE-2.0
 
   Unless required by applicable law or agreed to in writing, software
   distributed under the License is distributed on an "AS IS" BASIS,
   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
   See the License for the specific language governing permissions and
   limitations under the License.
*/
 
#ifndef PWCRYPT_H
#define PWCRYPT_H
 
#ifdef __cplusplus
extern "C" {
#endif
 
#if defined(_WIN32) && defined(PWCRYPT_DLL)
#ifdef PWCRYPT_BUILD_DLL
#define PWCRYPT_API __declspec(dllexport)
#else
#define PWCRYPT_API __declspec(dllimport)
#endif
#else
#define PWCRYPT_API
#endif
 
#include <stdio.h>
#include <stdint.h>
#include <stddef.h>
 
static const char PWCRYPT_INVALID_ARGS_ERROR_MSG[] = "pwcrypt: Invalid arguments! Please run \"pwcrypt --help\" to find out how to use this program.\n";
 
static const uint8_t EMPTY64[64] = {
    //
    0x00, 0x00, 0x00, 0x00, //
    0x00, 0x00, 0x00, 0x00, //
    0x00, 0x00, 0x00, 0x00, //
    0x00, 0x00, 0x00, 0x00, //
    0x00, 0x00, 0x00, 0x00, //
    0x00, 0x00, 0x00, 0x00, //
    0x00, 0x00, 0x00, 0x00, //
    0x00, 0x00, 0x00, 0x00, //
    0x00, 0x00, 0x00, 0x00, //
    0x00, 0x00, 0x00, 0x00, //
    0x00, 0x00, 0x00, 0x00, //
    0x00, 0x00, 0x00, 0x00, //
    0x00, 0x00, 0x00, 0x00, //
    0x00, 0x00, 0x00, 0x00, //
    0x00, 0x00, 0x00, 0x00, //
    0x00, 0x00, 0x00, 0x00, //
};
 
#define PWCRYPT_VERSION 430
 
#define PWCRYPT_VERSION_STR "4.3.0"
 
#ifndef PWCRYPT_Z_CHUNKSIZE
#define PWCRYPT_Z_CHUNKSIZE (1024 * 256)
#endif
 
#ifndef PWCRYPT_ARGON2_T_COST
#define PWCRYPT_ARGON2_T_COST 4
#endif
 
#ifndef PWCRYPT_ARGON2_M_COST
#define PWCRYPT_ARGON2_M_COST (1024 * 256)
#endif
 
#ifndef PWCRYPT_ARGON2_PARALLELISM
#define PWCRYPT_ARGON2_PARALLELISM 2
#endif
 
#define PWCRYPT_ALGO_ID_AES256_GCM 0
 
#define PWCRYPT_ALGO_ID_CHACHA20_POLY1305 1
 
#ifndef PWCRYPT_FILE_BUFFER_SIZE
#define PWCRYPT_FILE_BUFFER_SIZE (1024 * 256)
#endif
 
#define PWCRYPT_ERROR_INVALID_ARGS (-1)
 
#define PWCRYPT_ERROR_OOM 1000
 
#define PWCRYPT_ERROR_PW_TOO_WEAK 2000
 
#define PWCRYPT_ERROR_ARGON2_FAILURE 3000
 
#define PWCRYPT_ERROR_ENCRYPTION_FAILURE 4000
 
#define PWCRYPT_ERROR_DECRYPTION_FAILURE 5000
 
#define PWCRYPT_ERROR_BASE64_FAILURE 6000
 
#define PWCRYPT_ERROR_COMPRESSION_FAILURE 7000
 
#define PWCRYPT_ERROR_DECOMPRESSION_FAILURE 8000
 
#define PWCRYPT_ERROR_FILE_FAILURE 9000
 
#define PWCRYPT_MIN(x, y) (((x) < (y)) ? (x) : (y))
 
#define PWCRYPT_MAX(x, y) (((x) > (y)) ? (x) : (y))
 
#ifndef PWCRYPT_MAX_WIN_FILEPATH_LENGTH
#define PWCRYPT_MAX_WIN_FILEPATH_LENGTH (1024 * 32)
#endif
 
PWCRYPT_API unsigned char pwcrypt_is_fprintf_enabled();
 
static inline int pwcrypt_printvoid(FILE* stream, const char* format, ...)
{
    return 0;
}
 
extern int (*pwcrypt_fprintf_fptr)(FILE* stream, const char* format, ...);
 
PWCRYPT_API void pwcrypt_enable_fprintf();
 
PWCRYPT_API void pwcrypt_disable_fprintf();
 
#define pwcrypt_fprintf pwcrypt_fprintf_fptr
 
PWCRYPT_API void dev_urandom(uint8_t* output_buffer, size_t output_buffer_size);
 
PWCRYPT_API void pwcrypt_get_temp_filepath(char output_buffer[256]);
 
PWCRYPT_API size_t pwcrypt_get_filesize(const char* filepath);
 
PWCRYPT_API int pwcrypt_assess_password_strength(const uint8_t* password, size_t password_length);
 
PWCRYPT_API int pwcrypt_encrypt(const uint8_t* input, size_t input_length, uint32_t compress, const uint8_t* password, size_t password_length, uint32_t argon2_cost_t, uint32_t argon2_cost_m, uint32_t argon2_parallelism, uint32_t algo, uint8_t** output, size_t* output_length, uint32_t output_base64);
 
PWCRYPT_API int pwcrypt_encrypt_file(const char* input_file_path, size_t input_file_path_length, uint32_t compress, const uint8_t* password, size_t password_length, uint32_t argon2_cost_t, uint32_t argon2_cost_m, uint32_t argon2_parallelism, uint32_t algo, const char* output_file_path, size_t output_file_path_length);
 
PWCRYPT_API int pwcrypt_encrypt_file_raw(FILE* input_file, FILE* output_file, uint32_t compress, const uint8_t* password, size_t password_length, uint32_t argon2_cost_t, uint32_t argon2_cost_m, uint32_t argon2_parallelism, uint32_t algo, uint32_t close_input_file, uint32_t close_output_file);
 
PWCRYPT_API int pwcrypt_decrypt(const uint8_t* encrypted_data, size_t encrypted_data_length, const uint8_t* password, size_t password_length, uint8_t** output, size_t* output_length);
 
PWCRYPT_API int pwcrypt_decrypt_file(const char* input_file_path, size_t input_file_path_length, const uint8_t* password, size_t password_length, const char* output_file_path, size_t output_file_path_length);
 
PWCRYPT_API int pwcrypt_decrypt_file_raw(FILE* input_file, FILE* output_file, const uint8_t* password, size_t password_length, uint32_t close_input_file, uint32_t close_output_file);
 
PWCRYPT_API uint32_t pwcrypt_get_version_nr();
 
PWCRYPT_API uint32_t pwcrypt_get_argon2_version_nr();
 
PWCRYPT_API char* pwcrypt_get_version_nr_string();
 
PWCRYPT_API void pwcrypt_free(void* ptr);
 
PWCRYPT_API FILE* pwcrypt_fopen(const char* filename, const char* mode);
 
#ifdef __cplusplus
} // extern "C"
#endif
 
#endif // PWCRYPT_H