The Tcpdump Group git mirrors - tcpdump/blob - netdissect-stdinc.h

   1 /*
   2  * Copyright (c) 2002 - 2003
   3  * NetGroup, Politecnico di Torino (Italy)
   4  * All rights reserved.
   5  *
   6  * Redistribution and use in source and binary forms, with or without
   7  * modification, are permitted provided that the following conditions
   8  * are met:
   9  *
  10  * 1. Redistributions of source code must retain the above copyright
  11  * notice, this list of conditions and the following disclaimer.
  12  * 2. Redistributions in binary form must reproduce the above copyright
  13  * notice, this list of conditions and the following disclaimer in the
  14  * documentation and/or other materials provided with the distribution.
  15  * 3. Neither the name of the Politecnico di Torino nor the names of its
  16  * contributors may be used to endorse or promote products derived from
  17  * this software without specific prior written permission.
  18  *
  19  * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
  20  * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
  21  * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
  22  * A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
  23  * OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
  24  * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
  25  * LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
  26  * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
  27  * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
  28  * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
  29  * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
  30  */
  31
  32 /*
  33  * Include the appropriate OS header files on Windows and various flavors
  34  * of UNIX, include various non-OS header files on Windows, and define
  35  * various items as needed, to isolate most of netdissect's platform
  36  * differences to this one file.
  37  */
  38
  39 #ifndef netdissect_stdinc_h
  40 #define netdissect_stdinc_h
  41
  42 #include <errno.h>
  43
  44 #include "compiler-tests.h"
  45
  46 #include "varattrs.h"
  47
  48 /*
  49  * Get the C99 types, and the PRI[doux]64 format strings, defined.
  50  */
  51 #ifdef HAVE_PCAP_PCAP_INTTYPES_H
  52   /*
  53    * We have pcap/pcap-inttypes.h; use that, as it'll do all the
  54    * work, and won't cause problems if a file includes this file
  55    * and later includes a pcap header file that also includes
  56    * pcap/pcap-inttypes.h.
  57    */
  58   #include <pcap/pcap-inttypes.h>
  59 #else
  60   /*
  61    * OK, we don't have pcap/pcap-inttypes.h, so we'll have to
  62    * do the work ourselves, but at least we don't have to
  63    * worry about other headers including it and causing
  64    * clashes.
  65    */
  66   #if defined(_MSC_VER)
  67     /*
  68      * Compiler is MSVC.
  69      */
  70     #if _MSC_VER >= 1800
  71       /*
  72        * VS 2013 or newer; we have <inttypes.h>.
  73        */
  74       #include <inttypes.h>
  75     #else
  76       /*
  77        * Earlier VS; we have to define this stuff ourselves.
  78        */
  79       typedef unsigned char uint8_t;
  80       typedef signed char int8_t;
  81       typedef unsigned short uint16_t;
  82       typedef signed short int16_t;
  83       typedef unsigned int uint32_t;
  84       typedef signed int int32_t;
  85       #ifdef _MSC_EXTENSIONS
  86         typedef unsigned _int64 uint64_t;
  87         typedef _int64 int64_t;
  88       #else /* _MSC_EXTENSIONS */
  89         typedef unsigned long long uint64_t;
  90         typedef long long int64_t;
  91       #endif
  92
  93       /*
  94        * We have _strtoi64().  Use that for strtoint64_t().
  95        */
  96       #define strtoint64_t      _strtoi64
  97     #endif
  98
  99     /*
 100      * Suppress definition of intN_t in bittypes.h, which might be included
 101      * by <pcap/pcap.h> in older versions of WinPcap.
 102      * (Yes, HAVE_U_INTn_T, as the definition guards are UN*X-oriented, and
 103      * we check for u_intN_t in the UN*X configure script.)
 104      */
 105     #define HAVE_U_INT8_T
 106     #define HAVE_U_INT16_T
 107     #define HAVE_U_INT32_T
 108     #define HAVE_U_INT64_T
 109
 110     /*
 111      * These may be defined by <inttypes.h>.  If not, define them
 112      * ourselves.
 113      *
 114      * XXX - for MSVC, we always want the _MSC_EXTENSIONS versions.
 115      * What about other compilers?  If, as the MinGW Web site says MinGW
 116      * does, the other compilers just use Microsoft's run-time library,
 117      * then they should probably use the _MSC_EXTENSIONS even if the
 118      * compiler doesn't define _MSC_EXTENSIONS.
 119      */
 120     #ifndef PRId64
 121       #ifdef _MSC_EXTENSIONS
 122         #define PRId64  "I64d"
 123       #else
 124         #define PRId64  "lld"
 125       #endif
 126     #endif /* PRId64 */
 127
 128     #ifndef PRIo64
 129       #ifdef _MSC_EXTENSIONS
 130         #define PRIo64  "I64o"
 131       #else
 132         #define PRIo64  "llo"
 133       #endif
 134     #endif /* PRIo64 */
 135
 136     #ifndef PRIx64
 137       #ifdef _MSC_EXTENSIONS
 138         #define PRIx64  "I64x"
 139       #else
 140         #define PRIx64  "llx"
 141       #endif
 142     #endif
 143
 144     #ifndef PRIu64
 145       #ifdef _MSC_EXTENSIONS
 146         #define PRIu64  "I64u"
 147       #else
 148         #define PRIu64  "llu"
 149       #endif
 150     #endif
 151   #elif defined(__MINGW32__) || !defined(_WIN32)
 152     /*
 153      * Compiler is MinGW or target is UN*X or MS-DOS.  Just use
 154      * <inttypes.h>.
 155      */
 156     #include <inttypes.h>
 157   #endif
 158 #endif /* HAVE_PCAP_PCAP_INTTYPES_H */
 159
 160 #ifdef _WIN32
 161
 162 /*
 163  * Includes and definitions for Windows.
 164  */
 165
 166 #include <stdio.h>
 167 #include <winsock2.h>
 168 #include <ws2tcpip.h>
 169 #include <ctype.h>
 170 #include <time.h>
 171 #include <io.h>
 172 #include <fcntl.h>
 173 #include <sys/types.h>
 174
 175 #ifdef _MSC_VER
 176   /*
 177    * Compiler is MSVC.
 178    */
 179   #if _MSC_VER >= 1800
 180     /*
 181      * VS 2013 or newer; we have strtoll().  Use that for strtoint64_t().
 182      */
 183     #define strtoint64_t        strtoll
 184   #else
 185     /*
 186      * Earlier VS; we don't have strtoll(), but we do have
 187      * _strtoi64().  Use that for strtoint64_t().
 188      */
 189     #define strtoint64_t        _strtoi64
 190   #endif
 191
 192   /*
 193    * Microsoft's documentation doesn't speak of LL as a valid
 194    * suffix for 64-bit integers, so we'll just use i64.
 195    */
 196   #define INT64_T_CONSTANT(constant)    (constant##i64)
 197 #else
 198   /*
 199    * Non-Microsoft compiler.
 200    *
 201    * XXX - should we use strtoll or should we use _strtoi64()?
 202    */
 203   #define strtoint64_t          strtoll
 204
 205   /*
 206    * Assume LL works.
 207    */
 208   #define INT64_T_CONSTANT(constant)    (constant##LL)
 209 #endif
 210
 211 #ifdef _MSC_VER
 212   /*
 213    * Microsoft tries to avoid polluting the C namespace with UN*Xisms,
 214    * by adding a preceding underscore; we *want* the UN*Xisms, so add
 215    * #defines to let us use them.
 216    */
 217   #define isascii __isascii
 218   #define stat _stat
 219   #define strdup _strdup
 220   #define open _open
 221   #define fstat _fstat
 222   #define read _read
 223   #define close _close
 224   #define O_RDONLY _O_RDONLY
 225
 226   /*
 227    * If <crtdbg.h> has been included, and _DEBUG is defined, and
 228    * __STDC__ is zero, <crtdbg.h> will define strdup() to call
 229    * _strdup_dbg().  So if it's already defined, don't redefine
 230    * it.
 231    */
 232   #ifndef strdup
 233     #define strdup _strdup
 234   #endif
 235 #endif  /* _MSC_VER */
 236
 237 /*
 238  * With MSVC, for C, __inline is used to make a function an inline.
 239  */
 240 #ifdef _MSC_VER
 241 #define inline __inline
 242 #endif
 243
 244 #if defined(AF_INET6) && !defined(HAVE_OS_IPV6_SUPPORT)
 245 #define HAVE_OS_IPV6_SUPPORT
 246 #endif
 247
 248 #ifndef INET6_ADDRSTRLEN
 249 #define INET6_ADDRSTRLEN 46
 250 #endif
 251
 252 /* It is in MSVC's <errno.h>, but not defined in MingW+Watcom.
 253  */
 254 #ifndef EAFNOSUPPORT
 255 #define EAFNOSUPPORT WSAEAFNOSUPPORT
 256 #endif
 257
 258 #ifndef caddr_t
 259 typedef char* caddr_t;
 260 #endif /* caddr_t */
 261
 262 #define MAXHOSTNAMELEN  64
 263
 264 #else /* _WIN32 */
 265
 266 /*
 267  * Includes and definitions for various flavors of UN*X.
 268  */
 269
 270 #include <ctype.h>
 271 #include <unistd.h>
 272 #include <netdb.h>
 273 #include <sys/param.h>
 274 #include <sys/types.h>                  /* concession to AIX */
 275 #include <sys/time.h>
 276 #include <sys/socket.h>
 277 #include <netinet/in.h>
 278
 279 #include <time.h>
 280
 281 #include <arpa/inet.h>
 282
 283 /*
 284  * Assume all UN*Xes have strtoll(), and use it for strtoint64_t().
 285  */
 286 #define strtoint64_t    strtoll
 287
 288 /*
 289  * Assume LL works.
 290  */
 291 #define INT64_T_CONSTANT(constant)      (constant##LL)
 292
 293 #endif /* _WIN32 */
 294
 295 /*
 296  * Function attributes, for various compilers.
 297  */
 298 #include "funcattrs.h"
 299
 300 /*
 301  * On Windows, snprintf(), with that name and with C99 behavior - i.e.,
 302  * guaranteeing that the formatted string is null-terminated - didn't
 303  * appear until Visual Studio 2015.  Prior to that, the C runtime had
 304  * only _snprintf(), which *doesn't* guarantee that the string is
 305  * null-terminated if it is truncated due to the buffer being too
 306  * small.  We therefore can't just define snprintf to be _snprintf
 307  * and define vsnprintf to be _vsnprintf, as we're relying on null-
 308  * termination of strings in all cases.
 309  *
 310  * Furthermore, some versions of Visual Studio prior to Visual
 311  * Studio 2015 had vsnprintf() (but not snprintf()!), but those
 312  * versions don't guarantee null termination, either.
 313  *
 314  * We assume all UN*Xes that have snprintf() and vsnprintf() provide
 315  * C99 behavior.
 316  */
 317 #if defined(_MSC_VER) || defined(__MINGW32__)
 318   #if defined(_MSC_VER) && _MSC_VER >= 1900
 319     /*
 320      * VS 2015 or newer; just use the C runtime's snprintf() and
 321      * vsnprintf().
 322      */
 323     #define nd_snprintf         snprintf
 324     #define nd_vsnprintf        vsnprintf
 325   #else /* defined(_MSC_VER) && _MSC_VER >= 1900 */
 326     /*
 327      * VS prior to 2015, or MingGW; assume we have _snprintf_s() and
 328      * _vsnprintf_s(), which guarantee null termination.
 329      */
 330     #define nd_snprintf(buf, buflen, fmt, ...) \
 331         _snprintf_s(buf, buflen, _TRUNCATE, fmt, __VA_ARGS__)
 332     #define nd_vsnprintf(buf, buflen, fmt, ap) \
 333         _vsnprintf_s(buf, buflen, _TRUNCATE, fmt, ap)
 334   #endif /* defined(_MSC_VER) && _MSC_VER >= 1900 */
 335 #else /* defined(_MSC_VER) || defined(__MINGW32__) */
 336   /*
 337    * Some other compiler, which we assume to be a UN*X compiler.
 338    * Use the system's snprintf() if we have it, otherwise use
 339    * our own implementation
 340    */
 341   #ifdef HAVE_SNPRINTF
 342     #define nd_snprintf         snprintf
 343   #else /* HAVE_SNPRINTF */
 344     int nd_snprintf (char *str, size_t sz, FORMAT_STRING(const char *format), ...)
 345         PRINTFLIKE(3, 4);
 346   #endif /* HAVE_SNPRINTF */
 347
 348   #ifdef HAVE_VSNPRINTF
 349     #define nd_vsnprintf        vsnprintf
 350   #else /* HAVE_VSNPRINTF */
 351     int nd_vsnprintf (char *str, size_t sz, FORMAT_STRING(const char *format),
 352         va_list ap) PRINTFLIKE(3, 0);
 353   #endif /* HAVE_VSNPRINTF */
 354 #endif /* defined(_MSC_VER) || defined(__MINGW32__) */
 355
 356 /*
 357  * fopen() read and write modes for text files and binary files.
 358  */
 359 #if defined(_WIN32) || defined(MSDOS)
 360   #define FOPEN_READ_TXT   "rt"
 361   #define FOPEN_READ_BIN   "rb"
 362   #define FOPEN_WRITE_TXT  "wt"
 363   #define FOPEN_WRITE_BIN  "wb"
 364 #else
 365   #define FOPEN_READ_TXT   "r"
 366   #define FOPEN_READ_BIN   FOPEN_READ_TXT
 367   #define FOPEN_WRITE_TXT  "w"
 368   #define FOPEN_WRITE_BIN  FOPEN_WRITE_TXT
 369 #endif
 370
 371 /*
 372  * Inline x86 assembler-language versions of ntoh[ls]() and hton[ls](),
 373  * defined if the OS doesn't provide them.  These assume no more than
 374  * an 80386, so, for example, it avoids the bswap instruction added in
 375  * the 80486.
 376  *
 377  * (We don't use them on macOS; Apple provides their own, which *doesn't*
 378  * avoid the bswap instruction, as macOS only supports machines that
 379  * have it.)
 380  */
 381 #if defined(__GNUC__) && defined(__i386__) && !defined(__APPLE__) && !defined(__ntohl)
 382   #undef ntohl
 383   #undef ntohs
 384   #undef htonl
 385   #undef htons
 386
 387   static __inline__ unsigned long __ntohl (unsigned long x);
 388   static __inline__ unsigned short __ntohs (unsigned short x);
 389
 390   #define ntohl(x)  __ntohl(x)
 391   #define ntohs(x)  __ntohs(x)
 392   #define htonl(x)  __ntohl(x)
 393   #define htons(x)  __ntohs(x)
 394
 395   static __inline__ unsigned long __ntohl (unsigned long x)
 396   {
 397     __asm__ ("xchgb %b0, %h0\n\t"   /* swap lower bytes  */
 398              "rorl  $16, %0\n\t"    /* swap words        */
 399              "xchgb %b0, %h0"       /* swap higher bytes */
 400             : "=q" (x) : "0" (x));
 401     return (x);
 402   }
 403
 404   static __inline__ unsigned short __ntohs (unsigned short x)
 405   {
 406     __asm__ ("xchgb %b0, %h0"       /* swap bytes */
 407             : "=q" (x) : "0" (x));
 408     return (x);
 409   }
 410 #endif
 411
 412 /*
 413  * If the OS doesn't define AF_INET6 and struct in6_addr:
 414  *
 415  * define AF_INET6, so we can use it internally as a "this is an
 416  * IPv6 address" indication;
 417  *
 418  * define struct in6_addr so that we can use it for IPv6 addresses.
 419  */
 420 #ifndef HAVE_OS_IPV6_SUPPORT
 421 #ifndef AF_INET6
 422 #define AF_INET6        24
 423
 424 struct in6_addr {
 425         union {
 426                 __uint8_t   __u6_addr8[16];
 427                 __uint16_t  __u6_addr16[8];
 428                 __uint32_t  __u6_addr32[4];
 429         } __u6_addr;                    /* 128-bit IP6 address */
 430 };
 431 #endif
 432 #endif
 433
 434 #ifndef NI_MAXHOST
 435 #define NI_MAXHOST      1025
 436 #endif
 437
 438 #ifndef INET_ADDRSTRLEN
 439 #define INET_ADDRSTRLEN 16
 440 #endif
 441
 442 #ifndef TRUE
 443 #define TRUE 1
 444 #endif
 445
 446 #ifndef FALSE
 447 #define FALSE 0
 448 #endif
 449
 450 /*
 451  * The Apple deprecation workaround macros below were adopted from the
 452  * FreeRADIUS server code under permission of Alan DeKok and Arran Cudbard-Bell.
 453  */
 454
 455 #define XSTRINGIFY(x) #x
 456
 457 /*
 458  *      Macros for controlling warnings in GCC >= 4.2 and clang >= 2.8
 459  */
 460 #define DIAG_JOINSTR(x,y) XSTRINGIFY(x ## y)
 461 #define DIAG_DO_PRAGMA(x) _Pragma (#x)
 462
 463 /*
 464  * The current clang compilers also define __GNUC__ and __GNUC_MINOR__
 465  * thus we need to test the clang case before the GCC one
 466  */
 467 #if defined(__clang__)
 468 #  if (__clang_major__ * 100) + __clang_minor__ >= 208
 469 #    define DIAG_PRAGMA(x) DIAG_DO_PRAGMA(clang diagnostic x)
 470 #    define DIAG_OFF(x) DIAG_PRAGMA(push) DIAG_PRAGMA(ignored DIAG_JOINSTR(-W,x))
 471 #    define DIAG_ON(x) DIAG_PRAGMA(pop)
 472 #  else
 473 #    define DIAG_OFF(x)
 474 #    define DIAG_ON(x)
 475 #  endif
 476 #elif defined(__GNUC__) && ((__GNUC__ * 100) + __GNUC_MINOR__) >= 402
 477 #  define DIAG_PRAGMA(x) DIAG_DO_PRAGMA(GCC diagnostic x)
 478 #  if ((__GNUC__ * 100) + __GNUC_MINOR__) >= 406
 479 #    define DIAG_OFF(x) DIAG_PRAGMA(push) DIAG_PRAGMA(ignored DIAG_JOINSTR(-W,x))
 480 #    define DIAG_ON(x) DIAG_PRAGMA(pop)
 481 #  else
 482 #    define DIAG_OFF(x) DIAG_PRAGMA(ignored DIAG_JOINSTR(-W,x))
 483 #    define DIAG_ON(x)  DIAG_PRAGMA(warning DIAG_JOINSTR(-W,x))
 484 #  endif
 485 #else
 486 #  define DIAG_OFF(x)
 487 #  define DIAG_ON(x)
 488 #endif
 489
 490 /* Use for clang specific warnings */
 491 #ifdef __clang__
 492 #  define DIAG_OFF_CLANG(x) DIAG_OFF(x)
 493 #  define DIAG_ON_CLANG(x)  DIAG_ON(x)
 494 #else
 495 #  define DIAG_OFF_CLANG(x)
 496 #  define DIAG_ON_CLANG(x)
 497 #endif
 498
 499 /*
 500  *      For dealing with APIs which are only deprecated in OSX (like the OpenSSL API)
 501  */
 502 #ifdef __APPLE__
 503 #  define USES_APPLE_DEPRECATED_API DIAG_OFF(deprecated-declarations)
 504 #  define USES_APPLE_RST DIAG_ON(deprecated-declarations)
 505 #else
 506 #  define USES_APPLE_DEPRECATED_API
 507 #  define USES_APPLE_RST
 508 #endif
 509
 510 /*
 511  * end of Apple deprecation workaround macros
 512  */
 513
 514 /*
 515  * Statement attributes, for various compilers.
 516  *
 517  * This was introduced sufficiently recently that compilers implementing
 518  * it also implement __has_attribute() (for example, GCC 5.0 and later
 519  * have __has_attribute(), and the "fallthrough" attribute was introduced
 520  * in GCC 7).
 521  */
 522 #if __has_attribute(fallthrough)
 523 #  define ND_FALL_THROUGH __attribute__ ((fallthrough))
 524 #else
 525 #  define ND_FALL_THROUGH
 526 #endif /*  __has_attribute(fallthrough) */
 527
 528 #endif /* netdissect_stdinc_h */