support/mph.h

   1 /*
   2  * Common/shared macros and routines.
   3  *
   4  * This file contains macros of the form
   5  *
   6  *   mph_return_if_TYPE_overflow(val);
   7  *
   8  * Which tests `val' for a TYPE underflow/overflow (that is, is `val' within
   9  * the range for TYPE?).  If `val' can't fit in TYPE, errno is set to
  10  * EOVERFLOW, and `return -1' is executed (which is why it's a macro).
  11  *
  12  * Assumptions:
  13  *
  14  * I'm working from GLibc, so that's the basis for my assumptions.  They may
  15  * not be completely portable, in which case I'll need to fix my assumptions.
  16  * :-(
  17  *
  18  * See the typedefs for type size assumptions.  These typedefs *must* be kept
  19  * in sync with the types used in Mono.Posix.dll.
  20  *
  21  * See also:
  22  *   http://developer.apple.com/documentation/Darwin/Reference/ManPages/
  23  */
  24
  25 #ifndef INC_mph_H
  26 #define INC_mph_H
  27
  28 #include <config.h>
  29
  30 #include <limits.h>             /* LONG_MAX, ULONG_MAX */
  31 #include <errno.h>              /* for ERANGE */
  32 #include <glib.h>               /* for g* types, etc. */
  33
  34 #ifdef HAVE_STDINT_H
  35 #include <stdint.h>             /* for SIZE_MAX */
  36 #endif
  37
  38 #include "map-icalls.h"
  39
  40 #if __APPLE__ || __BSD__ || __FreeBSD__
  41 #define MPH_ON_BSD
  42 #endif
  43
  44 #ifdef HAVE_VISIBILITY_HIDDEN
  45 #define MPH_INTERNAL __attribute__((visibility("hidden")))
  46 #else
  47 #define MPH_INTERNAL
  48 #endif
  49
  50 #if defined (PLATFORM_WIN32) && !defined (EOVERFLOW)
  51 #define EOVERFLOW 75
  52 #endif /* def PLATFORM_WIN32 && ndef EOVERFLOW */
  53
  54 typedef    gint64 mph_blkcnt_t;
  55 typedef    gint64 mph_blksize_t;
  56 typedef   guint64 mph_dev_t;
  57 typedef   guint64 mph_ino_t;
  58 typedef   guint64 mph_nlink_t;
  59 typedef    gint64 mph_off_t;
  60 typedef   guint64 mph_size_t;
  61 typedef    gint64 mph_ssize_t;
  62 typedef    gint32 mph_pid_t;
  63 typedef   guint32 mph_gid_t;
  64 typedef   guint32 mph_uid_t;
  65 typedef    gint64 mph_time_t;
  66 typedef    gint64 mph_clock_t;
  67 typedef   guint64 mph_fsblkcnt_t;
  68 typedef   guint64 mph_fsfilcnt_t;
  69
  70 #ifdef HAVE_LARGE_FILE_SUPPORT
  71 #define MPH_OFF_T_MAX G_MAXINT64
  72 #define MPH_OFF_T_MIN G_MININT64
  73 #else
  74 #define MPH_OFF_T_MAX G_MAXINT32
  75 #define MPH_OFF_T_MIN G_MININT32
  76 #endif
  77
  78 #ifdef SIZE_MAX
  79 #define MPH_SIZE_T_MAX SIZE_MAX
  80 #elif SIZEOF_SIZE_T == 8
  81 #define MPH_SIZE_T_MAX  G_MAXUINT64
  82 #elif SIZEOF_SIZE_T == 4
  83 #define MPH_SIZE_T_MAX  G_MAXUINT32
  84 #else
  85 #error "sizeof(size_t) is unknown!"
  86 #endif
  87
  88 #define _mph_return_val_if_cb_(val, ret, cb) G_STMT_START{ \
  89         if (cb (val)) { \
  90                 errno = EOVERFLOW; \
  91                 return ret; \
  92         }}G_STMT_END
  93
  94 #define mph_have_long_overflow(var) ((var) > LONG_MAX || (var) < LONG_MIN)
  95
  96 #define mph_return_val_if_long_overflow(var, ret) \
  97         _mph_return_val_if_cb_(var, ret, mph_have_long_overflow)
  98
  99 #define mph_return_if_long_overflow(var) mph_return_val_if_long_overflow(var, -1)
 100
 101 #define mph_have_ulong_overflow(var) ((var) > ULONG_MAX)
 102
 103 #define mph_return_val_if_ulong_overflow(var, ret) \
 104         _mph_return_val_if_cb_(var, ret, mph_have_ulong_overflow)
 105
 106 #define mph_return_if_ulong_overflow(var) mph_return_val_if_ulong_overflow(var, -1)
 107
 108 #define mph_have_size_t_overflow(var) ((var) > MPH_SIZE_T_MAX)
 109
 110 #define mph_return_val_if_size_t_overflow(var, ret) \
 111         _mph_return_val_if_cb_(var, ret, mph_have_size_t_overflow)
 112
 113 #define mph_return_val_if_ssize_t_overflow(var, ret) \
 114         _mph_return_val_if_cb_(var, ret, mph_have_long_overflow)
 115
 116 #define mph_return_if_size_t_overflow(var) mph_return_val_if_size_t_overflow(var, -1)
 117
 118 #define mph_return_if_ssize_t_overflow(var) mph_return_val_if_ssize_t_overflow(var, -1)
 119
 120 #define mph_have_off_t_overflow(var) \
 121         (((var) < MPH_OFF_T_MIN) || ((var) > MPH_OFF_T_MAX))
 122
 123 #define mph_return_val_if_off_t_overflow(var, ret) \
 124         _mph_return_val_if_cb_(var, ret, mph_have_off_t_overflow)
 125
 126 #define mph_return_if_off_t_overflow(var) mph_return_val_if_size_t_overflow(var, -1)
 127
 128 #define mph_return_if_time_t_overflow(var) mph_return_if_long_overflow(var)
 129
 130 /*
 131  * Helper function for functions which use ERANGE (such as getpwnam_r and
 132  * getgrnam_r).  These functions accept buffers which are dynamically
 133  * allocated so that they're only as large as necessary.  However, Linux and
 134  * Mac OS X differ on how to signal an error value.
 135  *
 136  * Linux returns the error value directly, while Mac OS X is more traditional,
 137  * returning -1 and setting errno accordingly.
 138  *
 139  * Unify the checking in one place.
 140  */
 141 static inline int
 142 recheck_range (int ret)
 143 {
 144         if (ret == ERANGE)
 145                 return 1;
 146         if (ret == -1)
 147                 return errno == ERANGE;
 148         return 0;
 149 }
 150
 151 MPH_INTERNAL char*
 152 _mph_copy_structure_strings (
 153         void *to,         const size_t *to_offsets,
 154         const void *from, const size_t *from_offsets,
 155         size_t num_strings);
 156
 157 #endif /* ndef INC_mph_H */
 158
 159 /*
 160  * vim: noexpandtab
 161  */