//============================================================================== // This file is part of Master Password. // Copyright (c) 2011-2017, Maarten Billemont. // // Master Password is free software: you can redistribute it and/or modify // it under the terms of the GNU General Public License as published by // the Free Software Foundation, either version 3 of the License, or // (at your option) any later version. // // Master Password is distributed in the hope that it will be useful, // but WITHOUT ANY WARRANTY; without even the implied warranty of // MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the // GNU General Public License for more details. // // You can find a copy of the GNU General Public License in the // LICENSE file. Alternatively, see . //============================================================================== #include #include "mpw-types.h" #ifndef _MPW_UTIL_H #define _MPW_UTIL_H //// Logging. #ifndef trc extern int mpw_verbosity; #define trc_level 3 #define trc(...) ({ \ if (mpw_verbosity >= 3) \ fprintf( stderr, __VA_ARGS__ ); }) #endif #ifndef dbg #define dbg_level 2 #define dbg(...) ({ \ if (mpw_verbosity >= 2) \ fprintf( stderr, __VA_ARGS__ ); }) #endif #ifndef inf #define inf_level 1 #define inf(...) ({ \ if (mpw_verbosity >= 1) \ fprintf( stderr, __VA_ARGS__ ); }) #endif #ifndef wrn #define wrn_level 0 #define wrn(...) ({ \ if (mpw_verbosity >= 0) \ fprintf( stderr, __VA_ARGS__ ); }) #endif #ifndef err #define err_level -1 #define err(...) ({ \ if (mpw_verbosity >= -1) \ fprintf( stderr, __VA_ARGS__ ); }) #endif #ifndef ftl #define ftl_level -2 #define ftl(...) ({ \ if (mpw_verbosity >= -2) \ fprintf( stderr, __VA_ARGS__ ); \ exit( 2 ); }) #endif #ifndef min #define min(a, b) ({ \ __typeof__ (a) _a = (a); \ __typeof__ (b) _b = (b); \ _a < _b ? _a : _b; }) #endif #ifndef max #define max(a, b) ({ \ __typeof__ (a) _a = (a); \ __typeof__ (b) _b = (b); \ _a > _b ? _a : _b; }) #endif //// Buffers and memory. #define mpw_alloc_array(_count, _type, ...) ({ \ _type stackElements[] = { __VA_ARGS__ }; \ _count = sizeof( stackElements ) / sizeof( _type ); \ _type *allocElements = malloc( sizeof( stackElements ) ); \ memcpy( allocElements, stackElements, sizeof( stackElements ) ); \ allocElements; \ }) /** Push a buffer onto a buffer. reallocs the given buffer and appends the given buffer. */ bool mpw_push_buf( uint8_t **const buffer, size_t *const bufferSize, const void *pushBuffer, const size_t pushSize); /** Push a string onto a buffer. reallocs the given buffer and appends the given string. */ bool mpw_push_string( uint8_t **buffer, size_t *const bufferSize, const char *pushString); /** Push an integer onto a buffer. reallocs the given buffer and appends the given integer. */ bool mpw_push_int( uint8_t **const buffer, size_t *const bufferSize, const uint32_t pushInt); /** Free a buffer after zero'ing its contents. */ bool mpw_free( const void *buffer, const size_t bufferSize); /** Free a string after zero'ing its contents. */ bool mpw_free_string( const char *string); //// Cryptographic functions. /** Perform a scrypt-based key derivation on the given key using the given salt and scrypt parameters. * @return A new keySize-size allocated buffer. */ uint8_t const *mpw_scrypt( const size_t keySize, const char *secret, const uint8_t *salt, const size_t saltSize, uint64_t N, uint32_t r, uint32_t p); /** Calculate a SHA256-based HMAC by encrypting the given salt with the given key. * @return A new 32-byte allocated buffer. */ uint8_t const *mpw_hmac_sha256( const uint8_t *key, const size_t keySize, const uint8_t *salt, const size_t saltSize); //// Visualizers. /** Encode a buffer as a string of hexadecimal characters. * @return A C-string in a reused buffer, do not free or store it. */ const char *mpw_hex(const void *buf, size_t length); const char *mpw_hex_l(uint32_t number); /** Encode a fingerprint for a buffer. * @return A C-string in a reused buffer, do not free or store it. */ const char *mpw_id_buf(const void *buf, size_t length); /** Encode a visual fingerprint for a user. * @return A newly allocated string. */ const char *mpw_identicon(const char *fullName, const char *masterPassword); //// String utilities. /** @return The amount of display characters in the given UTF-8 string. */ const size_t mpw_utf8_strlen(const char *utf8String); #endif // _MPW_UTIL_H