]> git.lyx.org Git - lyx.git/blobdiff - src/support/pmprof.h
DocBook: simplify code to handle abstracts.
[lyx.git] / src / support / pmprof.h
index 7f74fe2646836254f27190f783c14cbd924118fc..fb926708f87af07d78f2dfc24378b916e2b6a623 100644 (file)
@@ -8,17 +8,8 @@
  * Full author contact details are available in file CREDITS.
  */
 
-#ifndef PMPROF_H
-#define PMPROF_H
-
-#ifdef _WIN32
-#include <windows.h>
-#else
-#include <sys/time.h>
-#endif
-#include <iostream>
-
-/** How to use this trivial profiler:
+/**
+ * ==== HOW TO USE THIS TRIVIAL PROFILER:
  *
  * * at the beginning of the interesting block, just add:
  *   PROFILE_THIS_BLOCK(some_identifier)
  *
  * * when the program ends, statistics will be sent to standard error, like:
  *
- *   ##### some_identifier: 6.48475usec, count=25405
+ *   #pmprof# some_identifier: 6.51usec, count=7120, total=46.33msec
+ *
+ * * It is also possible to profile caching schemes. All it takes is an additional
+ *   PROFILE_CACHE_MISS(some_identifier)
+ *   in the place that takes care of cache misses. Then the output at the end will change to
+ *
+ *   #pmprof# some_identifier: 6.51usec, count=7120, total=46.33msec
+ *      hit: 96%, 4.36usec, count=6849, total=29.89msec
+ *     miss: 3%, 60.65usec, count=271, total=16.43msec
+ *
+ * * if DISABLE_PMPROF is defined before including pmprof.h, the
+ *   profiler is replaced by empty macros. This is useful for quickly
+ *   checking the overhead.
+ *
+ * ==== ABOUT PROFILING SCOPE:
  *
  * The code measured by the profiler corresponds to the lifetime of a
  * local variable declared by the PROFILE_THIS_BLOCK macro.
 
  */
 
-#ifdef _WIN32
+#ifndef PMPROF_H
+#define PMPROF_H
 
-/* This function does not really returns the "time of day",
- * but it will suffice to evaluate elapsed times.
- */
-int gettimeofday(struct timeval * tv, struct timezone * /*tz*/)
+#if defined(DISABLE_PMPROF)
+
+// Make pmprof an empty shell
+#define PROFILE_THIS_BLOCK(a)
+#define PROFILE_CACHE_MISS(a)
+
+#else
+
+#include <chrono>
+#include <iomanip>
+#include <iostream>
+
+
+//#if defined(__GNUG__) && defined(_GLIBCXX_DEBUG)
+//#error Profiling is not usable when run-time debugging is in effect
+//#endif
+
+namespace {
+
+void dumpTime(std::chrono::duration<double> value)
 {
-       LARGE_INTEGER frequency, t;
-       QueryPerformanceFrequency(&frequency);
-       QueryPerformanceCounter(&t);
+       double const val = value.count();
+       std::cerr << std::fixed << std::setprecision(2);
+       if (val >= 1.0)
+               std::cerr << val << " s";
+       else if (val >= 0.001)
+               std::cerr << val * 1000 << " ms";
+       else
+               std::cerr << val * 1000000 << " us";
+}
 
-       tv->tv_sec = long(t.QuadPart / frequency.QuadPart);
-       tv->tv_usec = long((1000000.0 * (t.QuadPart % frequency.QuadPart)) / frequency.QuadPart);
-       return 0;
+void dump(std::chrono::duration<double> total, unsigned long long count) {
+       dumpTime(total / count);
+       std::cerr << ", count=" << count
+                         << ", total=";
+       dumpTime(total);
+       std::cerr << std::endl;
 }
 
-#endif // _WIN32
+} // namespace
+
 
 /* Helper class for gathering data. Instantiate this as a static
  * variable, so that its destructor will be executed when the program
  * ends.
  */
 
+
 class PMProfStat {
 public:
-       PMProfStat(char const * name)
-         : name_(name), sec_(0), usec_(0), count_(0) {};
+       PMProfStat(char const * name) : name_(name), count_(0), miss_count_(0) {}
 
        ~PMProfStat() {
-               if (count_>0)
-                 std::cerr << "##### " << name_ << ": "
-                           << 1.0 * (sec_ * 1000000 + usec_)/ count_
-                           << "usec, count=" << count_ << std::endl;
+               if (count_>0) {
+                       if (miss_count_ == 0) {
+                               std::cerr << "#pmprof# " << name_ << ": ";
+                               dump(dur_, count_);
+                       }
+                       else {
+                               std::cerr << "#pmprof# " << name_ << ": ";
+                               dump(dur_ + miss_dur_, count_ + miss_count_);
+                               std::cerr << "   hit: " << 100 * count_ / (count_ + miss_count_) << "%, ";
+                               dump(dur_, count_);
+                               std::cerr << "  miss: " << 100 * miss_count_ / (count_ + miss_count_) << "%, ";
+                               dump(miss_dur_, miss_count_);
+                       }
+               }
        }
 
-       void add(const long long s, const long long u) {
-               sec_ += s;
-               usec_ += u;
-               count_++;
+       void add(std::chrono::duration<double> d, const bool hit) {
+               if (hit) {
+                       dur_ += d;
+                       count_++;
+               } else {
+                       miss_dur_ += d;
+                       miss_count_++;
+               }
        }
 
 private:
        char const * name_;
-       long long sec_, usec_;
-       unsigned long long count_;
+       std::chrono::duration<double> dur_, miss_dur_;
+       unsigned long long count_, miss_count_;
 };
 
 
@@ -151,19 +197,19 @@ private:
  */
 class PMProfInstance {
 public:
-       PMProfInstance(PMProfStat * stat) : stat_(stat)
+       PMProfInstance(PMProfStat * stat) : hit(true), stat_(stat)
        {
-               gettimeofday(&before_, 0);
+               before_ = std::chrono::system_clock::now();
        }
 
        ~PMProfInstance() {
-               gettimeofday(&after_, 0);
-               stat_->add(after_.tv_sec - before_.tv_sec,
-                          after_.tv_usec - before_.tv_usec);
+               stat_->add(std::chrono::system_clock::now() - before_, hit);
        }
 
+       bool hit;
+
 private:
-       timeval before_, after_;
+       std::chrono::system_clock::time_point before_;
        PMProfStat * stat_;
 };
 
@@ -172,5 +218,9 @@ private:
        static PMProfStat PMPS_##a(#a);\
        PMProfInstance PMPI_##a(&PMPS_##a);
 
+#define PROFILE_CACHE_MISS(a) \
+       PMPI_##a.hit = false;
+
+#endif // !defined(DISABLE_PMPROF)
 
 #endif