gcc/timevar.h

   1 /* Timing variables for measuring compiler performance.
   2    Copyright (C) 2000, 2003, 2004 Free Software Foundation, Inc.
   3    Contributed by Alex Samuel <samuel@codesourcery.com>
   4
   5    This file is part of GCC.
   6
   7    GCC is free software; you can redistribute it and/or modify it
   8    under the terms of the GNU General Public License as published by
   9    the Free Software Foundation; either version 2, or (at your option)
  10    any later version.
  11
  12    GCC is distributed in the hope that it will be useful, but WITHOUT
  13    ANY WARRANTY; without even the implied warranty of MERCHANTABILITY
  14    or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public
  15    License for more details.
  16
  17    You should have received a copy of the GNU General Public License
  18    along with GCC; see the file COPYING.  If not, write to the Free
  19    Software Foundation, 59 Temple Place - Suite 330, Boston, MA
  20    02111-1307, USA.  */
  21
  22 #ifndef GCC_TIMEVAR_H
  23 #define GCC_TIMEVAR_H
  24
  25 /* Timing variables are used to measure elapsed time in various
  26    portions of the compiler.  Each measures elapsed user, system, and
  27    wall-clock time, as appropriate to and supported by the host
  28    system.
  29
  30    Timing variables are defined using the DEFTIMEVAR macro in
  31    timevar.def.  Each has an enumeral identifier, used when referring
  32    to the timing variable in code, and a character string name.
  33
  34    Timing variables can be used in two ways:
  35
  36      - On the timing stack, using timevar_push and timevar_pop.
  37        Timing variables may be pushed onto the stack; elapsed time is
  38        attributed to the topmost timing variable on the stack.  When
  39        another variable is pushed on, the previous topmost variable is
  40        `paused' until the pushed variable is popped back off.
  41
  42      - As a standalone timer, using timevar_start and timevar_stop.
  43        All time elapsed between the two calls is attributed to the
  44        variable.
  45 */
  46
  47 /* This structure stores the various varieties of time that can be
  48    measured.  Times are stored in seconds.  The time may be an
  49    absolute time or a time difference; in the former case, the time
  50    base is undefined, except that the difference between two times
  51    produces a valid time difference.  */
  52
  53 struct timevar_time_def
  54 {
  55   /* User time in this process.  */
  56   double user;
  57
  58   /* System time (if applicable for this host platform) in this
  59      process.  */
  60   double sys;
  61
  62   /* Wall clock time.  */
  63   double wall;
  64 };
  65
  66 /* An enumeration of timing variable identifiers.  Constructed from
  67    the contents of timevar.def.  */
  68
  69 #define DEFTIMEVAR(identifier__, name__) \
  70     identifier__,
  71 typedef enum
  72 {
  73 #include "timevar.def"
  74   TIMEVAR_LAST
  75 }
  76 timevar_id_t;
  77 #undef DEFTIMEVAR
  78
  79 /* Execute the sequence: timevar_pop (TV), return (E);  */
  80 #define POP_TIMEVAR_AND_RETURN(TV, E)  do { timevar_pop (TV); return (E); }while(0)
  81 #define timevar_pop(TV) do { if (timevar_enable) timevar_pop_1 (TV); }while(0)
  82 #define timevar_push(TV) do { if (timevar_enable) timevar_push_1 (TV); }while(0)
  83
  84 extern void timevar_init (void);
  85 extern void timevar_push_1 (timevar_id_t);
  86 extern void timevar_pop_1 (timevar_id_t);
  87 extern void timevar_start (timevar_id_t);
  88 extern void timevar_stop (timevar_id_t);
  89 extern void timevar_print (FILE *);
  90
  91 /* Provided for backward compatibility.  */
  92 extern void print_time (const char *, long);
  93
  94 extern bool timevar_enable;
  95
  96 #endif /* ! GCC_TIMEVAR_H */