• Home
  • Line#
  • Scopes#
  • Navigate#
  • Raw
  • Download
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/ADT/Statistic.h"
16 #include "llvm/ADT/StringMap.h"
17 #include "llvm/Support/CommandLine.h"
18 #include "llvm/Support/FileSystem.h"
19 #include "llvm/Support/Format.h"
20 #include "llvm/Support/ManagedStatic.h"
21 #include "llvm/Support/Mutex.h"
22 #include "llvm/Support/Process.h"
23 #include "llvm/Support/raw_ostream.h"
24 using namespace llvm;
25 
26 // getLibSupportInfoOutputFilename - This ugly hack is brought to you courtesy
27 // of constructor/destructor ordering being unspecified by C++.  Basically the
28 // problem is that a Statistic object gets destroyed, which ends up calling
29 // 'GetLibSupportInfoOutputFile()' (below), which calls this function.
30 // LibSupportInfoOutputFilename used to be a global variable, but sometimes it
31 // would get destroyed before the Statistic, causing havoc to ensue.  We "fix"
32 // this by creating the string the first time it is needed and never destroying
33 // it.
34 static ManagedStatic<std::string> LibSupportInfoOutputFilename;
getLibSupportInfoOutputFilename()35 static std::string &getLibSupportInfoOutputFilename() {
36   return *LibSupportInfoOutputFilename;
37 }
38 
39 static ManagedStatic<sys::SmartMutex<true> > TimerLock;
40 
41 namespace {
42   static cl::opt<bool>
43   TrackSpace("track-memory", cl::desc("Enable -time-passes memory "
44                                       "tracking (this may be slow)"),
45              cl::Hidden);
46 
47   static cl::opt<std::string, true>
48   InfoOutputFilename("info-output-file", cl::value_desc("filename"),
49                      cl::desc("File to append -stats and -timer output to"),
50                    cl::Hidden, cl::location(getLibSupportInfoOutputFilename()));
51 }
52 
53 // Return a file stream to print our output on.
CreateInfoOutputFile()54 std::unique_ptr<raw_fd_ostream> llvm::CreateInfoOutputFile() {
55   const std::string &OutputFilename = getLibSupportInfoOutputFilename();
56   if (OutputFilename.empty())
57     return llvm::make_unique<raw_fd_ostream>(2, false); // stderr.
58   if (OutputFilename == "-")
59     return llvm::make_unique<raw_fd_ostream>(1, false); // stdout.
60 
61   // Append mode is used because the info output file is opened and closed
62   // each time -stats or -time-passes wants to print output to it. To
63   // compensate for this, the test-suite Makefiles have code to delete the
64   // info output file before running commands which write to it.
65   std::error_code EC;
66   auto Result = llvm::make_unique<raw_fd_ostream>(
67       OutputFilename, EC, sys::fs::F_Append | sys::fs::F_Text);
68   if (!EC)
69     return Result;
70 
71   errs() << "Error opening info-output-file '"
72     << OutputFilename << " for appending!\n";
73   return llvm::make_unique<raw_fd_ostream>(2, false); // stderr.
74 }
75 
76 
77 static TimerGroup *DefaultTimerGroup = nullptr;
getDefaultTimerGroup()78 static TimerGroup *getDefaultTimerGroup() {
79   TimerGroup *tmp = DefaultTimerGroup;
80   sys::MemoryFence();
81   if (tmp) return tmp;
82 
83   sys::SmartScopedLock<true> Lock(*TimerLock);
84   tmp = DefaultTimerGroup;
85   if (!tmp) {
86     tmp = new TimerGroup("Miscellaneous Ungrouped Timers");
87     sys::MemoryFence();
88     DefaultTimerGroup = tmp;
89   }
90 
91   return tmp;
92 }
93 
94 //===----------------------------------------------------------------------===//
95 // Timer Implementation
96 //===----------------------------------------------------------------------===//
97 
init(StringRef N)98 void Timer::init(StringRef N) {
99   init(N, *getDefaultTimerGroup());
100 }
101 
init(StringRef N,TimerGroup & tg)102 void Timer::init(StringRef N, TimerGroup &tg) {
103   assert(!TG && "Timer already initialized");
104   Name.assign(N.begin(), N.end());
105   Started = false;
106   TG = &tg;
107   TG->addTimer(*this);
108 }
109 
~Timer()110 Timer::~Timer() {
111   if (!TG) return;  // Never initialized, or already cleared.
112   TG->removeTimer(*this);
113 }
114 
getMemUsage()115 static inline size_t getMemUsage() {
116   if (!TrackSpace) return 0;
117   return sys::Process::GetMallocUsage();
118 }
119 
getCurrentTime(bool Start)120 TimeRecord TimeRecord::getCurrentTime(bool Start) {
121   TimeRecord Result;
122   sys::TimeValue now(0,0), user(0,0), sys(0,0);
123 
124   if (Start) {
125     Result.MemUsed = getMemUsage();
126     sys::Process::GetTimeUsage(now, user, sys);
127   } else {
128     sys::Process::GetTimeUsage(now, user, sys);
129     Result.MemUsed = getMemUsage();
130   }
131 
132   Result.WallTime   =  now.seconds() +  now.microseconds() / 1000000.0;
133   Result.UserTime   = user.seconds() + user.microseconds() / 1000000.0;
134   Result.SystemTime =  sys.seconds() +  sys.microseconds() / 1000000.0;
135   return Result;
136 }
137 
138 static ManagedStatic<std::vector<Timer*> > ActiveTimers;
139 
startTimer()140 void Timer::startTimer() {
141   Started = true;
142   ActiveTimers->push_back(this);
143   Time -= TimeRecord::getCurrentTime(true);
144 }
145 
stopTimer()146 void Timer::stopTimer() {
147   Time += TimeRecord::getCurrentTime(false);
148 
149   if (ActiveTimers->back() == this) {
150     ActiveTimers->pop_back();
151   } else {
152     std::vector<Timer*>::iterator I =
153       std::find(ActiveTimers->begin(), ActiveTimers->end(), this);
154     assert(I != ActiveTimers->end() && "stop but no startTimer?");
155     ActiveTimers->erase(I);
156   }
157 }
158 
printVal(double Val,double Total,raw_ostream & OS)159 static void printVal(double Val, double Total, raw_ostream &OS) {
160   if (Total < 1e-7)   // Avoid dividing by zero.
161     OS << "        -----     ";
162   else
163     OS << format("  %7.4f (%5.1f%%)", Val, Val*100/Total);
164 }
165 
print(const TimeRecord & Total,raw_ostream & OS) const166 void TimeRecord::print(const TimeRecord &Total, raw_ostream &OS) const {
167   if (Total.getUserTime())
168     printVal(getUserTime(), Total.getUserTime(), OS);
169   if (Total.getSystemTime())
170     printVal(getSystemTime(), Total.getSystemTime(), OS);
171   if (Total.getProcessTime())
172     printVal(getProcessTime(), Total.getProcessTime(), OS);
173   printVal(getWallTime(), Total.getWallTime(), OS);
174 
175   OS << "  ";
176 
177   if (Total.getMemUsed())
178     OS << format("%9" PRId64 "  ", (int64_t)getMemUsed());
179 }
180 
181 
182 //===----------------------------------------------------------------------===//
183 //   NamedRegionTimer Implementation
184 //===----------------------------------------------------------------------===//
185 
186 namespace {
187 
188 typedef StringMap<Timer> Name2TimerMap;
189 
190 class Name2PairMap {
191   StringMap<std::pair<TimerGroup*, Name2TimerMap> > Map;
192 public:
~Name2PairMap()193   ~Name2PairMap() {
194     for (StringMap<std::pair<TimerGroup*, Name2TimerMap> >::iterator
195          I = Map.begin(), E = Map.end(); I != E; ++I)
196       delete I->second.first;
197   }
198 
get(StringRef Name,StringRef GroupName)199   Timer &get(StringRef Name, StringRef GroupName) {
200     sys::SmartScopedLock<true> L(*TimerLock);
201 
202     std::pair<TimerGroup*, Name2TimerMap> &GroupEntry = Map[GroupName];
203 
204     if (!GroupEntry.first)
205       GroupEntry.first = new TimerGroup(GroupName);
206 
207     Timer &T = GroupEntry.second[Name];
208     if (!T.isInitialized())
209       T.init(Name, *GroupEntry.first);
210     return T;
211   }
212 };
213 
214 }
215 
216 static ManagedStatic<Name2TimerMap> NamedTimers;
217 static ManagedStatic<Name2PairMap> NamedGroupedTimers;
218 
getNamedRegionTimer(StringRef Name)219 static Timer &getNamedRegionTimer(StringRef Name) {
220   sys::SmartScopedLock<true> L(*TimerLock);
221 
222   Timer &T = (*NamedTimers)[Name];
223   if (!T.isInitialized())
224     T.init(Name);
225   return T;
226 }
227 
NamedRegionTimer(StringRef Name,bool Enabled)228 NamedRegionTimer::NamedRegionTimer(StringRef Name,
229                                    bool Enabled)
230   : TimeRegion(!Enabled ? nullptr : &getNamedRegionTimer(Name)) {}
231 
NamedRegionTimer(StringRef Name,StringRef GroupName,bool Enabled)232 NamedRegionTimer::NamedRegionTimer(StringRef Name, StringRef GroupName,
233                                    bool Enabled)
234   : TimeRegion(!Enabled ? nullptr : &NamedGroupedTimers->get(Name, GroupName)){}
235 
236 //===----------------------------------------------------------------------===//
237 //   TimerGroup Implementation
238 //===----------------------------------------------------------------------===//
239 
240 /// TimerGroupList - This is the global list of TimerGroups, maintained by the
241 /// TimerGroup ctor/dtor and is protected by the TimerLock lock.
242 static TimerGroup *TimerGroupList = nullptr;
243 
TimerGroup(StringRef name)244 TimerGroup::TimerGroup(StringRef name)
245   : Name(name.begin(), name.end()), FirstTimer(nullptr) {
246 
247   // Add the group to TimerGroupList.
248   sys::SmartScopedLock<true> L(*TimerLock);
249   if (TimerGroupList)
250     TimerGroupList->Prev = &Next;
251   Next = TimerGroupList;
252   Prev = &TimerGroupList;
253   TimerGroupList = this;
254 }
255 
~TimerGroup()256 TimerGroup::~TimerGroup() {
257   // If the timer group is destroyed before the timers it owns, accumulate and
258   // print the timing data.
259   while (FirstTimer)
260     removeTimer(*FirstTimer);
261 
262   // Remove the group from the TimerGroupList.
263   sys::SmartScopedLock<true> L(*TimerLock);
264   *Prev = Next;
265   if (Next)
266     Next->Prev = Prev;
267 }
268 
269 
removeTimer(Timer & T)270 void TimerGroup::removeTimer(Timer &T) {
271   sys::SmartScopedLock<true> L(*TimerLock);
272 
273   // If the timer was started, move its data to TimersToPrint.
274   if (T.Started)
275     TimersToPrint.emplace_back(T.Time, T.Name);
276 
277   T.TG = nullptr;
278 
279   // Unlink the timer from our list.
280   *T.Prev = T.Next;
281   if (T.Next)
282     T.Next->Prev = T.Prev;
283 
284   // Print the report when all timers in this group are destroyed if some of
285   // them were started.
286   if (FirstTimer || TimersToPrint.empty())
287     return;
288 
289   std::unique_ptr<raw_ostream> OutStream = CreateInfoOutputFile();
290   PrintQueuedTimers(*OutStream);
291 }
292 
addTimer(Timer & T)293 void TimerGroup::addTimer(Timer &T) {
294   sys::SmartScopedLock<true> L(*TimerLock);
295 
296   // Add the timer to our list.
297   if (FirstTimer)
298     FirstTimer->Prev = &T.Next;
299   T.Next = FirstTimer;
300   T.Prev = &FirstTimer;
301   FirstTimer = &T;
302 }
303 
PrintQueuedTimers(raw_ostream & OS)304 void TimerGroup::PrintQueuedTimers(raw_ostream &OS) {
305   // Sort the timers in descending order by amount of time taken.
306   std::sort(TimersToPrint.begin(), TimersToPrint.end());
307 
308   TimeRecord Total;
309   for (auto &RecordNamePair : TimersToPrint)
310     Total += RecordNamePair.first;
311 
312   // Print out timing header.
313   OS << "===" << std::string(73, '-') << "===\n";
314   // Figure out how many spaces to indent TimerGroup name.
315   unsigned Padding = (80-Name.length())/2;
316   if (Padding > 80) Padding = 0;         // Don't allow "negative" numbers
317   OS.indent(Padding) << Name << '\n';
318   OS << "===" << std::string(73, '-') << "===\n";
319 
320   // If this is not an collection of ungrouped times, print the total time.
321   // Ungrouped timers don't really make sense to add up.  We still print the
322   // TOTAL line to make the percentages make sense.
323   if (this != DefaultTimerGroup)
324     OS << format("  Total Execution Time: %5.4f seconds (%5.4f wall clock)\n",
325                  Total.getProcessTime(), Total.getWallTime());
326   OS << '\n';
327 
328   if (Total.getUserTime())
329     OS << "   ---User Time---";
330   if (Total.getSystemTime())
331     OS << "   --System Time--";
332   if (Total.getProcessTime())
333     OS << "   --User+System--";
334   OS << "   ---Wall Time---";
335   if (Total.getMemUsed())
336     OS << "  ---Mem---";
337   OS << "  --- Name ---\n";
338 
339   // Loop through all of the timing data, printing it out.
340   for (unsigned i = 0, e = TimersToPrint.size(); i != e; ++i) {
341     const std::pair<TimeRecord, std::string> &Entry = TimersToPrint[e-i-1];
342     Entry.first.print(Total, OS);
343     OS << Entry.second << '\n';
344   }
345 
346   Total.print(Total, OS);
347   OS << "Total\n\n";
348   OS.flush();
349 
350   TimersToPrint.clear();
351 }
352 
353 /// print - Print any started timers in this group and zero them.
print(raw_ostream & OS)354 void TimerGroup::print(raw_ostream &OS) {
355   sys::SmartScopedLock<true> L(*TimerLock);
356 
357   // See if any of our timers were started, if so add them to TimersToPrint and
358   // reset them.
359   for (Timer *T = FirstTimer; T; T = T->Next) {
360     if (!T->Started) continue;
361     TimersToPrint.emplace_back(T->Time, T->Name);
362 
363     // Clear out the time.
364     T->Started = 0;
365     T->Time = TimeRecord();
366   }
367 
368   // If any timers were started, print the group.
369   if (!TimersToPrint.empty())
370     PrintQueuedTimers(OS);
371 }
372 
373 /// printAll - This static method prints all timers and clears them all out.
printAll(raw_ostream & OS)374 void TimerGroup::printAll(raw_ostream &OS) {
375   sys::SmartScopedLock<true> L(*TimerLock);
376 
377   for (TimerGroup *TG = TimerGroupList; TG; TG = TG->Next)
378     TG->print(OS);
379 }
380