gcc/system.h

   1 /* Get common system includes and various definitions and declarations based
   2    on autoconf macros.
   3    Copyright (C) 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2007, 2008,
   4    2009, 2010
   5    Free Software Foundation, Inc.
   6
   7 This file is part of GCC.
   8
   9 GCC is free software; you can redistribute it and/or modify it under
  10 the terms of the GNU General Public License as published by the Free
  11 Software Foundation; either version 3, or (at your option) any later
  12 version.
  13
  14 GCC is distributed in the hope that it will be useful, but WITHOUT ANY
  15 WARRANTY; without even the implied warranty of MERCHANTABILITY or
  16 FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License
  17 for more details.
  18
  19 You should have received a copy of the GNU General Public License
  20 along with GCC; see the file COPYING3.  If not see
  21 <http://www.gnu.org/licenses/>.  */
  22
  23
  24 #ifndef GCC_SYSTEM_H
  25 #define GCC_SYSTEM_H
  26
  27 /* We must include stdarg.h before stdio.h.  */
  28 #include <stdarg.h>
  29
  30 #ifndef va_copy
  31 # ifdef __va_copy
  32 #   define va_copy(d,s)  __va_copy((d),(s))
  33 # else
  34 #   define va_copy(d,s)  ((d) = (s))
  35 # endif
  36 #endif
  37
  38 #ifdef HAVE_STDDEF_H
  39 # include <stddef.h>
  40 #endif
  41
  42 #include <stdio.h>
  43
  44 /* Define a generic NULL if one hasn't already been defined.  */
  45 #ifndef NULL
  46 #define NULL 0
  47 #endif
  48
  49 /* Use the unlocked open routines from libiberty.  */
  50 #ifdef fopen /* fopen is a #define on VMS.  */
  51 #undef fopen
  52 #endif
  53 #define fopen(PATH,MODE) fopen_unlocked(PATH,MODE)
  54 #define fdopen(FILDES,MODE) fdopen_unlocked(FILDES,MODE)
  55 #define freopen(PATH,MODE,STREAM) freopen_unlocked(PATH,MODE,STREAM)
  56
  57 /* The compiler is not a multi-threaded application and therefore we
  58    do not have to use the locking functions.  In fact, using the locking
  59    functions can cause the compiler to be significantly slower under
  60    I/O bound conditions (such as -g -O0 on very large source files).
  61
  62    HAVE_DECL_PUTC_UNLOCKED actually indicates whether or not the stdio
  63    code is multi-thread safe by default.  If it is set to 0, then do
  64    not worry about using the _unlocked functions.
  65
  66    fputs_unlocked, fwrite_unlocked, and fprintf_unlocked are
  67    extensions and need to be prototyped by hand (since we do not
  68    define _GNU_SOURCE).  */
  69
  70 #if defined HAVE_DECL_PUTC_UNLOCKED && HAVE_DECL_PUTC_UNLOCKED
  71
  72 # ifdef HAVE_PUTC_UNLOCKED
  73 #  undef putc
  74 #  define putc(C, Stream) putc_unlocked (C, Stream)
  75 # endif
  76 # ifdef HAVE_PUTCHAR_UNLOCKED
  77 #  undef putchar
  78 #  define putchar(C) putchar_unlocked (C)
  79 # endif
  80 # ifdef HAVE_GETC_UNLOCKED
  81 #  undef getc
  82 #  define getc(Stream) getc_unlocked (Stream)
  83 # endif
  84 # ifdef HAVE_GETCHAR_UNLOCKED
  85 #  undef getchar
  86 #  define getchar() getchar_unlocked ()
  87 # endif
  88 # ifdef HAVE_FPUTC_UNLOCKED
  89 #  undef fputc
  90 #  define fputc(C, Stream) fputc_unlocked (C, Stream)
  91 # endif
  92
  93 # ifdef HAVE_CLEARERR_UNLOCKED
  94 #  undef clearerr
  95 #  define clearerr(Stream) clearerr_unlocked (Stream)
  96 #  if defined (HAVE_DECL_CLEARERR_UNLOCKED) && !HAVE_DECL_CLEARERR_UNLOCKED
  97 extern void clearerr_unlocked (FILE *);
  98 #  endif
  99 # endif
 100 # ifdef HAVE_FEOF_UNLOCKED
 101 #  undef feof
 102 #  define feof(Stream) feof_unlocked (Stream)
 103 #  if defined (HAVE_DECL_FEOF_UNLOCKED) && !HAVE_DECL_FEOF_UNLOCKED
 104 extern int feof_unlocked (FILE *);
 105 #  endif
 106 # endif
 107 # ifdef HAVE_FILENO_UNLOCKED
 108 #  undef fileno
 109 #  define fileno(Stream) fileno_unlocked (Stream)
 110 #  if defined (HAVE_DECL_FILENO_UNLOCKED) && !HAVE_DECL_FILENO_UNLOCKED
 111 extern int fileno_unlocked (FILE *);
 112 #  endif
 113 # endif
 114 # ifdef HAVE_FFLUSH_UNLOCKED
 115 #  undef fflush
 116 #  define fflush(Stream) fflush_unlocked (Stream)
 117 #  if defined (HAVE_DECL_FFLUSH_UNLOCKED) && !HAVE_DECL_FFLUSH_UNLOCKED
 118 extern int fflush_unlocked (FILE *);
 119 #  endif
 120 # endif
 121 # ifdef HAVE_FGETC_UNLOCKED
 122 #  undef fgetc
 123 #  define fgetc(Stream) fgetc_unlocked (Stream)
 124 #  if defined (HAVE_DECL_FGETC_UNLOCKED) && !HAVE_DECL_FGETC_UNLOCKED
 125 extern int fgetc_unlocked (FILE *);
 126 #  endif
 127 # endif
 128 # ifdef HAVE_FGETS_UNLOCKED
 129 #  undef fgets
 130 #  define fgets(S, n, Stream) fgets_unlocked (S, n, Stream)
 131 #  if defined (HAVE_DECL_FGETS_UNLOCKED) && !HAVE_DECL_FGETS_UNLOCKED
 132 extern char *fgets_unlocked (char *, int, FILE *);
 133 #  endif
 134 # endif
 135 # ifdef HAVE_FPUTS_UNLOCKED
 136 #  undef fputs
 137 #  define fputs(String, Stream) fputs_unlocked (String, Stream)
 138 #  if defined (HAVE_DECL_FPUTS_UNLOCKED) && !HAVE_DECL_FPUTS_UNLOCKED
 139 extern int fputs_unlocked (const char *, FILE *);
 140 #  endif
 141 # endif
 142 # ifdef HAVE_FERROR_UNLOCKED
 143 #  undef ferror
 144 #  define ferror(Stream) ferror_unlocked (Stream)
 145 #  if defined (HAVE_DECL_FERROR_UNLOCKED) && !HAVE_DECL_FERROR_UNLOCKED
 146 extern int ferror_unlocked (FILE *);
 147 #  endif
 148 # endif
 149 # ifdef HAVE_FREAD_UNLOCKED
 150 #  undef fread
 151 #  define fread(Ptr, Size, N, Stream) fread_unlocked (Ptr, Size, N, Stream)
 152 #  if defined (HAVE_DECL_FREAD_UNLOCKED) && !HAVE_DECL_FREAD_UNLOCKED
 153 extern size_t fread_unlocked (void *, size_t, size_t, FILE *);
 154 #  endif
 155 # endif
 156 # ifdef HAVE_FWRITE_UNLOCKED
 157 #  undef fwrite
 158 #  define fwrite(Ptr, Size, N, Stream) fwrite_unlocked (Ptr, Size, N, Stream)
 159 #  if defined (HAVE_DECL_FWRITE_UNLOCKED) && !HAVE_DECL_FWRITE_UNLOCKED
 160 extern size_t fwrite_unlocked (const void *, size_t, size_t, FILE *);
 161 #  endif
 162 # endif
 163 # ifdef HAVE_FPRINTF_UNLOCKED
 164 #  undef fprintf
 165 /* We can't use a function-like macro here because we don't know if
 166    we have varargs macros.  */
 167 #  define fprintf fprintf_unlocked
 168 #  if defined (HAVE_DECL_FPRINTF_UNLOCKED) && !HAVE_DECL_FPRINTF_UNLOCKED
 169 extern int fprintf_unlocked (FILE *, const char *, ...);
 170 #  endif
 171 # endif
 172
 173 #endif
 174
 175 /* ??? Glibc's fwrite/fread_unlocked macros cause
 176    "warning: signed and unsigned type in conditional expression".  */
 177 #undef fread_unlocked
 178 #undef fwrite_unlocked
 179
 180 /* There are an extraordinary number of issues with <ctype.h>.
 181    The last straw is that it varies with the locale.  Use libiberty's
 182    replacement instead.  */
 183 #include "safe-ctype.h"
 184
 185 #include <sys/types.h>
 186
 187 #include <errno.h>
 188
 189 #if !defined (errno) && defined (HAVE_DECL_ERRNO) && !HAVE_DECL_ERRNO
 190 extern int errno;
 191 #endif
 192
 193 #ifdef __cplusplus
 194 # include <cstring>
 195 #endif
 196
 197 /* Some of glibc's string inlines cause warnings.  Plus we'd rather
 198    rely on (and therefore test) GCC's string builtins.  */
 199 #define __NO_STRING_INLINES
 200
 201 #ifdef STRING_WITH_STRINGS
 202 # include <string.h>
 203 # include <strings.h>
 204 #else
 205 # ifdef HAVE_STRING_H
 206 #  include <string.h>
 207 # else
 208 #  ifdef HAVE_STRINGS_H
 209 #   include <strings.h>
 210 #  endif
 211 # endif
 212 #endif
 213
 214 #ifdef HAVE_STDLIB_H
 215 # include <stdlib.h>
 216 #endif
 217
 218 /* If we don't have an overriding definition, set SUCCESS_EXIT_CODE and
 219    FATAL_EXIT_CODE to EXIT_SUCCESS and EXIT_FAILURE respectively,
 220    or 0 and 1 if those macros are not defined.  */
 221 #ifndef SUCCESS_EXIT_CODE
 222 # ifdef EXIT_SUCCESS
 223 #  define SUCCESS_EXIT_CODE EXIT_SUCCESS
 224 # else
 225 #  define SUCCESS_EXIT_CODE 0
 226 # endif
 227 #endif
 228
 229 #ifndef FATAL_EXIT_CODE
 230 # ifdef EXIT_FAILURE
 231 #  define FATAL_EXIT_CODE EXIT_FAILURE
 232 # else
 233 #  define FATAL_EXIT_CODE 1
 234 # endif
 235 #endif
 236
 237 #define ICE_EXIT_CODE 4
 238
 239 #ifdef HAVE_UNISTD_H
 240 # include <unistd.h>
 241 #endif
 242
 243 #ifdef HAVE_SYS_PARAM_H
 244 # include <sys/param.h>
 245 /* We use this identifier later and it appears in some vendor param.h's.  */
 246 # undef PREFETCH
 247 #endif
 248
 249 #if HAVE_LIMITS_H
 250 # include <limits.h>
 251 #endif
 252
 253 /* Get definitions of HOST_WIDE_INT and HOST_WIDEST_INT.  */
 254 #include "hwint.h"
 255
 256 /* A macro to determine whether a VALUE lies inclusively within a
 257    certain range without evaluating the VALUE more than once.  This
 258    macro won't warn if the VALUE is unsigned and the LOWER bound is
 259    zero, as it would e.g. with "VALUE >= 0 && ...".  Note the LOWER
 260    bound *is* evaluated twice, and LOWER must not be greater than
 261    UPPER.  However the bounds themselves can be either positive or
 262    negative.  */
 263 #define IN_RANGE(VALUE, LOWER, UPPER) \
 264   ((unsigned HOST_WIDE_INT) (VALUE) - (unsigned HOST_WIDE_INT) (LOWER) \
 265    <= (unsigned HOST_WIDE_INT) (UPPER) - (unsigned HOST_WIDE_INT) (LOWER))
 266
 267 /* Infrastructure for defining missing _MAX and _MIN macros.  Note that
 268    macros defined with these cannot be used in #if.  */
 269
 270 /* The extra casts work around common compiler bugs.  */
 271 #define INTTYPE_SIGNED(t) (! ((t) 0 < (t) -1))
 272 /* The outer cast is needed to work around a bug in Cray C 5.0.3.0.
 273    It is necessary at least when t == time_t.  */
 274 #define INTTYPE_MINIMUM(t) ((t) (INTTYPE_SIGNED (t) \
 275                              ? ~ (t) 0 << (sizeof(t) * CHAR_BIT - 1) : (t) 0))
 276 #define INTTYPE_MAXIMUM(t) ((t) (~ (t) 0 - INTTYPE_MINIMUM (t)))
 277
 278 /* Use that infrastructure to provide a few constants.  */
 279 #ifndef UCHAR_MAX
 280 # define UCHAR_MAX INTTYPE_MAXIMUM (unsigned char)
 281 #endif
 282
 283 #ifdef TIME_WITH_SYS_TIME
 284 # include <sys/time.h>
 285 # include <time.h>
 286 #else
 287 # if HAVE_SYS_TIME_H
 288 #  include <sys/time.h>
 289 # else
 290 #  ifdef HAVE_TIME_H
 291 #   include <time.h>
 292 #  endif
 293 # endif
 294 #endif
 295
 296 #ifdef HAVE_FCNTL_H
 297 # include <fcntl.h>
 298 #else
 299 # ifdef HAVE_SYS_FILE_H
 300 #  include <sys/file.h>
 301 # endif
 302 #endif
 303
 304 #ifndef SEEK_SET
 305 # define SEEK_SET 0
 306 # define SEEK_CUR 1
 307 # define SEEK_END 2
 308 #endif
 309 #ifndef F_OK
 310 # define F_OK 0
 311 # define X_OK 1
 312 # define W_OK 2
 313 # define R_OK 4
 314 #endif
 315 #ifndef O_RDONLY
 316 # define O_RDONLY 0
 317 #endif
 318 #ifndef O_WRONLY
 319 # define O_WRONLY 1
 320 #endif
 321 #ifndef O_BINARY
 322 # define O_BINARY 0
 323 #endif
 324
 325 /* Some systems define these in, e.g., param.h.  We undefine these names
 326    here to avoid the warnings.  We prefer to use our definitions since we
 327    know they are correct.  */
 328
 329 #undef MIN
 330 #undef MAX
 331 #define MIN(X,Y) ((X) < (Y) ? (X) : (Y))
 332 #define MAX(X,Y) ((X) > (Y) ? (X) : (Y))
 333
 334 /* Returns the least number N such that N * Y >= X.  */
 335 #define CEIL(x,y) (((x) + (y) - 1) / (y))
 336
 337 #ifdef HAVE_SYS_WAIT_H
 338 #include <sys/wait.h>
 339 #endif
 340
 341 #ifndef WIFSIGNALED
 342 #define WIFSIGNALED(S) (((S) & 0xff) != 0 && ((S) & 0xff) != 0x7f)
 343 #endif
 344 #ifndef WTERMSIG
 345 #define WTERMSIG(S) ((S) & 0x7f)
 346 #endif
 347 #ifndef WIFEXITED
 348 #define WIFEXITED(S) (((S) & 0xff) == 0)
 349 #endif
 350 #ifndef WEXITSTATUS
 351 #define WEXITSTATUS(S) (((S) & 0xff00) >> 8)
 352 #endif
 353 #ifndef WSTOPSIG
 354 #define WSTOPSIG WEXITSTATUS
 355 #endif
 356 #ifndef WCOREDUMP
 357 #define WCOREDUMP(S) ((S) & WCOREFLG)
 358 #endif
 359 #ifndef WCOREFLG
 360 #define WCOREFLG 0200
 361 #endif
 362
 363 #include <signal.h>
 364 #if !defined (SIGCHLD) && defined (SIGCLD)
 365 # define SIGCHLD SIGCLD
 366 #endif
 367
 368 #ifdef HAVE_SYS_MMAN_H
 369 # include <sys/mman.h>
 370 #endif
 371
 372 #ifndef MAP_FAILED
 373 # define MAP_FAILED ((void *)-1)
 374 #endif
 375
 376 #if !defined (MAP_ANONYMOUS) && defined (MAP_ANON)
 377 # define MAP_ANONYMOUS MAP_ANON
 378 #endif
 379
 380 #ifdef HAVE_SYS_RESOURCE_H
 381 # include <sys/resource.h>
 382 #endif
 383
 384 #ifdef HAVE_SYS_TIMES_H
 385 # include <sys/times.h>
 386 #endif
 387
 388 /* The HAVE_DECL_* macros are three-state, undefined, 0 or 1.  If they
 389    are defined to 0 then we must provide the relevant declaration
 390    here.  These checks will be in the undefined state while configure
 391    is running so be careful to test "defined (HAVE_DECL_*)".  */
 392
 393 #if defined (HAVE_DECL_ATOF) && !HAVE_DECL_ATOF
 394 extern double atof (const char *);
 395 #endif
 396
 397 #if defined (HAVE_DECL_ATOL) && !HAVE_DECL_ATOL
 398 extern long atol (const char *);
 399 #endif
 400
 401 #if defined (HAVE_DECL_FREE) && !HAVE_DECL_FREE
 402 extern void free (void *);
 403 #endif
 404
 405 #if defined (HAVE_DECL_GETCWD) && !HAVE_DECL_GETCWD
 406 extern char *getcwd (char *, size_t);
 407 #endif
 408
 409 #if defined (HAVE_DECL_GETENV) && !HAVE_DECL_GETENV
 410 extern char *getenv (const char *);
 411 #endif
 412
 413 #if defined (HAVE_DECL_GETOPT) && !HAVE_DECL_GETOPT
 414 extern int getopt (int, char * const *, const char *);
 415 #endif
 416
 417 #if defined (HAVE_DECL_GETPAGESIZE) && !HAVE_DECL_GETPAGESIZE
 418 extern int getpagesize (void);
 419 #endif
 420
 421 #if defined (HAVE_DECL_GETWD) && !HAVE_DECL_GETWD
 422 extern char *getwd (char *);
 423 #endif
 424
 425 #if defined (HAVE_DECL_SBRK) && !HAVE_DECL_SBRK
 426 extern void *sbrk (int);
 427 #endif
 428
 429 #if defined (HAVE_DECL_STRSTR) && !HAVE_DECL_STRSTR
 430 extern char *strstr (const char *, const char *);
 431 #endif
 432
 433 #ifdef HAVE_MALLOC_H
 434 #include <malloc.h>
 435 #endif
 436
 437 #if defined (HAVE_DECL_MALLOC) && !HAVE_DECL_MALLOC
 438 extern void *malloc (size_t);
 439 #endif
 440
 441 #if defined (HAVE_DECL_CALLOC) && !HAVE_DECL_CALLOC
 442 extern void *calloc (size_t, size_t);
 443 #endif
 444
 445 #if defined (HAVE_DECL_REALLOC) && !HAVE_DECL_REALLOC
 446 extern void *realloc (void *, size_t);
 447 #endif
 448
 449 #ifdef HAVE_STDINT_H
 450 #include <stdint.h>
 451 #endif
 452
 453 #ifdef HAVE_INTTYPES_H
 454 #include <inttypes.h>
 455 #endif
 456
 457 /* If the system doesn't provide strsignal, we get it defined in
 458    libiberty but no declaration is supplied.  */
 459 #if !defined (HAVE_STRSIGNAL) \
 460     || (defined (HAVE_DECL_STRSIGNAL) && !HAVE_DECL_STRSIGNAL)
 461 # ifndef strsignal
 462 extern const char *strsignal (int);
 463 # endif
 464 #endif
 465
 466 #ifdef HAVE_GETRLIMIT
 467 # if defined (HAVE_DECL_GETRLIMIT) && !HAVE_DECL_GETRLIMIT
 468 #  ifndef getrlimit
 469 struct rlimit;
 470 extern int getrlimit (int, struct rlimit *);
 471 #  endif
 472 # endif
 473 #endif
 474
 475 #ifdef HAVE_SETRLIMIT
 476 # if defined (HAVE_DECL_SETRLIMIT) && !HAVE_DECL_SETRLIMIT
 477 #  ifndef setrlimit
 478 struct rlimit;
 479 extern int setrlimit (int, const struct rlimit *);
 480 #  endif
 481 # endif
 482 #endif
 483
 484 #if defined (HAVE_DECL_ABORT) && !HAVE_DECL_ABORT
 485 extern void abort (void);
 486 #endif
 487
 488 #if defined (HAVE_DECL_SNPRINTF) && !HAVE_DECL_SNPRINTF
 489 extern int snprintf (char *, size_t, const char *, ...);
 490 #endif
 491
 492 #if defined (HAVE_DECL_VSNPRINTF) && !HAVE_DECL_VSNPRINTF
 493 extern int vsnprintf(char *, size_t, const char *, va_list);
 494 #endif
 495
 496 /* 1 if we have C99 designated initializers.  */
 497 #if !defined(HAVE_DESIGNATED_INITIALIZERS)
 498 #define HAVE_DESIGNATED_INITIALIZERS \
 499   (((GCC_VERSION >= 2007) || (__STDC_VERSION__ >= 199901L)) \
 500    && !defined(__cplusplus))
 501 #endif
 502
 503 #if HAVE_SYS_STAT_H
 504 # include <sys/stat.h>
 505 #endif
 506
 507 /* Test if something is a normal file.  */
 508 #ifndef S_ISREG
 509 #define S_ISREG(m) (((m) & S_IFMT) == S_IFREG)
 510 #endif
 511
 512 /* Test if something is a directory.  */
 513 #ifndef S_ISDIR
 514 #define S_ISDIR(m) (((m) & S_IFMT) == S_IFDIR)
 515 #endif
 516
 517 /* Test if something is a character special file.  */
 518 #ifndef S_ISCHR
 519 #define S_ISCHR(m) (((m) & S_IFMT) == S_IFCHR)
 520 #endif
 521
 522 /* Test if something is a block special file.  */
 523 #ifndef S_ISBLK
 524 #define S_ISBLK(m) (((m) & S_IFMT) == S_IFBLK)
 525 #endif
 526
 527 /* Test if something is a socket.  */
 528 #ifndef S_ISSOCK
 529 # ifdef S_IFSOCK
 530 #   define S_ISSOCK(m) (((m) & S_IFMT) == S_IFSOCK)
 531 # else
 532 #   define S_ISSOCK(m) 0
 533 # endif
 534 #endif
 535
 536 /* Test if something is a FIFO.  */
 537 #ifndef S_ISFIFO
 538 # ifdef S_IFIFO
 539 #  define S_ISFIFO(m) (((m) & S_IFMT) == S_IFIFO)
 540 # else
 541 #  define S_ISFIFO(m) 0
 542 # endif
 543 #endif
 544
 545 /* Define well known filenos if the system does not define them.  */
 546 #ifndef STDIN_FILENO
 547 # define STDIN_FILENO   0
 548 #endif
 549 #ifndef STDOUT_FILENO
 550 # define STDOUT_FILENO  1
 551 #endif
 552 #ifndef STDERR_FILENO
 553 # define STDERR_FILENO  2
 554 #endif
 555
 556 /* Some systems have mkdir that takes a single argument.  */
 557 #ifdef MKDIR_TAKES_ONE_ARG
 558 # define mkdir(a,b) mkdir(a)
 559 #endif
 560
 561 #ifndef HAVE_KILL
 562 # define kill(p,s) raise(s)
 563 #endif
 564
 565 /* Provide a way to print an address via printf.  */
 566 #ifndef HOST_PTR_PRINTF
 567 #define HOST_PTR_PRINTF "%p"
 568 #endif /* ! HOST_PTR_PRINTF */
 569
 570 /* By default, colon separates directories in a path.  */
 571 #ifndef PATH_SEPARATOR
 572 #define PATH_SEPARATOR ':'
 573 #endif
 574
 575 /* Filename handling macros.  */
 576 #include "filenames.h"
 577
 578 /* These should be phased out in favor of IS_DIR_SEPARATOR, where possible.  */
 579 #ifndef DIR_SEPARATOR
 580 # define DIR_SEPARATOR '/'
 581 # ifdef HAVE_DOS_BASED_FILE_SYSTEM
 582 #  define DIR_SEPARATOR_2 '\\'
 583 # endif
 584 #endif
 585
 586 /* Get libiberty declarations.  */
 587 #include "libiberty.h"
 588
 589 /* Provide a default for the HOST_BIT_BUCKET.
 590    This suffices for POSIX-like hosts.  */
 591
 592 #ifndef HOST_BIT_BUCKET
 593 #define HOST_BIT_BUCKET "/dev/null"
 594 #endif
 595
 596 /* Be conservative and only use enum bitfields with GCC.
 597    FIXME: provide a complete autoconf test for buggy enum bitfields.  */
 598
 599 #if (GCC_VERSION > 2000)
 600 #define ENUM_BITFIELD(TYPE) __extension__ enum TYPE
 601 #else
 602 #define ENUM_BITFIELD(TYPE) unsigned int
 603 #endif
 604
 605 #ifndef offsetof
 606 #define offsetof(TYPE, MEMBER)  ((size_t) &((TYPE *) 0)->MEMBER)
 607 #endif
 608
 609 /* Various error reporting routines want to use __FUNCTION__.  */
 610 #if (GCC_VERSION < 2007)
 611 #ifndef __FUNCTION__
 612 #define __FUNCTION__ "?"
 613 #endif /* ! __FUNCTION__ */
 614 #endif
 615
 616 /* __builtin_expect(A, B) evaluates to A, but notifies the compiler that
 617    the most likely value of A is B.  This feature was added at some point
 618    between 2.95 and 3.0.  Let's use 3.0 as the lower bound for now.  */
 619 #if (GCC_VERSION < 3000)
 620 #define __builtin_expect(a, b) (a)
 621 #endif
 622
 623 /* Redefine abort to report an internal error w/o coredump, and
 624    reporting the location of the error in the source file.  */
 625 extern void fancy_abort (const char *, int, const char *) ATTRIBUTE_NORETURN;
 626 #define abort() fancy_abort (__FILE__, __LINE__, __FUNCTION__)
 627
 628 /* Use gcc_assert(EXPR) to test invariants.  */
 629 #if ENABLE_ASSERT_CHECKING
 630 #define gcc_assert(EXPR)                                                \
 631    ((void)(!(EXPR) ? fancy_abort (__FILE__, __LINE__, __FUNCTION__), 0 : 0))
 632 #elif (GCC_VERSION >= 4005)
 633 #define gcc_assert(EXPR)                                                \
 634   ((void)(__builtin_expect(!(EXPR), 0) ? __builtin_unreachable(), 0 : 0))
 635 #else
 636 /* Include EXPR, so that unused variable warnings do not occur.  */
 637 #define gcc_assert(EXPR) ((void)(0 && (EXPR)))
 638 #endif
 639
 640 #ifdef ENABLE_CHECKING
 641 #define gcc_checking_assert(EXPR) gcc_assert (EXPR)
 642 #else
 643 #define gcc_checking_assert(EXPR) ((void)(0 && (EXPR)))
 644 #endif
 645
 646 /* Use gcc_unreachable() to mark unreachable locations (like an
 647    unreachable default case of a switch.  Do not use gcc_assert(0).  */
 648 #if (GCC_VERSION >= 4005) && !ENABLE_ASSERT_CHECKING
 649 #define gcc_unreachable() __builtin_unreachable()
 650 #else
 651 #define gcc_unreachable() (fancy_abort (__FILE__, __LINE__, __FUNCTION__))
 652 #endif
 653
 654 /* Provide a fake boolean type.  We make no attempt to use the
 655    C99 _Bool, as it may not be available in the bootstrap compiler,
 656    and even if it is, it is liable to be buggy.
 657    This must be after all inclusion of system headers, as some of
 658    them will mess us up.  */
 659
 660 #undef TRUE
 661 #undef FALSE
 662
 663 #ifdef __cplusplus
 664   /* Obsolete.  */
 665 # define TRUE true
 666 # define FALSE false
 667 #else /* !__cplusplus */
 668 # undef bool
 669 # undef true
 670 # undef false
 671
 672 # define bool unsigned char
 673 # define true 1
 674 # define false 0
 675
 676   /* Obsolete.  */
 677 # define TRUE true
 678 # define FALSE false
 679 #endif /* !__cplusplus */
 680
 681 /* Some compilers do not allow the use of unsigned char in bitfields.  */
 682 #define BOOL_BITFIELD unsigned int
 683
 684 /* As the last action in this file, we poison the identifiers that
 685    shouldn't be used.  Note, luckily gcc-3.0's token-based integrated
 686    preprocessor won't trip on poisoned identifiers that arrive from
 687    the expansion of macros.  E.g. #define strrchr rindex, won't error
 688    if rindex is poisoned after this directive is issued and later on
 689    strrchr is called.
 690
 691    Note: We define bypass macros for the few cases where we really
 692    want to use the libc memory allocation routines.  Otherwise we
 693    insist you use the "x" versions from libiberty.  */
 694
 695 #define really_call_malloc malloc
 696 #define really_call_calloc calloc
 697 #define really_call_realloc realloc
 698
 699 #if defined(FLEX_SCANNER) || defined(YYBISON) || defined(YYBYACC)
 700 /* Flex and bison use malloc and realloc.  Yuk.  Note that this means
 701    really_call_* cannot be used in a .l or .y file.  */
 702 #define malloc xmalloc
 703 #define realloc xrealloc
 704 #endif
 705
 706 #if (GCC_VERSION >= 3000)
 707
 708 /* Note autoconf checks for prototype declarations and includes
 709    system.h while doing so.  Only poison these tokens if actually
 710    compiling gcc, so that the autoconf declaration tests for malloc
 711    etc don't spuriously fail.  */
 712 #ifdef IN_GCC
 713 #undef calloc
 714 #undef strdup
 715  #pragma GCC poison calloc strdup
 716
 717 #if !defined(FLEX_SCANNER) && !defined(YYBISON)
 718 #undef malloc
 719 #undef realloc
 720  #pragma GCC poison malloc realloc
 721 #endif
 722
 723 /* The %m format should be used when GCC's main diagnostic functions
 724    supporting %m are available, and xstrerror from libiberty
 725    otherwise.  */
 726 #undef strerror
 727  #pragma GCC poison strerror
 728
 729 /* Old target macros that have moved to the target hooks structure.  */
 730  #pragma GCC poison ASM_OPEN_PAREN ASM_CLOSE_PAREN                      \
 731         FUNCTION_PROLOGUE FUNCTION_EPILOGUE                             \
 732         FUNCTION_END_PROLOGUE FUNCTION_BEGIN_EPILOGUE                   \
 733         DECL_MACHINE_ATTRIBUTES COMP_TYPE_ATTRIBUTES INSERT_ATTRIBUTES  \
 734         VALID_MACHINE_DECL_ATTRIBUTE VALID_MACHINE_TYPE_ATTRIBUTE       \
 735         SET_DEFAULT_TYPE_ATTRIBUTES SET_DEFAULT_DECL_ATTRIBUTES         \
 736         MERGE_MACHINE_TYPE_ATTRIBUTES MERGE_MACHINE_DECL_ATTRIBUTES     \
 737         MD_INIT_BUILTINS MD_EXPAND_BUILTIN ASM_OUTPUT_CONSTRUCTOR       \
 738         ASM_OUTPUT_DESTRUCTOR SIGNED_CHAR_SPEC MAX_CHAR_TYPE_SIZE       \
 739         WCHAR_UNSIGNED UNIQUE_SECTION SELECT_SECTION SELECT_RTX_SECTION \
 740         ENCODE_SECTION_INFO STRIP_NAME_ENCODING ASM_GLOBALIZE_LABEL     \
 741         ASM_OUTPUT_MI_THUNK CONST_COSTS RTX_COSTS DEFAULT_RTX_COSTS     \
 742         ADDRESS_COST MACHINE_DEPENDENT_REORG ASM_FILE_START ASM_FILE_END \
 743         ASM_SIMPLIFY_DWARF_ADDR INIT_TARGET_OPTABS INIT_SUBTARGET_OPTABS \
 744         INIT_GOFAST_OPTABS MULSI3_LIBCALL MULDI3_LIBCALL DIVSI3_LIBCALL \
 745         DIVDI3_LIBCALL UDIVSI3_LIBCALL UDIVDI3_LIBCALL MODSI3_LIBCALL   \
 746         MODDI3_LIBCALL UMODSI3_LIBCALL UMODDI3_LIBCALL BUILD_VA_LIST_TYPE \
 747         PRETEND_OUTGOING_VARARGS_NAMED STRUCT_VALUE_INCOMING_REGNUM     \
 748         ASM_OUTPUT_SECTION_NAME PROMOTE_FUNCTION_ARGS PROMOTE_FUNCTION_MODE \
 749         STRUCT_VALUE_INCOMING STRICT_ARGUMENT_NAMING                    \
 750         PROMOTE_FUNCTION_RETURN PROMOTE_PROTOTYPES STRUCT_VALUE_REGNUM  \
 751         SETUP_INCOMING_VARARGS EXPAND_BUILTIN_SAVEREGS                  \
 752         DEFAULT_SHORT_ENUMS SPLIT_COMPLEX_ARGS MD_ASM_CLOBBERS          \
 753         HANDLE_PRAGMA_REDEFINE_EXTNAME HANDLE_PRAGMA_EXTERN_PREFIX      \
 754         MUST_PASS_IN_STACK FUNCTION_ARG_PASS_BY_REFERENCE               \
 755         VECTOR_MODE_SUPPORTED_P TARGET_SUPPORTS_HIDDEN                  \
 756         FUNCTION_ARG_PARTIAL_NREGS ASM_OUTPUT_DWARF_DTPREL              \
 757         ALLOCATE_INITIAL_VALUE LEGITIMIZE_ADDRESS FRAME_POINTER_REQUIRED \
 758         CAN_ELIMINATE TRAMPOLINE_TEMPLATE INITIALIZE_TRAMPOLINE         \
 759         TRAMPOLINE_ADJUST_ADDRESS STATIC_CHAIN STATIC_CHAIN_INCOMING    \
 760         RETURN_POPS_ARGS UNITS_PER_SIMD_WORD OVERRIDE_OPTIONS           \
 761         OPTIMIZATION_OPTIONS CLASS_LIKELY_SPILLED_P                     \
 762         USING_SJLJ_EXCEPTIONS TARGET_UNWIND_INFO                        \
 763         LABEL_ALIGN_MAX_SKIP LOOP_ALIGN_MAX_SKIP                        \
 764         LABEL_ALIGN_AFTER_BARRIER_MAX_SKIP JUMP_ALIGN_MAX_SKIP          \
 765         CAN_DEBUG_WITHOUT_FP UNLIKELY_EXECUTED_TEXT_SECTION_NAME        \
 766         HOT_TEXT_SECTION_NAME
 767
 768 /* Other obsolete target macros, or macros that used to be in target
 769    headers and were not used, and may be obsolete or may never have
 770    been used.  */
 771  #pragma GCC poison INT_ASM_OP ASM_OUTPUT_EH_REGION_BEG CPP_PREDEFINES     \
 772         ASM_OUTPUT_EH_REGION_END ASM_OUTPUT_LABELREF_AS_INT SMALL_STACK    \
 773         DOESNT_NEED_UNWINDER EH_TABLE_LOOKUP OBJC_SELECTORS_WITHOUT_LABELS \
 774         OMIT_EH_TABLE EASY_DIV_EXPR IMPLICIT_FIX_EXPR                      \
 775         LONGJMP_RESTORE_FROM_STACK MAX_INT_TYPE_SIZE ASM_IDENTIFY_GCC      \
 776         STDC_VALUE TRAMPOLINE_ALIGN ASM_IDENTIFY_GCC_AFTER_SOURCE          \
 777         SLOW_ZERO_EXTEND SUBREG_REGNO_OFFSET DWARF_LINE_MIN_INSTR_LENGTH   \
 778         TRADITIONAL_RETURN_FLOAT NO_BUILTIN_SIZE_TYPE                      \
 779         NO_BUILTIN_PTRDIFF_TYPE NO_BUILTIN_WCHAR_TYPE NO_BUILTIN_WINT_TYPE \
 780         BLOCK_PROFILER BLOCK_PROFILER_CODE FUNCTION_BLOCK_PROFILER         \
 781         FUNCTION_BLOCK_PROFILER_EXIT MACHINE_STATE_SAVE                    \
 782         MACHINE_STATE_RESTORE SCCS_DIRECTIVE SECTION_ASM_OP BYTEORDER      \
 783         ASM_OUTPUT_DEFINE_LABEL_DIFFERENCE_SYMBOL HOST_WORDS_BIG_ENDIAN    \
 784         OBJC_PROLOGUE ALLOCATE_TRAMPOLINE HANDLE_PRAGMA ROUND_TYPE_SIZE    \
 785         ROUND_TYPE_SIZE_UNIT CONST_SECTION_ASM_OP CRT_GET_RFIB_TEXT        \
 786         DBX_LBRAC_FIRST DBX_OUTPUT_ENUM DBX_OUTPUT_SOURCE_FILENAME         \
 787         DBX_WORKING_DIRECTORY INSN_CACHE_DEPTH INSN_CACHE_SIZE             \
 788         INSN_CACHE_LINE_WIDTH INIT_SECTION_PREAMBLE NEED_ATEXIT ON_EXIT    \
 789         EXIT_BODY OBJECT_FORMAT_ROSE MULTIBYTE_CHARS MAP_CHARACTER         \
 790         LIBGCC_NEEDS_DOUBLE FINAL_PRESCAN_LABEL DEFAULT_CALLER_SAVES       \
 791         LOAD_ARGS_REVERSED MAX_INTEGER_COMPUTATION_MODE                    \
 792         CONVERT_HARD_REGISTER_TO_SSA_P ASM_OUTPUT_MAIN_SOURCE_FILENAME     \
 793         FIRST_INSN_ADDRESS TEXT_SECTION SHARED_BSS_SECTION_ASM_OP          \
 794         PROMOTED_MODE EXPAND_BUILTIN_VA_END                                \
 795         LINKER_DOES_NOT_WORK_WITH_DWARF2 FUNCTION_ARG_KEEP_AS_REFERENCE    \
 796         GIV_SORT_CRITERION MAX_LONG_TYPE_SIZE MAX_LONG_DOUBLE_TYPE_SIZE    \
 797         MAX_WCHAR_TYPE_SIZE SHARED_SECTION_ASM_OP INTEGRATE_THRESHOLD      \
 798         FINAL_REG_PARM_STACK_SPACE MAYBE_REG_PARM_STACK_SPACE              \
 799         TRADITIONAL_PIPELINE_INTERFACE DFA_PIPELINE_INTERFACE              \
 800         DBX_OUTPUT_STANDARD_TYPES BUILTIN_SETJMP_FRAME_VALUE               \
 801         SUNOS4_SHARED_LIBRARIES PROMOTE_FOR_CALL_ONLY                      \
 802         SPACE_AFTER_L_OPTION NO_RECURSIVE_FUNCTION_CSE                     \
 803         DEFAULT_MAIN_RETURN TARGET_MEM_FUNCTIONS EXPAND_BUILTIN_VA_ARG     \
 804         COLLECT_PARSE_FLAG DWARF2_GENERATE_TEXT_SECTION_LABEL WINNING_GDB  \
 805         ASM_OUTPUT_FILENAME ASM_OUTPUT_SOURCE_LINE FILE_NAME_JOINER        \
 806         GDB_INV_REF_REGPARM_STABS_LETTER DBX_MEMPARM_STABS_LETTER          \
 807         PUT_SDB_SRC_FILE STABS_GCC_MARKER DBX_OUTPUT_FUNCTION_END          \
 808         DBX_OUTPUT_GCC_MARKER DBX_FINISH_SYMBOL SDB_GENERATE_FAKE          \
 809         NON_SAVING_SETJMP TARGET_LATE_RTL_PROLOGUE_EPILOGUE                \
 810         CASE_DROPS_THROUGH TARGET_BELL TARGET_BS TARGET_CR TARGET_DIGIT0   \
 811         TARGET_ESC TARGET_FF TARGET_NEWLINE TARGET_TAB TARGET_VT           \
 812         LINK_LIBGCC_SPECIAL DONT_ACCESS_GBLS_AFTER_EPILOGUE                \
 813         TARGET_OPTIONS TARGET_SWITCHES EXTRA_CC_MODES FINALIZE_PIC         \
 814         PREDICATE_CODES SPECIAL_MODE_PREDICATES UNALIGNED_WORD_ASM_OP      \
 815         EXTRA_SECTIONS EXTRA_SECTION_FUNCTIONS READONLY_DATA_SECTION       \
 816         TARGET_ASM_EXCEPTION_SECTION TARGET_ASM_EH_FRAME_SECTION           \
 817         SMALL_ARG_MAX ASM_OUTPUT_SHARED_BSS ASM_OUTPUT_SHARED_COMMON       \
 818         ASM_OUTPUT_SHARED_LOCAL ASM_MAKE_LABEL_LINKONCE                    \
 819         STACK_CHECK_PROBE_INTERVAL STACK_CHECK_PROBE_LOAD                  \
 820         ORDER_REGS_FOR_LOCAL_ALLOC FUNCTION_OUTGOING_VALUE                 \
 821         ASM_DECLARE_CONSTANT_NAME MODIFY_TARGET_NAME SWITCHES_NEED_SPACES  \
 822         SWITCH_CURTAILS_COMPILATION SWITCH_TAKES_ARG WORD_SWITCH_TAKES_ARG \
 823         TARGET_OPTION_TRANSLATE_TABLE HANDLE_PRAGMA_PACK_PUSH_POP          \
 824         HANDLE_SYSV_PRAGMA HANDLE_PRAGMA_WEAK CONDITIONAL_REGISTER_USAGE   \
 825         FUNCTION_ARG_BOUNDARY MUST_USE_SJLJ_EXCEPTIONS US_SOFTWARE_GOFAST
 826
 827 /* Hooks that are no longer used.  */
 828  #pragma GCC poison LANG_HOOKS_FUNCTION_MARK LANG_HOOKS_FUNCTION_FREE   \
 829         LANG_HOOKS_MARK_TREE LANG_HOOKS_INSERT_DEFAULT_ATTRIBUTES \
 830         LANG_HOOKS_TREE_INLINING_ESTIMATE_NUM_INSNS \
 831         LANG_HOOKS_PUSHLEVEL LANG_HOOKS_SET_BLOCK \
 832         LANG_HOOKS_MAYBE_BUILD_CLEANUP LANG_HOOKS_UPDATE_DECL_AFTER_SAVING \
 833         LANG_HOOKS_POPLEVEL LANG_HOOKS_TRUTHVALUE_CONVERSION \
 834         TARGET_PROMOTE_FUNCTION_ARGS TARGET_PROMOTE_FUNCTION_RETURN \
 835         LANG_HOOKS_MISSING_ARGUMENT LANG_HOOKS_HASH_TYPES \
 836         TARGET_HANDLE_OFAST TARGET_OPTION_OPTIMIZATION
 837
 838 /* Hooks into libgcc2.  */
 839  #pragma GCC poison LIBGCC2_DOUBLE_TYPE_SIZE LIBGCC2_WORDS_BIG_ENDIAN \
 840    LIBGCC2_FLOAT_WORDS_BIG_ENDIAN
 841
 842 /* Miscellaneous macros that are no longer used.  */
 843  #pragma GCC poison USE_MAPPED_LOCATION GET_ENVIRONMENT
 844
 845 /* Libiberty macros that are no longer used in GCC.  */
 846 #undef ANSI_PROTOTYPES
 847 #undef PTR_CONST
 848 #undef LONG_DOUBLE
 849 #undef VPARAMS
 850 #undef VA_OPEN
 851 #undef VA_FIXEDARG
 852 #undef VA_CLOSE
 853 #undef VA_START
 854  #pragma GCC poison ANSI_PROTOTYPES PTR_CONST LONG_DOUBLE VPARAMS VA_OPEN \
 855   VA_FIXEDARG VA_CLOSE VA_START
 856 #endif /* IN_GCC */
 857
 858 /* Front ends should never have to include middle-end headers.  Enforce
 859    this by poisoning the header double-include protection defines.  */
 860 #ifdef IN_GCC_FRONTEND
 861 #pragma GCC poison GCC_RTL_H GCC_EXCEPT_H GCC_EXPR_H
 862 #endif
 863
 864 /* Note: not all uses of the `index' token (e.g. variable names and
 865    structure members) have been eliminated.  */
 866 #undef bcopy
 867 #undef bzero
 868 #undef bcmp
 869 #undef rindex
 870  #pragma GCC poison bcopy bzero bcmp rindex
 871
 872 #endif /* GCC >= 3.0 */
 873
 874 /* This macro allows casting away const-ness to pass -Wcast-qual
 875    warnings.  DO NOT USE THIS UNLESS YOU REALLY HAVE TO!  It should
 876    only be used in certain specific cases.  One valid case is where
 877    the C standard definitions or prototypes force you to.  E.g. if you
 878    need to free a const object, or if you pass a const string to
 879    execv, et al.  Another valid use would be in an allocation function
 880    that creates const objects that need to be initialized.  In some
 881    cases we have non-const functions that return the argument
 882    (e.g. next_nonnote_insn).  Rather than create const shadow
 883    functions, we can cast away const-ness in calling these interfaces
 884    if we're careful to verify that the called function does indeed not
 885    modify its argument and the return value is only used in a const
 886    context.  (This can be somewhat dangerous as these assumptions can
 887    change after the fact).  Beyond these uses, most other cases of
 888    using this macro should be viewed with extreme caution.  */
 889
 890 #ifdef __cplusplus
 891 #define CONST_CAST2(TOTYPE,FROMTYPE,X) (const_cast<TOTYPE> (X))
 892 #else
 893 #if defined(__GNUC__) && GCC_VERSION > 4000
 894 /* GCC 4.0.x has a bug where it may ICE on this expression,
 895    so does GCC 3.4.x (PR17436).  */
 896 #define CONST_CAST2(TOTYPE,FROMTYPE,X) ((__extension__(union {FROMTYPE _q; TOTYPE _nq;})(X))._nq)
 897 #elif defined(__GNUC__)
 898 static inline char *
 899 helper_const_non_const_cast (const char *p)
 900 {
 901   union {
 902     const char *const_c;
 903     char *c;
 904   } val;
 905   val.const_c = p;
 906   return val.c;
 907 }
 908
 909 #define CONST_CAST2(TOTYPE,FROMTYPE,X) \
 910         ((TOTYPE) helper_const_non_const_cast ((const char *) (FROMTYPE) (X)))
 911 #else
 912 #define CONST_CAST2(TOTYPE,FROMTYPE,X) ((TOTYPE)(FROMTYPE)(X))
 913 #endif
 914 #endif
 915 #define CONST_CAST(TYPE,X) CONST_CAST2(TYPE, const TYPE, (X))
 916 #define CONST_CAST_TREE(X) CONST_CAST(union tree_node *, (X))
 917 #define CONST_CAST_RTX(X) CONST_CAST(struct rtx_def *, (X))
 918 #define CONST_CAST_BB(X) CONST_CAST(struct basic_block_def *, (X))
 919 #define CONST_CAST_GIMPLE(X) CONST_CAST(union gimple_statement_d *, (X))
 920
 921 /* Activate certain diagnostics as warnings (not errors via the
 922    -Werror flag).  */
 923 #if GCC_VERSION >= 4003
 924 /* If asserts are disabled, activate -Wuninitialized as a warning (not
 925    an error/-Werror).  */
 926 #ifndef ENABLE_ASSERT_CHECKING
 927 #pragma GCC diagnostic warning "-Wuninitialized"
 928 #endif
 929 #endif
 930
 931 #ifdef ENABLE_VALGRIND_CHECKING
 932 # ifdef HAVE_VALGRIND_MEMCHECK_H
 933 #  include <valgrind/memcheck.h>
 934 # elif defined HAVE_MEMCHECK_H
 935 #  include <memcheck.h>
 936 # else
 937 #  include <valgrind.h>
 938 # endif
 939 /* Compatibility macros to let valgrind 3.1 work.  */
 940 # ifndef VALGRIND_MAKE_MEM_NOACCESS
 941 #  define VALGRIND_MAKE_MEM_NOACCESS VALGRIND_MAKE_NOACCESS
 942 # endif
 943 # ifndef VALGRIND_MAKE_MEM_DEFINED
 944 #  define VALGRIND_MAKE_MEM_DEFINED VALGRIND_MAKE_READABLE
 945 # endif
 946 # ifndef VALGRIND_MAKE_MEM_UNDEFINED
 947 #  define VALGRIND_MAKE_MEM_UNDEFINED VALGRIND_MAKE_WRITABLE
 948 # endif
 949 #else
 950 /* Avoid #ifdef:s when we can help it.  */
 951 #define VALGRIND_DISCARD(x)
 952 #define VALGRIND_MALLOCLIKE_BLOCK(w,x,y,z)
 953 #define VALGRIND_FREELIKE_BLOCK(x,y)
 954 #endif
 955
 956 /* In LTO -fwhole-program build we still want to keep the debug functions available
 957    for debugger.  Mark them as used to prevent removal.  */
 958 #if (GCC_VERSION > 4000)
 959 #define DEBUG_FUNCTION __attribute__ ((__used__))
 960 #define DEBUG_VARIABLE __attribute__ ((__used__))
 961 #else
 962 #define DEBUG_FUNCTION
 963 #define DEBUG_VARIABLE
 964 #endif
 965
 966 #endif /* ! GCC_SYSTEM_H */