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 #if __APPLE__ || __BSD__
  39 #define MPH_ON_BSD
  40 #endif
  41
  42 #define MPH_INTERNAL __attribute__((visibility("hidden")))
  43
  44 typedef    gint64 mph_blkcnt_t;
  45 typedef    gint64 mph_blksize_t;
  46 typedef   guint64 mph_dev_t;
  47 typedef   guint64 mph_ino_t;
  48 typedef   guint64 mph_nlink_t;
  49 typedef    gint64 mph_off_t;
  50 typedef   guint64 mph_size_t;
  51 typedef    gint64 mph_ssize_t;
  52 typedef    gint32 mph_pid_t;
  53 typedef   guint32 mph_gid_t;
  54 typedef   guint32 mph_uid_t;
  55 typedef    gint64 mph_time_t;
  56 typedef    gint64 mph_clock_t;
  57 typedef   guint64 mph_fsblkcnt_t;
  58 typedef   guint64 mph_fsfilcnt_t;
  59
  60 #ifdef HAVE_LARGE_FILE_SUPPORT
  61 #define MPH_OFF_T_MAX G_MAXINT64
  62 #define MPH_OFF_T_MIN G_MININT64
  63 #else
  64 #define MPH_OFF_T_MAX G_MAXINT32
  65 #define MPH_OFF_T_MIN G_MININT32
  66 #endif
  67
  68 #ifdef SIZE_MAX
  69 #define MPH_SIZE_T_MAX SIZE_MAX
  70 #elif SIZEOF_SIZE_T == 8
  71 #define MPH_SIZE_T_MAX  G_MAXUINT64
  72 #elif SIZEOF_SIZE_T == 4
  73 #define MPH_SIZE_T_MAX  G_MAXUINT32
  74 #else
  75 #error "sizeof(size_t) is unknown!"
  76 #endif
  77
  78 #define _mph_return_val_if_cb_(val, ret, cb) G_STMT_START{ \
  79         if (cb (val)) { \
  80                 errno = EOVERFLOW; \
  81                 return ret; \
  82         }}G_STMT_END
  83
  84 #define mph_have_long_overflow(var) ((var) > LONG_MAX || (var) < LONG_MIN)
  85
  86 #define mph_return_val_if_long_overflow(var, ret) \
  87         _mph_return_val_if_cb_(var, ret, mph_have_long_overflow)
  88
  89 #define mph_return_if_long_overflow(var) mph_return_val_if_long_overflow(var, -1)
  90
  91 #define mph_have_ulong_overflow(var) ((var) > ULONG_MAX)
  92
  93 #define mph_return_val_if_ulong_overflow(var, ret) \
  94         _mph_return_val_if_cb_(var, ret, mph_have_ulong_overflow)
  95
  96 #define mph_return_if_ulong_overflow(var) mph_return_val_if_ulong_overflow(var, -1)
  97
  98 #define mph_have_size_t_overflow(var) ((var) > MPH_SIZE_T_MAX)
  99
 100 #define mph_return_val_if_size_t_overflow(var, ret) \
 101         _mph_return_val_if_cb_(var, ret, mph_have_size_t_overflow)
 102
 103 #define mph_return_if_size_t_overflow(var) mph_return_val_if_size_t_overflow(var, -1)
 104
 105 #define mph_have_off_t_overflow(var) \
 106         (((var) < MPH_OFF_T_MIN) || ((var) > MPH_OFF_T_MAX))
 107
 108 #define mph_return_val_if_off_t_overflow(var, ret) \
 109         _mph_return_val_if_cb_(var, ret, mph_have_off_t_overflow)
 110
 111 #define mph_return_if_off_t_overflow(var) mph_return_val_if_size_t_overflow(var, -1)
 112
 113 #define mph_return_if_time_t_overflow(var) mph_return_if_long_overflow(var)
 114
 115 /*
 116  * Helper function for functions which use ERANGE (such as getpwnam_r and
 117  * getgrnam_r).  These functions accept buffers which are dynamically
 118  * allocated so that they're only as large as necessary.  However, Linux and
 119  * Mac OS X differ on how to signal an error value.
 120  *
 121  * Linux returns the error value directly, while Mac OS X is more traditional,
 122  * returning -1 and setting errno accordingly.
 123  *
 124  * Unify the checking in one place.
 125  */
 126 static inline int
 127 recheck_range (int ret)
 128 {
 129         if (ret == ERANGE)
 130                 return 1;
 131         if (ret == -1)
 132                 return errno == ERANGE;
 133         return 0;
 134 }
 135
 136 MPH_INTERNAL char*
 137 _mph_copy_structure_strings (
 138         void *to,   size_t *to_offsets,
 139         void *from, size_t *from_offsets,
 140         size_t num_strings);
 141
 142 #endif /* ndef INC_mph_H */
 143
 144 /*
 145  * vim: noexpandtab
 146  */