Tim Peters | 7d3a511 | 2000-07-08 04:17:21 +0000 | [diff] [blame] | 1 | #ifndef Py_PYPORT_H |
Vladimir Marangozov | 14a4d88 | 2000-07-10 04:59:49 +0000 | [diff] [blame] | 2 | #define Py_PYPORT_H |
Tim Peters | 7d3a511 | 2000-07-08 04:17:21 +0000 | [diff] [blame] | 3 | |
Martin v. Löwis | 4f1cd8b | 2001-07-26 13:41:06 +0000 | [diff] [blame] | 4 | #include "pyconfig.h" /* include for defines */ |
Peter Schneider-Kamp | 25f6894 | 2000-07-31 22:19:30 +0000 | [diff] [blame] | 5 | |
Tim Peters | 7d3a511 | 2000-07-08 04:17:21 +0000 | [diff] [blame] | 6 | /************************************************************************** |
| 7 | Symbols and macros to supply platform-independent interfaces to basic |
Tim Peters | 1be4684 | 2000-07-23 18:10:18 +0000 | [diff] [blame] | 8 | C language & library operations whose spellings vary across platforms. |
Tim Peters | 7d3a511 | 2000-07-08 04:17:21 +0000 | [diff] [blame] | 9 | |
| 10 | Please try to make documentation here as clear as possible: by definition, |
| 11 | the stuff here is trying to illuminate C's darkest corners. |
| 12 | |
| 13 | Config #defines referenced here: |
| 14 | |
| 15 | SIGNED_RIGHT_SHIFT_ZERO_FILLS |
| 16 | Meaning: To be defined iff i>>j does not extend the sign bit when i is a |
| 17 | signed integral type and i < 0. |
| 18 | Used in: Py_ARITHMETIC_RIGHT_SHIFT |
Tim Peters | 1be4684 | 2000-07-23 18:10:18 +0000 | [diff] [blame] | 19 | |
Tim Peters | 8315ea5 | 2000-07-23 19:28:35 +0000 | [diff] [blame] | 20 | Py_DEBUG |
| 21 | Meaning: Extra checks compiled in for debug mode. |
| 22 | Used in: Py_SAFE_DOWNCAST |
Barry Warsaw | fd847b2 | 2000-08-18 04:48:18 +0000 | [diff] [blame] | 23 | |
| 24 | HAVE_UINTPTR_T |
| 25 | Meaning: The C9X type uintptr_t is supported by the compiler |
| 26 | Used in: Py_uintptr_t |
| 27 | |
| 28 | HAVE_LONG_LONG |
| 29 | Meaning: The compiler supports the C type "long long" |
Martin v. Löwis | b9a0f91 | 2003-03-29 10:06:18 +0000 | [diff] [blame] | 30 | Used in: PY_LONG_LONG |
Barry Warsaw | fd847b2 | 2000-08-18 04:48:18 +0000 | [diff] [blame] | 31 | |
Tim Peters | 7d3a511 | 2000-07-08 04:17:21 +0000 | [diff] [blame] | 32 | **************************************************************************/ |
| 33 | |
| 34 | |
Vladimir Marangozov | e2bf7e6 | 2000-09-08 12:55:35 +0000 | [diff] [blame] | 35 | /* For backward compatibility only. Obsolete, do not use. */ |
Vladimir Marangozov | e2bf7e6 | 2000-09-08 12:55:35 +0000 | [diff] [blame] | 36 | #ifdef HAVE_PROTOTYPES |
| 37 | #define Py_PROTO(x) x |
| 38 | #else |
| 39 | #define Py_PROTO(x) () |
| 40 | #endif |
Marc-André Lemburg | 77317ca | 2000-10-05 17:25:45 +0000 | [diff] [blame] | 41 | #ifndef Py_FPROTO |
| 42 | #define Py_FPROTO(x) Py_PROTO(x) |
| 43 | #endif |
Peter Schneider-Kamp | 7e01890 | 2000-07-31 15:28:04 +0000 | [diff] [blame] | 44 | |
Barry Warsaw | fd847b2 | 2000-08-18 04:48:18 +0000 | [diff] [blame] | 45 | /* typedefs for some C9X-defined synonyms for integral types. |
| 46 | * |
| 47 | * The names in Python are exactly the same as the C9X names, except with a |
| 48 | * Py_ prefix. Until C9X is universally implemented, this is the only way |
| 49 | * to ensure that Python gets reliable names that don't conflict with names |
| 50 | * in non-Python code that are playing their own tricks to define the C9X |
| 51 | * names. |
| 52 | * |
| 53 | * NOTE: don't go nuts here! Python has no use for *most* of the C9X |
| 54 | * integral synonyms. Only define the ones we actually need. |
| 55 | */ |
| 56 | |
| 57 | #ifdef HAVE_LONG_LONG |
Martin v. Löwis | b9a0f91 | 2003-03-29 10:06:18 +0000 | [diff] [blame] | 58 | #ifndef PY_LONG_LONG |
| 59 | #define PY_LONG_LONG long long |
Barry Warsaw | fd847b2 | 2000-08-18 04:48:18 +0000 | [diff] [blame] | 60 | #endif |
| 61 | #endif /* HAVE_LONG_LONG */ |
| 62 | |
| 63 | /* uintptr_t is the C9X name for an unsigned integral type such that a |
| 64 | * legitimate void* can be cast to uintptr_t and then back to void* again |
Tim Peters | 79248aa | 2001-08-29 21:37:10 +0000 | [diff] [blame] | 65 | * without loss of information. Similarly for intptr_t, wrt a signed |
| 66 | * integral type. |
Barry Warsaw | fd847b2 | 2000-08-18 04:48:18 +0000 | [diff] [blame] | 67 | */ |
| 68 | #ifdef HAVE_UINTPTR_T |
Tim Peters | 79248aa | 2001-08-29 21:37:10 +0000 | [diff] [blame] | 69 | typedef uintptr_t Py_uintptr_t; |
| 70 | typedef intptr_t Py_intptr_t; |
| 71 | |
Barry Warsaw | fd847b2 | 2000-08-18 04:48:18 +0000 | [diff] [blame] | 72 | #elif SIZEOF_VOID_P <= SIZEOF_INT |
Tim Peters | 79248aa | 2001-08-29 21:37:10 +0000 | [diff] [blame] | 73 | typedef unsigned int Py_uintptr_t; |
| 74 | typedef int Py_intptr_t; |
| 75 | |
Barry Warsaw | fd847b2 | 2000-08-18 04:48:18 +0000 | [diff] [blame] | 76 | #elif SIZEOF_VOID_P <= SIZEOF_LONG |
Tim Peters | 79248aa | 2001-08-29 21:37:10 +0000 | [diff] [blame] | 77 | typedef unsigned long Py_uintptr_t; |
| 78 | typedef long Py_intptr_t; |
| 79 | |
Barry Warsaw | fd847b2 | 2000-08-18 04:48:18 +0000 | [diff] [blame] | 80 | #elif defined(HAVE_LONG_LONG) && (SIZEOF_VOID_P <= SIZEOF_LONG_LONG) |
Martin v. Löwis | b9a0f91 | 2003-03-29 10:06:18 +0000 | [diff] [blame] | 81 | typedef unsigned PY_LONG_LONG Py_uintptr_t; |
| 82 | typedef PY_LONG_LONG Py_intptr_t; |
Tim Peters | 79248aa | 2001-08-29 21:37:10 +0000 | [diff] [blame] | 83 | |
Barry Warsaw | fd847b2 | 2000-08-18 04:48:18 +0000 | [diff] [blame] | 84 | #else |
| 85 | # error "Python needs a typedef for Py_uintptr_t in pyport.h." |
| 86 | #endif /* HAVE_UINTPTR_T */ |
| 87 | |
Peter Schneider-Kamp | 7e01890 | 2000-07-31 15:28:04 +0000 | [diff] [blame] | 88 | #include <stdlib.h> |
Peter Schneider-Kamp | 7e01890 | 2000-07-31 15:28:04 +0000 | [diff] [blame] | 89 | |
Vladimir Marangozov | 2c57e07 | 2000-08-11 11:48:33 +0000 | [diff] [blame] | 90 | #include <math.h> /* Moved here from the math section, before extern "C" */ |
| 91 | |
| 92 | /******************************************** |
| 93 | * WRAPPER FOR <time.h> and/or <sys/time.h> * |
| 94 | ********************************************/ |
| 95 | |
| 96 | #ifdef TIME_WITH_SYS_TIME |
| 97 | #include <sys/time.h> |
| 98 | #include <time.h> |
| 99 | #else /* !TIME_WITH_SYS_TIME */ |
| 100 | #ifdef HAVE_SYS_TIME_H |
| 101 | #include <sys/time.h> |
| 102 | #else /* !HAVE_SYS_TIME_H */ |
| 103 | #include <time.h> |
| 104 | #endif /* !HAVE_SYS_TIME_H */ |
| 105 | #endif /* !TIME_WITH_SYS_TIME */ |
| 106 | |
| 107 | |
| 108 | /****************************** |
| 109 | * WRAPPER FOR <sys/select.h> * |
| 110 | ******************************/ |
| 111 | |
| 112 | /* NB caller must include <sys/types.h> */ |
| 113 | |
| 114 | #ifdef HAVE_SYS_SELECT_H |
| 115 | |
| 116 | #include <sys/select.h> |
| 117 | |
Vladimir Marangozov | 2c57e07 | 2000-08-11 11:48:33 +0000 | [diff] [blame] | 118 | #endif /* !HAVE_SYS_SELECT_H */ |
| 119 | |
Tim Peters | 60f42b5 | 2001-01-18 03:03:16 +0000 | [diff] [blame] | 120 | /******************************* |
| 121 | * stat() and fstat() fiddling * |
| 122 | *******************************/ |
| 123 | |
| 124 | /* We expect that stat and fstat exist on most systems. |
| 125 | * It's confirmed on Unix, Mac and Windows. |
| 126 | * If you don't have them, add |
| 127 | * #define DONT_HAVE_STAT |
| 128 | * and/or |
| 129 | * #define DONT_HAVE_FSTAT |
Tim Peters | 76f373d | 2001-07-26 21:34:59 +0000 | [diff] [blame] | 130 | * to your pyconfig.h. Python code beyond this should check HAVE_STAT and |
Tim Peters | 60f42b5 | 2001-01-18 03:03:16 +0000 | [diff] [blame] | 131 | * HAVE_FSTAT instead. |
| 132 | * Also |
| 133 | * #define DONT_HAVE_SYS_STAT_H |
| 134 | * if <sys/stat.h> doesn't exist on your platform, and |
| 135 | * #define HAVE_STAT_H |
| 136 | * if <stat.h> does (don't look at me -- ths mess is inherited). |
| 137 | */ |
| 138 | #ifndef DONT_HAVE_STAT |
| 139 | #define HAVE_STAT |
| 140 | #endif |
| 141 | |
| 142 | #ifndef DONT_HAVE_FSTAT |
| 143 | #define HAVE_FSTAT |
| 144 | #endif |
| 145 | |
Guido van Rossum | e2ae77b | 2001-10-24 20:42:55 +0000 | [diff] [blame] | 146 | #ifdef RISCOS |
| 147 | #include <sys/types.h> |
Martin v. Löwis | a94568a | 2003-05-10 07:36:56 +0000 | [diff] [blame] | 148 | #include "unixstuff.h" |
Guido van Rossum | e2ae77b | 2001-10-24 20:42:55 +0000 | [diff] [blame] | 149 | #endif |
| 150 | |
Tim Peters | 60f42b5 | 2001-01-18 03:03:16 +0000 | [diff] [blame] | 151 | #ifndef DONT_HAVE_SYS_STAT_H |
Andrew MacIntyre | 5e090fc | 2002-02-26 11:20:01 +0000 | [diff] [blame] | 152 | #if defined(PYOS_OS2) && defined(PYCC_GCC) |
| 153 | #include <sys/types.h> |
| 154 | #endif |
Tim Peters | 60f42b5 | 2001-01-18 03:03:16 +0000 | [diff] [blame] | 155 | #include <sys/stat.h> |
| 156 | #elif defined(HAVE_STAT_H) |
| 157 | #include <stat.h> |
| 158 | #endif |
| 159 | |
Martin v. Löwis | f9836ba | 2001-08-08 10:28:06 +0000 | [diff] [blame] | 160 | #if defined(PYCC_VACPP) |
| 161 | /* VisualAge C/C++ Failed to Define MountType Field in sys/stat.h */ |
| 162 | #define S_IFMT (S_IFDIR|S_IFCHR|S_IFREG) |
| 163 | #endif |
| 164 | |
| 165 | #ifndef S_ISREG |
| 166 | #define S_ISREG(x) (((x) & S_IFMT) == S_IFREG) |
| 167 | #endif |
| 168 | |
| 169 | #ifndef S_ISDIR |
| 170 | #define S_ISDIR(x) (((x) & S_IFMT) == S_IFDIR) |
| 171 | #endif |
| 172 | |
Vladimir Marangozov | 2c57e07 | 2000-08-11 11:48:33 +0000 | [diff] [blame] | 173 | |
Tim Peters | 7d3a511 | 2000-07-08 04:17:21 +0000 | [diff] [blame] | 174 | #ifdef __cplusplus |
Peter Schneider-Kamp | 7e01890 | 2000-07-31 15:28:04 +0000 | [diff] [blame] | 175 | /* Move this down here since some C++ #include's don't like to be included |
| 176 | inside an extern "C" */ |
Tim Peters | 7d3a511 | 2000-07-08 04:17:21 +0000 | [diff] [blame] | 177 | extern "C" { |
| 178 | #endif |
| 179 | |
Vladimir Marangozov | 2c57e07 | 2000-08-11 11:48:33 +0000 | [diff] [blame] | 180 | |
Tim Peters | 7d3a511 | 2000-07-08 04:17:21 +0000 | [diff] [blame] | 181 | /* Py_ARITHMETIC_RIGHT_SHIFT |
| 182 | * C doesn't define whether a right-shift of a signed integer sign-extends |
| 183 | * or zero-fills. Here a macro to force sign extension: |
| 184 | * Py_ARITHMETIC_RIGHT_SHIFT(TYPE, I, J) |
| 185 | * Return I >> J, forcing sign extension. |
| 186 | * Requirements: |
| 187 | * I is of basic signed type TYPE (char, short, int, long, or long long). |
| 188 | * TYPE is one of char, short, int, long, or long long, although long long |
| 189 | * must not be used except on platforms that support it. |
| 190 | * J is an integer >= 0 and strictly less than the number of bits in TYPE |
| 191 | * (because C doesn't define what happens for J outside that range either). |
| 192 | * Caution: |
| 193 | * I may be evaluated more than once. |
| 194 | */ |
| 195 | #ifdef SIGNED_RIGHT_SHIFT_ZERO_FILLS |
| 196 | #define Py_ARITHMETIC_RIGHT_SHIFT(TYPE, I, J) \ |
| 197 | ((I) < 0 ? ~((~(unsigned TYPE)(I)) >> (J)) : (I) >> (J)) |
| 198 | #else |
| 199 | #define Py_ARITHMETIC_RIGHT_SHIFT(TYPE, I, J) ((I) >> (J)) |
| 200 | #endif |
| 201 | |
Tim Peters | 39dce29 | 2000-08-15 03:34:48 +0000 | [diff] [blame] | 202 | /* Py_FORCE_EXPANSION(X) |
Tim Peters | 1be4684 | 2000-07-23 18:10:18 +0000 | [diff] [blame] | 203 | * "Simply" returns its argument. However, macro expansions within the |
| 204 | * argument are evaluated. This unfortunate trickery is needed to get |
| 205 | * token-pasting to work as desired in some cases. |
| 206 | */ |
| 207 | #define Py_FORCE_EXPANSION(X) X |
| 208 | |
Tim Peters | 8315ea5 | 2000-07-23 19:28:35 +0000 | [diff] [blame] | 209 | /* Py_SAFE_DOWNCAST(VALUE, WIDE, NARROW) |
| 210 | * Cast VALUE to type NARROW from type WIDE. In Py_DEBUG mode, this |
| 211 | * assert-fails if any information is lost. |
| 212 | * Caution: |
| 213 | * VALUE may be evaluated more than once. |
| 214 | */ |
| 215 | #ifdef Py_DEBUG |
| 216 | #define Py_SAFE_DOWNCAST(VALUE, WIDE, NARROW) \ |
| 217 | (assert((WIDE)(NARROW)(VALUE) == (VALUE)), (NARROW)(VALUE)) |
| 218 | #else |
| 219 | #define Py_SAFE_DOWNCAST(VALUE, WIDE, NARROW) (NARROW)(VALUE) |
| 220 | #endif |
| 221 | |
Tim Peters | 39dce29 | 2000-08-15 03:34:48 +0000 | [diff] [blame] | 222 | /* Py_IS_INFINITY(X) |
| 223 | * Return 1 if float or double arg is an infinity, else 0. |
| 224 | * Caution: |
| 225 | * X is evaluated more than once. |
| 226 | * This implementation may set the underflow flag if |X| is very small; |
| 227 | * it really can't be implemented correctly (& easily) before C99. |
| 228 | */ |
Tim Peters | 1a2eefd | 2000-09-08 15:45:34 +0000 | [diff] [blame] | 229 | #define Py_IS_INFINITY(X) ((X) && (X)*0.5 == (X)) |
Thomas Wouters | 1e0c2f4 | 2000-07-24 16:06:23 +0000 | [diff] [blame] | 230 | |
Tim Peters | 1de41bf | 2002-07-03 03:31:20 +0000 | [diff] [blame] | 231 | /* HUGE_VAL is supposed to expand to a positive double infinity. Python |
| 232 | * uses Py_HUGE_VAL instead because some platforms are broken in this |
| 233 | * respect. We used to embed code in pyport.h to try to worm around that, |
| 234 | * but different platforms are broken in conflicting ways. If you're on |
| 235 | * a platform where HUGE_VAL is defined incorrectly, fiddle your Python |
| 236 | * config to #define Py_HUGE_VAL to something that works on your platform. |
Tim Peters | a40c793 | 2001-09-05 22:36:56 +0000 | [diff] [blame] | 237 | */ |
Tim Peters | 1de41bf | 2002-07-03 03:31:20 +0000 | [diff] [blame] | 238 | #ifndef Py_HUGE_VAL |
Tim Peters | a40c793 | 2001-09-05 22:36:56 +0000 | [diff] [blame] | 239 | #define Py_HUGE_VAL HUGE_VAL |
| 240 | #endif |
| 241 | |
Tim Peters | 57f282a | 2001-09-05 05:38:10 +0000 | [diff] [blame] | 242 | /* Py_OVERFLOWED(X) |
| 243 | * Return 1 iff a libm function overflowed. Set errno to 0 before calling |
| 244 | * a libm function, and invoke this macro after, passing the function |
| 245 | * result. |
| 246 | * Caution: |
| 247 | * This isn't reliable. C99 no longer requires libm to set errno under |
Tim Peters | d893fd6 | 2001-09-05 06:24:24 +0000 | [diff] [blame] | 248 | * any exceptional condition, but does require +- HUGE_VAL return |
| 249 | * values on overflow. A 754 box *probably* maps HUGE_VAL to a |
| 250 | * double infinity, and we're cool if that's so, unless the input |
| 251 | * was an infinity and an infinity is the expected result. A C89 |
| 252 | * system sets errno to ERANGE, so we check for that too. We're |
Tim Peters | 57f282a | 2001-09-05 05:38:10 +0000 | [diff] [blame] | 253 | * out of luck if a C99 754 box doesn't map HUGE_VAL to +Inf, or |
| 254 | * if the returned result is a NaN, or if a C89 box returns HUGE_VAL |
| 255 | * in non-overflow cases. |
| 256 | * X is evaluated more than once. |
Tim Peters | 4643bd9 | 2002-12-28 21:56:08 +0000 | [diff] [blame] | 257 | * Some platforms have better way to spell this, so expect some #ifdef'ery. |
Anthony Baxter | 83dd43f | 2003-09-30 14:58:59 +0000 | [diff] [blame] | 258 | * |
| 259 | * OpenBSD uses 'isinf()' because a compiler bug on that platform causes |
| 260 | * the longer macro version to be mis-compiled. This isn't optimal, and |
| 261 | * should be removed once a newer compiler is available on that platform. |
| 262 | * The system that had the failure was running OpenBSD 3.2 on Intel, with |
| 263 | * gcc 2.95.3. |
| 264 | * |
| 265 | * According to Tim's checkin, the FreeBSD systems use isinf() to work |
| 266 | * around a FPE bug on that platform. |
Tim Peters | 57f282a | 2001-09-05 05:38:10 +0000 | [diff] [blame] | 267 | */ |
Anthony Baxter | 83dd43f | 2003-09-30 14:58:59 +0000 | [diff] [blame] | 268 | #if defined(__FreeBSD__) || defined(__OpenBSD__) |
Tim Peters | 4643bd9 | 2002-12-28 21:56:08 +0000 | [diff] [blame] | 269 | #define Py_OVERFLOWED(X) isinf(X) |
| 270 | #else |
Tim Peters | a40c793 | 2001-09-05 22:36:56 +0000 | [diff] [blame] | 271 | #define Py_OVERFLOWED(X) ((X) != 0.0 && (errno == ERANGE || \ |
| 272 | (X) == Py_HUGE_VAL || \ |
| 273 | (X) == -Py_HUGE_VAL)) |
Tim Peters | 4643bd9 | 2002-12-28 21:56:08 +0000 | [diff] [blame] | 274 | #endif |
Tim Peters | a40c793 | 2001-09-05 22:36:56 +0000 | [diff] [blame] | 275 | |
Hye-Shik Chang | 77d9a3e | 2004-03-22 08:43:55 +0000 | [diff] [blame] | 276 | /* Py_SET_ERRNO_ON_MATH_ERROR(x) |
Tim Peters | a40c793 | 2001-09-05 22:36:56 +0000 | [diff] [blame] | 277 | * If a libm function did not set errno, but it looks like the result |
Hye-Shik Chang | 77d9a3e | 2004-03-22 08:43:55 +0000 | [diff] [blame] | 278 | * overflowed or not-a-number, set errno to ERANGE or EDOM. Set errno |
| 279 | * to 0 before calling a libm function, and invoke this macro after, |
| 280 | * passing the function result. |
Tim Peters | a40c793 | 2001-09-05 22:36:56 +0000 | [diff] [blame] | 281 | * Caution: |
| 282 | * This isn't reliable. See Py_OVERFLOWED comments. |
| 283 | * X is evaluated more than once. |
| 284 | */ |
Hye-Shik Chang | 77d9a3e | 2004-03-22 08:43:55 +0000 | [diff] [blame] | 285 | #if defined(__FreeBSD__) || defined(__OpenBSD__) |
| 286 | #define _Py_SET_EDOM_FOR_NAN(X) if (isnan(X)) errno = EDOM; |
| 287 | #else |
| 288 | #define _Py_SET_EDOM_FOR_NAN(X) ; |
| 289 | #endif |
| 290 | #define Py_SET_ERRNO_ON_MATH_ERROR(X) \ |
Tim Peters | a40c793 | 2001-09-05 22:36:56 +0000 | [diff] [blame] | 291 | do { \ |
Hye-Shik Chang | 77d9a3e | 2004-03-22 08:43:55 +0000 | [diff] [blame] | 292 | if (errno == 0) { \ |
| 293 | if ((X) == Py_HUGE_VAL || (X) == -Py_HUGE_VAL) \ |
| 294 | errno = ERANGE; \ |
| 295 | else _Py_SET_EDOM_FOR_NAN(X) \ |
| 296 | } \ |
Tim Peters | a40c793 | 2001-09-05 22:36:56 +0000 | [diff] [blame] | 297 | } while(0) |
Tim Peters | 57f282a | 2001-09-05 05:38:10 +0000 | [diff] [blame] | 298 | |
Hye-Shik Chang | 77d9a3e | 2004-03-22 08:43:55 +0000 | [diff] [blame] | 299 | /* Py_SET_ERANGE_ON_OVERFLOW(x) |
| 300 | * An alias of Py_SET_ERRNO_ON_MATH_ERROR for backward-compatibility. |
| 301 | */ |
| 302 | #define Py_SET_ERANGE_IF_OVERFLOW(X) Py_SET_ERRNO_ON_MATH_ERROR(X) |
| 303 | |
Tim Peters | dc5a508 | 2002-03-09 04:58:24 +0000 | [diff] [blame] | 304 | /* Py_ADJUST_ERANGE1(x) |
| 305 | * Py_ADJUST_ERANGE2(x, y) |
| 306 | * Set errno to 0 before calling a libm function, and invoke one of these |
| 307 | * macros after, passing the function result(s) (Py_ADJUST_ERANGE2 is useful |
| 308 | * for functions returning complex results). This makes two kinds of |
| 309 | * adjustments to errno: (A) If it looks like the platform libm set |
| 310 | * errno=ERANGE due to underflow, clear errno. (B) If it looks like the |
| 311 | * platform libm overflowed but didn't set errno, force errno to ERANGE. In |
| 312 | * effect, we're trying to force a useful implementation of C89 errno |
| 313 | * behavior. |
| 314 | * Caution: |
| 315 | * This isn't reliable. See Py_OVERFLOWED comments. |
| 316 | * X and Y may be evaluated more than once. |
| 317 | */ |
| 318 | #define Py_ADJUST_ERANGE1(X) \ |
| 319 | do { \ |
| 320 | if (errno == 0) { \ |
| 321 | if ((X) == Py_HUGE_VAL || (X) == -Py_HUGE_VAL) \ |
| 322 | errno = ERANGE; \ |
| 323 | } \ |
| 324 | else if (errno == ERANGE && (X) == 0.0) \ |
| 325 | errno = 0; \ |
| 326 | } while(0) |
| 327 | |
| 328 | #define Py_ADJUST_ERANGE2(X, Y) \ |
| 329 | do { \ |
| 330 | if ((X) == Py_HUGE_VAL || (X) == -Py_HUGE_VAL || \ |
| 331 | (Y) == Py_HUGE_VAL || (Y) == -Py_HUGE_VAL) { \ |
| 332 | if (errno == 0) \ |
| 333 | errno = ERANGE; \ |
| 334 | } \ |
| 335 | else if (errno == ERANGE) \ |
| 336 | errno = 0; \ |
| 337 | } while(0) |
| 338 | |
Neal Norwitz | 8029264 | 2002-12-19 15:12:26 +0000 | [diff] [blame] | 339 | /* Py_DEPRECATED(version) |
Neal Norwitz | 93344ab | 2002-12-19 15:24:11 +0000 | [diff] [blame] | 340 | * Declare a variable, type, or function deprecated. |
Neal Norwitz | 8029264 | 2002-12-19 15:12:26 +0000 | [diff] [blame] | 341 | * Usage: |
| 342 | * extern int old_var Py_DEPRECATED(2.3); |
| 343 | * typedef int T1 Py_DEPRECATED(2.4); |
| 344 | * extern int x() Py_DEPRECATED(2.5); |
| 345 | */ |
| 346 | #if defined(__GNUC__) && (__GNUC__ == 3) && (__GNUC_MINOR__ >= 1) |
| 347 | #define Py_DEPRECATED(VERSION_UNUSED) __attribute__((__deprecated__)) |
| 348 | #else |
Tim Peters | 4643bd9 | 2002-12-28 21:56:08 +0000 | [diff] [blame] | 349 | #define Py_DEPRECATED(VERSION_UNUSED) |
Neal Norwitz | 8029264 | 2002-12-19 15:12:26 +0000 | [diff] [blame] | 350 | #endif |
| 351 | |
Thomas Wouters | 1e0c2f4 | 2000-07-24 16:06:23 +0000 | [diff] [blame] | 352 | /************************************************************************** |
| 353 | Prototypes that are missing from the standard include files on some systems |
| 354 | (and possibly only some versions of such systems.) |
| 355 | |
| 356 | Please be conservative with adding new ones, document them and enclose them |
| 357 | in platform-specific #ifdefs. |
| 358 | **************************************************************************/ |
| 359 | |
| 360 | #ifdef SOLARIS |
| 361 | /* Unchecked */ |
| 362 | extern int gethostname(char *, int); |
| 363 | #endif |
| 364 | |
| 365 | #ifdef __BEOS__ |
| 366 | /* Unchecked */ |
| 367 | /* It's in the libs, but not the headers... - [cjh] */ |
Tim Peters | 60f42b5 | 2001-01-18 03:03:16 +0000 | [diff] [blame] | 368 | int shutdown( int, int ); |
Thomas Wouters | 1e0c2f4 | 2000-07-24 16:06:23 +0000 | [diff] [blame] | 369 | #endif |
| 370 | |
| 371 | #ifdef HAVE__GETPTY |
Sjoerd Mullender | 0765fe3 | 2000-07-26 15:46:29 +0000 | [diff] [blame] | 372 | #include <sys/types.h> /* we need to import mode_t */ |
Thomas Wouters | 1e0c2f4 | 2000-07-24 16:06:23 +0000 | [diff] [blame] | 373 | extern char * _getpty(int *, int, mode_t, int); |
| 374 | #endif |
| 375 | |
| 376 | #if defined(HAVE_OPENPTY) || defined(HAVE_FORKPTY) |
| 377 | #if !defined(HAVE_PTY_H) && !defined(HAVE_LIBUTIL_H) |
| 378 | /* BSDI does not supply a prototype for the 'openpty' and 'forkpty' |
| 379 | functions, even though they are included in libutil. */ |
| 380 | #include <termios.h> |
| 381 | extern int openpty(int *, int *, char *, struct termios *, struct winsize *); |
| 382 | extern int forkpty(int *, char *, struct termios *, struct winsize *); |
| 383 | #endif /* !defined(HAVE_PTY_H) && !defined(HAVE_LIBUTIL_H) */ |
| 384 | #endif /* defined(HAVE_OPENPTY) || defined(HAVE_FORKPTY) */ |
| 385 | |
| 386 | |
| 387 | /* These are pulled from various places. It isn't obvious on what platforms |
| 388 | they are necessary, nor what the exact prototype should look like (which |
| 389 | is likely to vary between platforms!) If you find you need one of these |
| 390 | declarations, please move them to a platform-specific block and include |
| 391 | proper prototypes. */ |
| 392 | #if 0 |
| 393 | |
| 394 | /* From Modules/resource.c */ |
| 395 | extern int getrusage(); |
| 396 | extern int getpagesize(); |
| 397 | |
| 398 | /* From Python/sysmodule.c and Modules/posixmodule.c */ |
| 399 | extern int fclose(FILE *); |
| 400 | |
| 401 | /* From Modules/posixmodule.c */ |
| 402 | extern int fdatasync(int); |
Thomas Wouters | 1e0c2f4 | 2000-07-24 16:06:23 +0000 | [diff] [blame] | 403 | #endif /* 0 */ |
| 404 | |
Peter Schneider-Kamp | 7e01890 | 2000-07-31 15:28:04 +0000 | [diff] [blame] | 405 | |
| 406 | /************************ |
| 407 | * WRAPPER FOR <math.h> * |
| 408 | ************************/ |
| 409 | |
Peter Schneider-Kamp | 7e01890 | 2000-07-31 15:28:04 +0000 | [diff] [blame] | 410 | #ifndef HAVE_HYPOT |
| 411 | extern double hypot(double, double); |
Tim Peters | 60f42b5 | 2001-01-18 03:03:16 +0000 | [diff] [blame] | 412 | #endif |
Peter Schneider-Kamp | 7e01890 | 2000-07-31 15:28:04 +0000 | [diff] [blame] | 413 | |
Mark Hammond | 8235ea1 | 2002-07-19 06:55:41 +0000 | [diff] [blame] | 414 | /* Declarations for symbol visibility. |
| 415 | |
| 416 | PyAPI_FUNC(type): Declares a public Python API function and return type |
Tim Peters | 4643bd9 | 2002-12-28 21:56:08 +0000 | [diff] [blame] | 417 | PyAPI_DATA(type): Declares public Python data and its type |
Mark Hammond | 8235ea1 | 2002-07-19 06:55:41 +0000 | [diff] [blame] | 418 | PyMODINIT_FUNC: A Python module init function. If these functions are |
Tim Peters | 4643bd9 | 2002-12-28 21:56:08 +0000 | [diff] [blame] | 419 | inside the Python core, they are private to the core. |
| 420 | If in an extension module, it may be declared with |
Mark Hammond | 8235ea1 | 2002-07-19 06:55:41 +0000 | [diff] [blame] | 421 | external linkage depending on the platform. |
| 422 | |
| 423 | As a number of platforms support/require "__declspec(dllimport/dllexport)", |
| 424 | we support a HAVE_DECLSPEC_DLL macro to save duplication. |
| 425 | */ |
| 426 | |
Tim Peters | 4643bd9 | 2002-12-28 21:56:08 +0000 | [diff] [blame] | 427 | /* |
Michael W. Hudson | f163d10 | 2003-02-10 19:36:46 +0000 | [diff] [blame] | 428 | All windows ports, except cygwin, are handled in PC/pyconfig.h. |
| 429 | |
| 430 | BeOS and cygwin are the only other autoconf platform requiring special |
| 431 | linkage handling and both of these use __declspec(). |
Mark Hammond | 8235ea1 | 2002-07-19 06:55:41 +0000 | [diff] [blame] | 432 | */ |
| 433 | #if defined(__CYGWIN__) || defined(__BEOS__) |
| 434 | # define HAVE_DECLSPEC_DLL |
Peter Schneider-Kamp | 7e01890 | 2000-07-31 15:28:04 +0000 | [diff] [blame] | 435 | #endif |
Mark Hammond | 8235ea1 | 2002-07-19 06:55:41 +0000 | [diff] [blame] | 436 | |
Jason Tishler | 3076559 | 2003-09-04 11:04:06 +0000 | [diff] [blame] | 437 | /* only get special linkage if built as shared or platform is Cygwin */ |
| 438 | #if defined(Py_ENABLE_SHARED) || defined(__CYGWIN__) |
Mark Hammond | 8235ea1 | 2002-07-19 06:55:41 +0000 | [diff] [blame] | 439 | # if defined(HAVE_DECLSPEC_DLL) |
| 440 | # ifdef Py_BUILD_CORE |
| 441 | # define PyAPI_FUNC(RTYPE) __declspec(dllexport) RTYPE |
Mark Hammond | a290527 | 2002-07-29 13:42:14 +0000 | [diff] [blame] | 442 | # define PyAPI_DATA(RTYPE) extern __declspec(dllexport) RTYPE |
Mark Hammond | 8235ea1 | 2002-07-19 06:55:41 +0000 | [diff] [blame] | 443 | /* module init functions inside the core need no external linkage */ |
Jason Tishler | 6bc06ec | 2003-09-04 11:59:50 +0000 | [diff] [blame] | 444 | /* except for Cygwin to handle embedding (FIXME: BeOS too?) */ |
| 445 | # if defined(__CYGWIN__) |
| 446 | # define PyMODINIT_FUNC __declspec(dllexport) void |
| 447 | # else /* __CYGWIN__ */ |
| 448 | # define PyMODINIT_FUNC void |
| 449 | # endif /* __CYGWIN__ */ |
Mark Hammond | 8235ea1 | 2002-07-19 06:55:41 +0000 | [diff] [blame] | 450 | # else /* Py_BUILD_CORE */ |
| 451 | /* Building an extension module, or an embedded situation */ |
| 452 | /* public Python functions and data are imported */ |
Jason Tishler | fb8595d | 2003-01-06 12:41:26 +0000 | [diff] [blame] | 453 | /* Under Cygwin, auto-import functions to prevent compilation */ |
| 454 | /* failures similar to http://python.org/doc/FAQ.html#3.24 */ |
| 455 | # if !defined(__CYGWIN__) |
| 456 | # define PyAPI_FUNC(RTYPE) __declspec(dllimport) RTYPE |
| 457 | # endif /* !__CYGWIN__ */ |
Mark Hammond | a290527 | 2002-07-29 13:42:14 +0000 | [diff] [blame] | 458 | # define PyAPI_DATA(RTYPE) extern __declspec(dllimport) RTYPE |
Mark Hammond | 8235ea1 | 2002-07-19 06:55:41 +0000 | [diff] [blame] | 459 | /* module init functions outside the core must be exported */ |
| 460 | # if defined(__cplusplus) |
| 461 | # define PyMODINIT_FUNC extern "C" __declspec(dllexport) void |
| 462 | # else /* __cplusplus */ |
| 463 | # define PyMODINIT_FUNC __declspec(dllexport) void |
| 464 | # endif /* __cplusplus */ |
| 465 | # endif /* Py_BUILD_CORE */ |
| 466 | # endif /* HAVE_DECLSPEC */ |
| 467 | #endif /* Py_ENABLE_SHARED */ |
| 468 | |
| 469 | /* If no external linkage macros defined by now, create defaults */ |
| 470 | #ifndef PyAPI_FUNC |
| 471 | # define PyAPI_FUNC(RTYPE) RTYPE |
| 472 | #endif |
| 473 | #ifndef PyAPI_DATA |
Mark Hammond | a290527 | 2002-07-29 13:42:14 +0000 | [diff] [blame] | 474 | # define PyAPI_DATA(RTYPE) extern RTYPE |
Mark Hammond | 8235ea1 | 2002-07-19 06:55:41 +0000 | [diff] [blame] | 475 | #endif |
| 476 | #ifndef PyMODINIT_FUNC |
| 477 | # if defined(__cplusplus) |
| 478 | # define PyMODINIT_FUNC extern "C" void |
| 479 | # else /* __cplusplus */ |
| 480 | # define PyMODINIT_FUNC void |
| 481 | # endif /* __cplusplus */ |
| 482 | #endif |
| 483 | |
| 484 | /* Deprecated DL_IMPORT and DL_EXPORT macros */ |
| 485 | #if defined(Py_ENABLE_SHARED) && defined (HAVE_DECLSPEC_DLL) |
| 486 | # if defined(Py_BUILD_CORE) |
| 487 | # define DL_IMPORT(RTYPE) __declspec(dllexport) RTYPE |
| 488 | # define DL_EXPORT(RTYPE) __declspec(dllexport) RTYPE |
| 489 | # else |
| 490 | # define DL_IMPORT(RTYPE) __declspec(dllimport) RTYPE |
| 491 | # define DL_EXPORT(RTYPE) __declspec(dllexport) RTYPE |
| 492 | # endif |
| 493 | #endif |
| 494 | #ifndef DL_EXPORT |
| 495 | # define DL_EXPORT(RTYPE) RTYPE |
| 496 | #endif |
| 497 | #ifndef DL_IMPORT |
| 498 | # define DL_IMPORT(RTYPE) RTYPE |
| 499 | #endif |
| 500 | /* End of deprecated DL_* macros */ |
Peter Schneider-Kamp | 7e01890 | 2000-07-31 15:28:04 +0000 | [diff] [blame] | 501 | |
Peter Schneider-Kamp | 7e01890 | 2000-07-31 15:28:04 +0000 | [diff] [blame] | 502 | /* If the fd manipulation macros aren't defined, |
| 503 | here is a set that should do the job */ |
| 504 | |
Guido van Rossum | 367e46a | 2000-08-01 18:28:44 +0000 | [diff] [blame] | 505 | #if 0 /* disabled and probably obsolete */ |
Peter Schneider-Kamp | 1c2b178 | 2000-08-01 16:53:44 +0000 | [diff] [blame] | 506 | |
Peter Schneider-Kamp | 7e01890 | 2000-07-31 15:28:04 +0000 | [diff] [blame] | 507 | #ifndef FD_SETSIZE |
| 508 | #define FD_SETSIZE 256 |
| 509 | #endif |
| 510 | |
| 511 | #ifndef FD_SET |
| 512 | |
| 513 | typedef long fd_mask; |
| 514 | |
| 515 | #define NFDBITS (sizeof(fd_mask) * NBBY) /* bits per mask */ |
| 516 | #ifndef howmany |
| 517 | #define howmany(x, y) (((x)+((y)-1))/(y)) |
| 518 | #endif /* howmany */ |
| 519 | |
| 520 | typedef struct fd_set { |
| 521 | fd_mask fds_bits[howmany(FD_SETSIZE, NFDBITS)]; |
| 522 | } fd_set; |
| 523 | |
| 524 | #define FD_SET(n, p) ((p)->fds_bits[(n)/NFDBITS] |= (1 << ((n) % NFDBITS))) |
| 525 | #define FD_CLR(n, p) ((p)->fds_bits[(n)/NFDBITS] &= ~(1 << ((n) % NFDBITS))) |
| 526 | #define FD_ISSET(n, p) ((p)->fds_bits[(n)/NFDBITS] & (1 << ((n) % NFDBITS))) |
| 527 | #define FD_ZERO(p) memset((char *)(p), '\0', sizeof(*(p))) |
| 528 | |
| 529 | #endif /* FD_SET */ |
Peter Schneider-Kamp | 1c2b178 | 2000-08-01 16:53:44 +0000 | [diff] [blame] | 530 | |
| 531 | #endif /* fd manipulation macros */ |
| 532 | |
Vladimir Marangozov | 2c57e07 | 2000-08-11 11:48:33 +0000 | [diff] [blame] | 533 | |
Fred Drake | d5fadf7 | 2000-09-26 05:46:01 +0000 | [diff] [blame] | 534 | /* limits.h constants that may be missing */ |
| 535 | |
| 536 | #ifndef INT_MAX |
| 537 | #define INT_MAX 2147483647 |
| 538 | #endif |
| 539 | |
| 540 | #ifndef LONG_MAX |
| 541 | #if SIZEOF_LONG == 4 |
| 542 | #define LONG_MAX 0X7FFFFFFFL |
| 543 | #elif SIZEOF_LONG == 8 |
| 544 | #define LONG_MAX 0X7FFFFFFFFFFFFFFFL |
| 545 | #else |
| 546 | #error "could not set LONG_MAX in pyport.h" |
| 547 | #endif |
| 548 | #endif |
| 549 | |
| 550 | #ifndef LONG_MIN |
| 551 | #define LONG_MIN (-LONG_MAX-1) |
| 552 | #endif |
| 553 | |
Tim Peters | d57731f | 2000-10-05 01:42:25 +0000 | [diff] [blame] | 554 | #ifndef LONG_BIT |
| 555 | #define LONG_BIT (8 * SIZEOF_LONG) |
| 556 | #endif |
| 557 | |
| 558 | #if LONG_BIT != 8 * SIZEOF_LONG |
| 559 | /* 04-Oct-2000 LONG_BIT is apparently (mis)defined as 64 on some recent |
| 560 | * 32-bit platforms using gcc. We try to catch that here at compile-time |
| 561 | * rather than waiting for integer multiplication to trigger bogus |
| 562 | * overflows. |
| 563 | */ |
Andrew M. Kuchling | 234fb63 | 2001-01-12 15:06:28 +0000 | [diff] [blame] | 564 | #error "LONG_BIT definition appears wrong for platform (bad gcc/glibc config?)." |
Tim Peters | d57731f | 2000-10-05 01:42:25 +0000 | [diff] [blame] | 565 | #endif |
| 566 | |
Tim Peters | 7d3a511 | 2000-07-08 04:17:21 +0000 | [diff] [blame] | 567 | #ifdef __cplusplus |
| 568 | } |
| 569 | #endif |
| 570 | |
Neil Schemenauer | 1569108 | 2001-10-23 02:20:37 +0000 | [diff] [blame] | 571 | /* |
| 572 | * Hide GCC attributes from compilers that don't support them. |
| 573 | */ |
Guido van Rossum | bd67d6f | 2001-10-27 21:16:16 +0000 | [diff] [blame] | 574 | #if (!defined(__GNUC__) || __GNUC__ < 2 || \ |
Jack Jansen | 4892f24 | 2002-02-01 15:46:29 +0000 | [diff] [blame] | 575 | (__GNUC__ == 2 && __GNUC_MINOR__ < 7) ) && \ |
Guido van Rossum | bd67d6f | 2001-10-27 21:16:16 +0000 | [diff] [blame] | 576 | !defined(RISCOS) |
Neil Schemenauer | 96aa0ac | 2002-09-15 14:09:54 +0000 | [diff] [blame] | 577 | #define Py_GCC_ATTRIBUTE(x) |
| 578 | #else |
| 579 | #define Py_GCC_ATTRIBUTE(x) __attribute__(x) |
Neil Schemenauer | 1569108 | 2001-10-23 02:20:37 +0000 | [diff] [blame] | 580 | #endif |
| 581 | |
Tim Peters | 7d3a511 | 2000-07-08 04:17:21 +0000 | [diff] [blame] | 582 | #endif /* Py_PYPORT_H */ |