diff options
Diffstat (limited to 'gcc/timevar.h')
-rw-r--r-- | gcc/timevar.h | 86 |
1 files changed, 86 insertions, 0 deletions
diff --git a/gcc/timevar.h b/gcc/timevar.h new file mode 100644 index 00000000000..c7fcfa70456 --- /dev/null +++ b/gcc/timevar.h @@ -0,0 +1,86 @@ +/* Timing variables for measuring compiler performance. + Copyright (C) 2000 Free Software Foundation, Inc. + Contributed by Alex Samuel <samuel@codesourcery.com> + + This file is part of GNU CC. + + GNU CC is free software; you can redistribute it and/or modify + it under the terms of the GNU General Public License as published by + the Free Software Foundation; either version 2, or (at your option) + any later version. + + GNU CC is distributed in the hope that it will be useful, + but WITHOUT ANY WARRANTY; without even the implied warranty of + MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the + GNU General Public License for more details. + + You should have received a copy of the GNU General Public License + along with GNU CC; see the file COPYING. If not, write to + the Free Software Foundation, 59 Temple Place - Suite 330, + Boston, MA 02111-1307, USA. */ + +/* Timing variables are used to measure elapsed time in various + portions of the compiler. Each measures elapsed user, system, and + wall-clock time, as appropriate to and supported by the host + system. + + Timing variables are defined using the DEFTIMEVAR macro in + timevar.def. Each has an enumeral identifier, used when referring + to the timing variable in code, and a character string name. + + Timing variables can be used in two ways: + + - On the timing stack, using timevar_push and timevar_pop. + Timing variables may be pushed onto the stack; elapsed time is + attributed to the topmost timing variable on the stack. When + another variable is pushed on, the previous topmost variable is + `paused' until the pushed variable is popped back off. + + - As a standalone timer, using timevar_start and timevar_stop. + All time elapsed between the two calls is attributed to the + variable. +*/ + +/* This structure stores the various varieties of time that can be + measured. Times are stored in microseconds. The time may be an + absolute time or a time difference; in the former case, the time + base is undefined, except that the difference between two times + produces a valid time difference. */ + +struct timevar_time_def +{ + /* User time in this process. */ + long user; + + /* System time (if applicable for this host platform) in this + process. */ + long sys; + + /* Wall clock time. */ + long wall; +}; + +/* An enumeration of timing variable indentifiers. Constructed from + the contents of timevar.def. */ + +#define DEFTIMEVAR(identifier__, name__) \ + identifier__, +typedef enum +{ +#include "timevar.def" + TIMEVAR_LAST +} +timevar_id_t; +#undef DEFTIMEVAR + +extern void init_timevar PARAMS ((void)); +extern void timevar_push PARAMS ((timevar_id_t)); +extern void timevar_pop PARAMS ((timevar_id_t)); +extern void timevar_start PARAMS ((timevar_id_t)); +extern void timevar_stop PARAMS ((timevar_id_t)); +extern void timevar_get PARAMS ((timevar_id_t, struct timevar_time_def *)); +extern void timevar_print PARAMS ((FILE *)); + +/* Provided for backward compatibility. */ +extern long get_run_time PARAMS ((void)); +extern void print_time PARAMS ((const char *, long)); |