lib/Support/Timer.cpp

   1 //===-- Timer.cpp - Interval Timing Support -------------------------------===//
   2 //
   3 //                     The LLVM Compiler Infrastructure
   4 //
   5 // This file is distributed under the University of Illinois Open Source
   6 // License. See LICENSE.TXT for details.
   7 //
   8 //===----------------------------------------------------------------------===//
   9 //
  10 // Interval Timing implementation.
  11 //
  12 //===----------------------------------------------------------------------===//
  13
  14 #include "llvm/Support/Timer.h"
  15 #include "llvm/Support/CommandLine.h"
  16 #include "llvm/Support/ManagedStatic.h"
  17 #include "llvm/Support/Streams.h"
  18 #include "llvm/System/Process.h"
  19 #include <algorithm>
  20 #include <fstream>
  21 #include <functional>
  22 #include <map>
  23 using namespace llvm;
  24
  25 // GetLibSupportInfoOutputFile - Return a file stream to print our output on.
  26 namespace llvm { extern std::ostream *GetLibSupportInfoOutputFile(); }
  27
  28 // getLibSupportInfoOutputFilename - This ugly hack is brought to you courtesy
  29 // of constructor/destructor ordering being unspecified by C++.  Basically the
  30 // problem is that a Statistic object gets destroyed, which ends up calling
  31 // 'GetLibSupportInfoOutputFile()' (below), which calls this function.
  32 // LibSupportInfoOutputFilename used to be a global variable, but sometimes it
  33 // would get destroyed before the Statistic, causing havoc to ensue.  We "fix"
  34 // this by creating the string the first time it is needed and never destroying
  35 // it.
  36 static ManagedStatic<std::string> LibSupportInfoOutputFilename;
  37 static std::string &getLibSupportInfoOutputFilename() {
  38   return *LibSupportInfoOutputFilename;
  39 }
  40
  41 static ManagedStatic<sys::SmartMutex<true> > TimerLock;
  42
  43 namespace {
  44   static cl::opt<bool>
  45   TrackSpace("track-memory", cl::desc("Enable -time-passes memory "
  46                                       "tracking (this may be slow)"),
  47              cl::Hidden);
  48
  49   static cl::opt<std::string, true>
  50   InfoOutputFilename("info-output-file", cl::value_desc("filename"),
  51                      cl::desc("File to append -stats and -timer output to"),
  52                    cl::Hidden, cl::location(getLibSupportInfoOutputFilename()));
  53 }
  54
  55 static TimerGroup *DefaultTimerGroup = 0;
  56 static TimerGroup *getDefaultTimerGroup() {
  57   TimerGroup* tmp = DefaultTimerGroup;
  58   sys::MemoryFence();
  59   if (!tmp) {
  60     llvm_acquire_global_lock();
  61     tmp = DefaultTimerGroup;
  62     if (!tmp) {
  63       tmp = new TimerGroup("Miscellaneous Ungrouped Timers");
  64       sys::MemoryFence();
  65       DefaultTimerGroup = tmp;
  66     }
  67     llvm_release_global_lock();
  68   }
  69
  70   return tmp;
  71 }
  72
  73 Timer::Timer(const std::string &N)
  74   : Elapsed(0), UserTime(0), SystemTime(0), MemUsed(0), PeakMem(0), Name(N),
  75     Started(false), TG(getDefaultTimerGroup()) {
  76   TG->addTimer();
  77 }
  78
  79 Timer::Timer(const std::string &N, TimerGroup &tg)
  80   : Elapsed(0), UserTime(0), SystemTime(0), MemUsed(0), PeakMem(0), Name(N),
  81     Started(false), TG(&tg) {
  82   TG->addTimer();
  83 }
  84
  85 Timer::Timer(const Timer &T) {
  86   TG = T.TG;
  87   if (TG) TG->addTimer();
  88   operator=(T);
  89 }
  90
  91
  92 // Copy ctor, initialize with no TG member.
  93 Timer::Timer(bool, const Timer &T) {
  94   TG = T.TG;     // Avoid assertion in operator=
  95   operator=(T);  // Copy contents
  96   TG = 0;
  97 }
  98
  99
 100 Timer::~Timer() {
 101   if (TG) {
 102     if (Started) {
 103       Started = false;
 104       TG->addTimerToPrint(*this);
 105     }
 106     TG->removeTimer();
 107   }
 108 }
 109
 110 static inline size_t getMemUsage() {
 111   if (TrackSpace)
 112     return sys::Process::GetMallocUsage();
 113   return 0;
 114 }
 115
 116 struct TimeRecord {
 117   double Elapsed, UserTime, SystemTime;
 118   ssize_t MemUsed;
 119 };
 120
 121 static TimeRecord getTimeRecord(bool Start) {
 122   TimeRecord Result;
 123
 124   sys::TimeValue now(0,0);
 125   sys::TimeValue user(0,0);
 126   sys::TimeValue sys(0,0);
 127
 128   ssize_t MemUsed = 0;
 129   if (Start) {
 130     MemUsed = getMemUsage();
 131     sys::Process::GetTimeUsage(now,user,sys);
 132   } else {
 133     sys::Process::GetTimeUsage(now,user,sys);
 134     MemUsed = getMemUsage();
 135   }
 136
 137   Result.Elapsed  = now.seconds()  + now.microseconds()  / 1000000.0;
 138   Result.UserTime = user.seconds() + user.microseconds() / 1000000.0;
 139   Result.SystemTime  = sys.seconds()  + sys.microseconds()  / 1000000.0;
 140   Result.MemUsed  = MemUsed;
 141
 142   return Result;
 143 }
 144
 145 static ManagedStatic<std::vector<Timer*> > ActiveTimers;
 146
 147 void Timer::startTimer() {
 148   sys::SmartScopedLock<true> L(Lock);
 149   Started = true;
 150   ActiveTimers->push_back(this);
 151   TimeRecord TR = getTimeRecord(true);
 152   Elapsed    -= TR.Elapsed;
 153   UserTime   -= TR.UserTime;
 154   SystemTime -= TR.SystemTime;
 155   MemUsed    -= TR.MemUsed;
 156   PeakMemBase = TR.MemUsed;
 157 }
 158
 159 void Timer::stopTimer() {
 160   sys::SmartScopedLock<true> L(Lock);
 161   TimeRecord TR = getTimeRecord(false);
 162   Elapsed    += TR.Elapsed;
 163   UserTime   += TR.UserTime;
 164   SystemTime += TR.SystemTime;
 165   MemUsed    += TR.MemUsed;
 166
 167   if (ActiveTimers->back() == this) {
 168     ActiveTimers->pop_back();
 169   } else {
 170     std::vector<Timer*>::iterator I =
 171       std::find(ActiveTimers->begin(), ActiveTimers->end(), this);
 172     assert(I != ActiveTimers->end() && "stop but no startTimer?");
 173     ActiveTimers->erase(I);
 174   }
 175 }
 176
 177 void Timer::sum(const Timer &T) {
 178   if (&T < this) {
 179     T.Lock.acquire();
 180     Lock.acquire();
 181   } else {
 182     Lock.acquire();
 183     T.Lock.acquire();
 184   }
 185
 186   Elapsed    += T.Elapsed;
 187   UserTime   += T.UserTime;
 188   SystemTime += T.SystemTime;
 189   MemUsed    += T.MemUsed;
 190   PeakMem    += T.PeakMem;
 191
 192   if (&T < this) {
 193     T.Lock.release();
 194     Lock.release();
 195   } else {
 196     Lock.release();
 197     T.Lock.release();
 198   }
 199 }
 200
 201 /// addPeakMemoryMeasurement - This method should be called whenever memory
 202 /// usage needs to be checked.  It adds a peak memory measurement to the
 203 /// currently active timers, which will be printed when the timer group prints
 204 ///
 205 void Timer::addPeakMemoryMeasurement() {
 206   size_t MemUsed = getMemUsage();
 207
 208   for (std::vector<Timer*>::iterator I = ActiveTimers->begin(),
 209          E = ActiveTimers->end(); I != E; ++I) {
 210     (*I)->Lock.acquire();
 211     (*I)->PeakMem = std::max((*I)->PeakMem, MemUsed-(*I)->PeakMemBase);
 212     (*I)->Lock.release();
 213   }
 214 }
 215
 216 //===----------------------------------------------------------------------===//
 217 //   NamedRegionTimer Implementation
 218 //===----------------------------------------------------------------------===//
 219
 220 namespace {
 221
 222 typedef std::map<std::string, Timer> Name2Timer;
 223 typedef std::map<std::string, std::pair<TimerGroup, Name2Timer> > Name2Pair;
 224
 225 }
 226
 227 static ManagedStatic<Name2Timer> NamedTimers;
 228
 229 static ManagedStatic<Name2Pair> NamedGroupedTimers;
 230
 231 static Timer &getNamedRegionTimer(const std::string &Name) {
 232   sys::SmartScopedLock<true> L(*TimerLock);
 233   Name2Timer::iterator I = NamedTimers->find(Name);
 234   if (I != NamedTimers->end())
 235     return I->second;
 236
 237   return NamedTimers->insert(I, std::make_pair(Name, Timer(Name)))->second;
 238 }
 239
 240 static Timer &getNamedRegionTimer(const std::string &Name,
 241                                   const std::string &GroupName) {
 242   sys::SmartScopedLock<true> L(*TimerLock);
 243
 244   Name2Pair::iterator I = NamedGroupedTimers->find(GroupName);
 245   if (I == NamedGroupedTimers->end()) {
 246     TimerGroup TG(GroupName);
 247     std::pair<TimerGroup, Name2Timer> Pair(TG, Name2Timer());
 248     I = NamedGroupedTimers->insert(I, std::make_pair(GroupName, Pair));
 249   }
 250
 251   Name2Timer::iterator J = I->second.second.find(Name);
 252   if (J == I->second.second.end())
 253     J = I->second.second.insert(J,
 254                                 std::make_pair(Name,
 255                                                Timer(Name,
 256                                                      I->second.first)));
 257
 258   return J->second;
 259 }
 260
 261 NamedRegionTimer::NamedRegionTimer(const std::string &Name)
 262   : TimeRegion(getNamedRegionTimer(Name)) {}
 263
 264 NamedRegionTimer::NamedRegionTimer(const std::string &Name,
 265                                    const std::string &GroupName)
 266   : TimeRegion(getNamedRegionTimer(Name, GroupName)) {}
 267
 268 //===----------------------------------------------------------------------===//
 269 //   TimerGroup Implementation
 270 //===----------------------------------------------------------------------===//
 271
 272 // printAlignedFP - Simulate the printf "%A.Bf" format, where A is the
 273 // TotalWidth size, and B is the AfterDec size.
 274 //
 275 static void printAlignedFP(double Val, unsigned AfterDec, unsigned TotalWidth,
 276                            std::ostream &OS) {
 277   assert(TotalWidth >= AfterDec+1 && "Bad FP Format!");
 278   OS.width(TotalWidth-AfterDec-1);
 279   char OldFill = OS.fill();
 280   OS.fill(' ');
 281   OS << (int)Val;  // Integer part;
 282   OS << ".";
 283   OS.width(AfterDec);
 284   OS.fill('0');
 285   unsigned ResultFieldSize = 1;
 286   while (AfterDec--) ResultFieldSize *= 10;
 287   OS << (int)(Val*ResultFieldSize) % ResultFieldSize;
 288   OS.fill(OldFill);
 289 }
 290
 291 static void printVal(double Val, double Total, std::ostream &OS) {
 292   if (Total < 1e-7)   // Avoid dividing by zero...
 293     OS << "        -----     ";
 294   else {
 295     OS << "  ";
 296     printAlignedFP(Val, 4, 7, OS);
 297     OS << " (";
 298     printAlignedFP(Val*100/Total, 1, 5, OS);
 299     OS << "%)";
 300   }
 301 }
 302
 303 void Timer::print(const Timer &Total, std::ostream &OS) {
 304   if (&Total < this) {
 305     Total.Lock.acquire();
 306     Lock.acquire();
 307   } else {
 308     Lock.acquire();
 309     Total.Lock.acquire();
 310   }
 311
 312   if (Total.UserTime)
 313     printVal(UserTime, Total.UserTime, OS);
 314   if (Total.SystemTime)
 315     printVal(SystemTime, Total.SystemTime, OS);
 316   if (Total.getProcessTime())
 317     printVal(getProcessTime(), Total.getProcessTime(), OS);
 318   printVal(Elapsed, Total.Elapsed, OS);
 319
 320   OS << "  ";
 321
 322   if (Total.MemUsed) {
 323     OS.width(9);
 324     OS << MemUsed << "  ";
 325   }
 326   if (Total.PeakMem) {
 327     if (PeakMem) {
 328       OS.width(9);
 329       OS << PeakMem << "  ";
 330     } else
 331       OS << "           ";
 332   }
 333   OS << Name << "\n";
 334
 335   Started = false;  // Once printed, don't print again
 336
 337   if (&Total < this) {
 338     Total.Lock.release();
 339     Lock.release();
 340   } else {
 341     Lock.release();
 342     Total.Lock.release();
 343   }
 344 }
 345
 346 // GetLibSupportInfoOutputFile - Return a file stream to print our output on...
 347 std::ostream *
 348 llvm::GetLibSupportInfoOutputFile() {
 349   std::string &LibSupportInfoOutputFilename = getLibSupportInfoOutputFilename();
 350   if (LibSupportInfoOutputFilename.empty())
 351     return cerr.stream();
 352   if (LibSupportInfoOutputFilename == "-")
 353     return cout.stream();
 354
 355   std::ostream *Result = new std::ofstream(LibSupportInfoOutputFilename.c_str(),
 356                                            std::ios::app);
 357   if (!Result->good()) {
 358     cerr << "Error opening info-output-file '"
 359          << LibSupportInfoOutputFilename << " for appending!\n";
 360     delete Result;
 361     return cerr.stream();
 362   }
 363   return Result;
 364 }
 365
 366
 367 void TimerGroup::removeTimer() {
 368   sys::SmartScopedLock<true> L(*TimerLock);
 369   if (--NumTimers == 0 && !TimersToPrint.empty()) { // Print timing report...
 370     // Sort the timers in descending order by amount of time taken...
 371     std::sort(TimersToPrint.begin(), TimersToPrint.end(),
 372               std::greater<Timer>());
 373
 374     // Figure out how many spaces to indent TimerGroup name...
 375     unsigned Padding = (80-Name.length())/2;
 376     if (Padding > 80) Padding = 0;         // Don't allow "negative" numbers
 377
 378     std::ostream *OutStream = GetLibSupportInfoOutputFile();
 379
 380     ++NumTimers;
 381     {  // Scope to contain Total timer... don't allow total timer to drop us to
 382        // zero timers...
 383       Timer Total("TOTAL");
 384
 385       for (unsigned i = 0, e = TimersToPrint.size(); i != e; ++i)
 386         Total.sum(TimersToPrint[i]);
 387
 388       // Print out timing header...
 389       *OutStream << "===" << std::string(73, '-') << "===\n"
 390                  << std::string(Padding, ' ') << Name << "\n"
 391                  << "===" << std::string(73, '-')
 392                  << "===\n";
 393
 394       // If this is not an collection of ungrouped times, print the total time.
 395       // Ungrouped timers don't really make sense to add up.  We still print the
 396       // TOTAL line to make the percentages make sense.
 397       if (this != DefaultTimerGroup) {
 398         *OutStream << "  Total Execution Time: ";
 399
 400         printAlignedFP(Total.getProcessTime(), 4, 5, *OutStream);
 401         *OutStream << " seconds (";
 402         printAlignedFP(Total.getWallTime(), 4, 5, *OutStream);
 403         *OutStream << " wall clock)\n";
 404       }
 405       *OutStream << "\n";
 406
 407       if (Total.UserTime)
 408         *OutStream << "   ---User Time---";
 409       if (Total.SystemTime)
 410         *OutStream << "   --System Time--";
 411       if (Total.getProcessTime())
 412         *OutStream << "   --User+System--";
 413       *OutStream << "   ---Wall Time---";
 414       if (Total.getMemUsed())
 415         *OutStream << "  ---Mem---";
 416       if (Total.getPeakMem())
 417         *OutStream << "  -PeakMem-";
 418       *OutStream << "  --- Name ---\n";
 419
 420       // Loop through all of the timing data, printing it out...
 421       for (unsigned i = 0, e = TimersToPrint.size(); i != e; ++i)
 422         TimersToPrint[i].print(Total, *OutStream);
 423
 424       Total.print(Total, *OutStream);
 425       *OutStream << std::endl;  // Flush output
 426     }
 427     --NumTimers;
 428
 429     TimersToPrint.clear();
 430
 431     if (OutStream != cerr.stream() && OutStream != cout.stream())
 432       delete OutStream;   // Close the file...
 433   }
 434 }
 435
 436 void TimerGroup::addTimer() {
 437   sys::SmartScopedLock<true> L(*TimerLock);
 438   ++NumTimers;
 439 }
 440
 441 void TimerGroup::addTimerToPrint(const Timer &T) {
 442   sys::SmartScopedLock<true> L(*TimerLock);
 443   TimersToPrint.push_back(Timer(true, T));
 444 }
 445