wimlib.net Git - wimlib/blob - src/util.h

   1 /*
   2  * util.h
   3  *
   4  * Header for util.c.
   5  *
   6  * Copyright (C) 2012 Eric Biggers
   7  *
   8  * wimlib - Library for working with WIM files
   9  *
  10  * This library is free software; you can redistribute it and/or modify it under
  11  * the terms of the GNU Lesser General Public License as published by the Free
  12  * Software Foundation; either version 2.1 of the License, or (at your option) any
  13  * later version.
  14  *
  15  * This library is distributed in the hope that it will be useful, but WITHOUT ANY
  16  * WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A
  17  * PARTICULAR PURPOSE. See the GNU Lesser General Public License for more details.
  18  *
  19  * You should have received a copy of the GNU Lesser General Public License along
  20  * with this library; if not, write to the Free Software Foundation, Inc., 59
  21  * Temple Place, Suite 330, Boston, MA 02111-1307 USA
  22  */
  23
  24 #ifndef _WIMLIB_UTIL_H
  25 #define _WIMLIB_UTIL_H
  26
  27 #include <stdio.h>
  28 #include <stdbool.h>
  29 #include <stddef.h>
  30 #include <inttypes.h>
  31 #include <sys/types.h>
  32 #include "config.h"
  33
  34
  35 typedef uint8_t  u8;
  36 typedef uint16_t u16;
  37 typedef uint32_t u32;
  38 typedef uint64_t u64;
  39 typedef unsigned uint;
  40
  41 #define min(a, b) ({ typeof(a) __a = (a); typeof(b) __b = (b); \
  42                                         (__a < __b) ? __a : __b; })
  43 #define max(a, b) ({ typeof(a) __a = (a); typeof(b) __b = (b); \
  44                                         (__a > __b) ? __a : __b; })
  45 #define swap(a, b) ({typeof(a) _a = a; (a) = (b); (b) = _a;})
  46
  47 #define ARRAY_LEN(array) (sizeof(array) / sizeof((array)[0]))
  48
  49 #define ZERO_ARRAY(array) memset(array, 0, sizeof(array))
  50
  51 #ifdef ENABLE_ERROR_MESSAGES
  52 extern bool __wimlib_print_errors;
  53 extern void wimlib_error(const char *format, ...);
  54 #  define ERROR wimlib_error
  55 #else
  56 #  define ERROR(format, ...)
  57 #endif /* ENABLE_ERROR_MESSAGES */
  58
  59 #if defined(ENABLE_DEBUG) || defined(ENABLE_MORE_DEBUG)
  60 #include <errno.h>
  61 #  define DEBUG(format, ...)  \
  62 ({ \
  63         int __errno_save = errno; \
  64         fprintf(stdout, "[%s %d] %s(): " format, \
  65                 __FILE__, __LINE__, __func__, ## __VA_ARGS__); \
  66         fflush(stdout); \
  67         errno = __errno_save; \
  68         })
  69
  70 #else
  71 #  define DEBUG(format, ...)
  72 #endif /* ENABLE_DEBUG || ENABLE_MORE_DEBUG */
  73
  74 #ifdef ENABLE_MORE_DEBUG
  75 #  define DEBUG2(format, ...) DEBUG(format, ## __VA_ARGS__)
  76 #else
  77 #  define DEBUG2(format, ...)
  78 #endif /* ENABLE_DEBUG */
  79
  80 #ifdef ENABLE_ASSERTIONS
  81 #include <assert.h>
  82 #       define wimlib_assert(expr) assert(expr)
  83 #else
  84 #       define wimlib_assert(expr)
  85 #endif
  86
  87 #ifdef __GNUC__
  88 #  define WIMLIBAPI __attribute__((visibility("default")))
  89 #  define NOINLINE __attribute__((noinline))
  90 #  define ALWAYS_INLINE inline __attribute__((always_inline))
  91 #  define COLD     __attribute__((cold))
  92 #  define HOT      __attribute__((hot))
  93 #else
  94 #  define WIMLIBAPI
  95 #  define NOINLINE
  96 #  define ALWAYS_INLINE inline
  97 #  define COLD
  98 #  define HOT
  99 #endif /* __GNUC__ */
 100
 101 #ifdef ENABLE_CUSTOM_MEMORY_ALLOCATOR
 102 extern void *(*wimlib_malloc_func)(size_t);
 103 extern void (*wimlib_free_func)(void *);
 104 extern void *(*wimlib_realloc)(void *, size_t);
 105 extern void *wimlib_calloc(size_t nmemb, size_t size);
 106 extern char *wimlib_strdup(const char *str);
 107 #  define MALLOC wimlib_malloc_func
 108 #  define FREE wimlib_free_func
 109 #  define REALLOC wimlib_realloc_func
 110 #  define CALLOC wimlib_calloc
 111 #  define STRDUP wimlib_strdup
 112 #else
 113 #include <stdlib.h>
 114 #include <string.h>
 115 #  define MALLOC malloc
 116 #  define FREE free
 117 #  define REALLOC realloc
 118 #  define CALLOC calloc
 119 #  define STRDUP strdup
 120 #endif /* ENABLE_CUSTOM_MEMORY_ALLOCATOR */
 121
 122
 123 extern char *utf16_to_utf8(const char *utf16_str, size_t utf16_len,
 124                            size_t *utf8_len_ret);
 125
 126 extern char *utf8_to_utf16(const char *utf8_str, size_t utf8_len,
 127                            size_t *utf16_len_ret);
 128
 129 extern void randomize_byte_array(void *p, size_t n);
 130
 131 extern void randomize_char_array_with_alnum(char p[], size_t n);
 132
 133 extern int sha1sum(const char *filename, void *buf);
 134
 135 extern const char *path_next_part(const char *path,
 136                                   size_t *first_part_len_ret);
 137
 138 extern const char *path_basename(const char *path);
 139
 140 extern void to_parent_name(char buf[], size_t len);
 141
 142 extern void print_string(const void *string, size_t len);
 143
 144 extern int get_num_path_components(const char *path);
 145
 146 extern ssize_t full_write(int fd, const void *buf, size_t n);
 147
 148
 149 static inline void print_byte_field(const u8 field[], size_t len)
 150 {
 151         while (len--)
 152                 printf("%02hhx", *field++);
 153 }
 154
 155
 156 #endif /* _WIMLIB_UTIL_H */