1ddb351dbec246cf1fab5ec20d2d5520909041de1Kristian Monsen// Copyright (c) 2011 The Chromium Authors. All rights reserved. 2c7f5f8508d98d5952d42ed7648c2a8f30a4da156Patrick Scott// Use of this source code is governed by a BSD-style license that can be 3c7f5f8508d98d5952d42ed7648c2a8f30a4da156Patrick Scott// found in the LICENSE file. 4c7f5f8508d98d5952d42ed7648c2a8f30a4da156Patrick Scott 5c7f5f8508d98d5952d42ed7648c2a8f30a4da156Patrick Scott//------------------------------------------------------------------------------ 6c7f5f8508d98d5952d42ed7648c2a8f30a4da156Patrick Scott// Tracked is the base class for all tracked objects. During construction, it 7c7f5f8508d98d5952d42ed7648c2a8f30a4da156Patrick Scott// registers the fact that an instance was created, and at destruction time, it 8c7f5f8508d98d5952d42ed7648c2a8f30a4da156Patrick Scott// records that event. The instance may be tagged with a name, which is refered 9c7f5f8508d98d5952d42ed7648c2a8f30a4da156Patrick Scott// to as its Location. The Location is a file and line number, most 10c7f5f8508d98d5952d42ed7648c2a8f30a4da156Patrick Scott// typically indicated where the object was constructed. In some cases, as the 11c7f5f8508d98d5952d42ed7648c2a8f30a4da156Patrick Scott// object's significance is refined (for example, a Task object is augmented to 12c7f5f8508d98d5952d42ed7648c2a8f30a4da156Patrick Scott// do additonal things), its Location may be redefined to that later location. 13c7f5f8508d98d5952d42ed7648c2a8f30a4da156Patrick Scott 14c7f5f8508d98d5952d42ed7648c2a8f30a4da156Patrick Scott// Tracking includes (for each instance) recording the birth thread, death 15c7f5f8508d98d5952d42ed7648c2a8f30a4da156Patrick Scott// thread, and duration of life (from construction to destruction). All this 16c7f5f8508d98d5952d42ed7648c2a8f30a4da156Patrick Scott// data is accumulated and filtered for review at about:objects. 17c7f5f8508d98d5952d42ed7648c2a8f30a4da156Patrick Scott 18c7f5f8508d98d5952d42ed7648c2a8f30a4da156Patrick Scott#ifndef BASE_TRACKED_H_ 19c7f5f8508d98d5952d42ed7648c2a8f30a4da156Patrick Scott#define BASE_TRACKED_H_ 203345a6884c488ff3a535c2c9acdd33d74b37e311Iain Merrick#pragma once 21c7f5f8508d98d5952d42ed7648c2a8f30a4da156Patrick Scott 22c7f5f8508d98d5952d42ed7648c2a8f30a4da156Patrick Scott#include <string> 23c7f5f8508d98d5952d42ed7648c2a8f30a4da156Patrick Scott 24ddb351dbec246cf1fab5ec20d2d5520909041de1Kristian Monsen#include "base/base_api.h" 25c7f5f8508d98d5952d42ed7648c2a8f30a4da156Patrick Scott#include "base/time.h" 26c7f5f8508d98d5952d42ed7648c2a8f30a4da156Patrick Scott 27c7f5f8508d98d5952d42ed7648c2a8f30a4da156Patrick Scott#ifndef NDEBUG 28c7f5f8508d98d5952d42ed7648c2a8f30a4da156Patrick Scott#ifndef TRACK_ALL_TASK_OBJECTS 29c7f5f8508d98d5952d42ed7648c2a8f30a4da156Patrick Scott#define TRACK_ALL_TASK_OBJECTS 30c7f5f8508d98d5952d42ed7648c2a8f30a4da156Patrick Scott#endif // TRACK_ALL_TASK_OBJECTS 31c7f5f8508d98d5952d42ed7648c2a8f30a4da156Patrick Scott#endif // NDEBUG 32c7f5f8508d98d5952d42ed7648c2a8f30a4da156Patrick Scott 33c7f5f8508d98d5952d42ed7648c2a8f30a4da156Patrick Scottnamespace tracked_objects { 34c7f5f8508d98d5952d42ed7648c2a8f30a4da156Patrick Scott 35c7f5f8508d98d5952d42ed7648c2a8f30a4da156Patrick Scott//------------------------------------------------------------------------------ 36c7f5f8508d98d5952d42ed7648c2a8f30a4da156Patrick Scott// Location provides basic info where of an object was constructed, or was 37c7f5f8508d98d5952d42ed7648c2a8f30a4da156Patrick Scott// significantly brought to life. 38c7f5f8508d98d5952d42ed7648c2a8f30a4da156Patrick Scott 39ddb351dbec246cf1fab5ec20d2d5520909041de1Kristian Monsenclass BASE_API Location { 40c7f5f8508d98d5952d42ed7648c2a8f30a4da156Patrick Scott public: 41c7f5f8508d98d5952d42ed7648c2a8f30a4da156Patrick Scott // Constructor should be called with a long-lived char*, such as __FILE__. 42c7f5f8508d98d5952d42ed7648c2a8f30a4da156Patrick Scott // It assumes the provided value will persist as a global constant, and it 43c7f5f8508d98d5952d42ed7648c2a8f30a4da156Patrick Scott // will not make a copy of it. 44c407dc5cd9bdc5668497f21b26b09d988ab439deBen Murdoch Location(const char* function_name, const char* file_name, int line_number); 45c7f5f8508d98d5952d42ed7648c2a8f30a4da156Patrick Scott 46c7f5f8508d98d5952d42ed7648c2a8f30a4da156Patrick Scott // Provide a default constructor for easy of debugging. 47c407dc5cd9bdc5668497f21b26b09d988ab439deBen Murdoch Location(); 48c7f5f8508d98d5952d42ed7648c2a8f30a4da156Patrick Scott 49c7f5f8508d98d5952d42ed7648c2a8f30a4da156Patrick Scott // Comparison operator for insertion into a std::map<> hash tables. 50c7f5f8508d98d5952d42ed7648c2a8f30a4da156Patrick Scott // All we need is *some* (any) hashing distinction. Strings should already 51c7f5f8508d98d5952d42ed7648c2a8f30a4da156Patrick Scott // be unique, so we don't bother with strcmp or such. 52c7f5f8508d98d5952d42ed7648c2a8f30a4da156Patrick Scott // Use line number as the primary key (because it is fast, and usually gets us 53c7f5f8508d98d5952d42ed7648c2a8f30a4da156Patrick Scott // a difference), and then pointers as secondary keys (just to get some 54c7f5f8508d98d5952d42ed7648c2a8f30a4da156Patrick Scott // distinctions). 55c7f5f8508d98d5952d42ed7648c2a8f30a4da156Patrick Scott bool operator < (const Location& other) const { 56c7f5f8508d98d5952d42ed7648c2a8f30a4da156Patrick Scott if (line_number_ != other.line_number_) 57c7f5f8508d98d5952d42ed7648c2a8f30a4da156Patrick Scott return line_number_ < other.line_number_; 58c7f5f8508d98d5952d42ed7648c2a8f30a4da156Patrick Scott if (file_name_ != other.file_name_) 59c7f5f8508d98d5952d42ed7648c2a8f30a4da156Patrick Scott return file_name_ < other.file_name_; 60c7f5f8508d98d5952d42ed7648c2a8f30a4da156Patrick Scott return function_name_ < other.function_name_; 61c7f5f8508d98d5952d42ed7648c2a8f30a4da156Patrick Scott } 62c7f5f8508d98d5952d42ed7648c2a8f30a4da156Patrick Scott 63c7f5f8508d98d5952d42ed7648c2a8f30a4da156Patrick Scott const char* function_name() const { return function_name_; } 64c7f5f8508d98d5952d42ed7648c2a8f30a4da156Patrick Scott const char* file_name() const { return file_name_; } 65c7f5f8508d98d5952d42ed7648c2a8f30a4da156Patrick Scott int line_number() const { return line_number_; } 66c7f5f8508d98d5952d42ed7648c2a8f30a4da156Patrick Scott 67c7f5f8508d98d5952d42ed7648c2a8f30a4da156Patrick Scott void Write(bool display_filename, bool display_function_name, 68c7f5f8508d98d5952d42ed7648c2a8f30a4da156Patrick Scott std::string* output) const; 69c7f5f8508d98d5952d42ed7648c2a8f30a4da156Patrick Scott 70c7f5f8508d98d5952d42ed7648c2a8f30a4da156Patrick Scott // Write function_name_ in HTML with '<' and '>' properly encoded. 71c7f5f8508d98d5952d42ed7648c2a8f30a4da156Patrick Scott void WriteFunctionName(std::string* output) const; 72c7f5f8508d98d5952d42ed7648c2a8f30a4da156Patrick Scott 73c7f5f8508d98d5952d42ed7648c2a8f30a4da156Patrick Scott private: 74c7f5f8508d98d5952d42ed7648c2a8f30a4da156Patrick Scott const char* const function_name_; 75c7f5f8508d98d5952d42ed7648c2a8f30a4da156Patrick Scott const char* const file_name_; 76c7f5f8508d98d5952d42ed7648c2a8f30a4da156Patrick Scott const int line_number_; 77c7f5f8508d98d5952d42ed7648c2a8f30a4da156Patrick Scott}; 78c7f5f8508d98d5952d42ed7648c2a8f30a4da156Patrick Scott 79c7f5f8508d98d5952d42ed7648c2a8f30a4da156Patrick Scott 80c7f5f8508d98d5952d42ed7648c2a8f30a4da156Patrick Scott//------------------------------------------------------------------------------ 81c7f5f8508d98d5952d42ed7648c2a8f30a4da156Patrick Scott// Define a macro to record the current source location. 82c7f5f8508d98d5952d42ed7648c2a8f30a4da156Patrick Scott 83c7f5f8508d98d5952d42ed7648c2a8f30a4da156Patrick Scott#define FROM_HERE tracked_objects::Location(__FUNCTION__, __FILE__, __LINE__) 84c7f5f8508d98d5952d42ed7648c2a8f30a4da156Patrick Scott 85c7f5f8508d98d5952d42ed7648c2a8f30a4da156Patrick Scott 86c7f5f8508d98d5952d42ed7648c2a8f30a4da156Patrick Scott//------------------------------------------------------------------------------ 87c7f5f8508d98d5952d42ed7648c2a8f30a4da156Patrick Scott 88c7f5f8508d98d5952d42ed7648c2a8f30a4da156Patrick Scott 89c7f5f8508d98d5952d42ed7648c2a8f30a4da156Patrick Scottclass Births; 90c7f5f8508d98d5952d42ed7648c2a8f30a4da156Patrick Scott 91ddb351dbec246cf1fab5ec20d2d5520909041de1Kristian Monsenclass BASE_API Tracked { 92c7f5f8508d98d5952d42ed7648c2a8f30a4da156Patrick Scott public: 93c7f5f8508d98d5952d42ed7648c2a8f30a4da156Patrick Scott Tracked(); 94c7f5f8508d98d5952d42ed7648c2a8f30a4da156Patrick Scott virtual ~Tracked(); 95c7f5f8508d98d5952d42ed7648c2a8f30a4da156Patrick Scott 96c7f5f8508d98d5952d42ed7648c2a8f30a4da156Patrick Scott // Used to record the FROM_HERE location of a caller. 97c7f5f8508d98d5952d42ed7648c2a8f30a4da156Patrick Scott void SetBirthPlace(const Location& from_here); 98513209b27ff55e2841eac0e4120199c23acce758Ben Murdoch const Location GetBirthPlace() const; 99c7f5f8508d98d5952d42ed7648c2a8f30a4da156Patrick Scott 100c7f5f8508d98d5952d42ed7648c2a8f30a4da156Patrick Scott // When a task sits around a long time, such as in a timer, or object watcher, 101c7f5f8508d98d5952d42ed7648c2a8f30a4da156Patrick Scott // this method should be called when the task becomes active, and its 102c7f5f8508d98d5952d42ed7648c2a8f30a4da156Patrick Scott // significant lifetime begins (and its waiting to be woken up has passed). 103c7f5f8508d98d5952d42ed7648c2a8f30a4da156Patrick Scott void ResetBirthTime(); 104c7f5f8508d98d5952d42ed7648c2a8f30a4da156Patrick Scott 105c7f5f8508d98d5952d42ed7648c2a8f30a4da156Patrick Scott bool MissingBirthplace() const; 106c7f5f8508d98d5952d42ed7648c2a8f30a4da156Patrick Scott 107c407dc5cd9bdc5668497f21b26b09d988ab439deBen Murdoch#if defined(TRACK_ALL_TASK_OBJECTS) 108c407dc5cd9bdc5668497f21b26b09d988ab439deBen Murdoch base::TimeTicks tracked_birth_time() const { return tracked_birth_time_; } 109c407dc5cd9bdc5668497f21b26b09d988ab439deBen Murdoch#else 110c407dc5cd9bdc5668497f21b26b09d988ab439deBen Murdoch base::TimeTicks tracked_birth_time() const { return base::TimeTicks::Now(); } 111c407dc5cd9bdc5668497f21b26b09d988ab439deBen Murdoch#endif // defined(TRACK_ALL_TASK_OBJECTS) 112c407dc5cd9bdc5668497f21b26b09d988ab439deBen Murdoch 113c7f5f8508d98d5952d42ed7648c2a8f30a4da156Patrick Scott private: 114c407dc5cd9bdc5668497f21b26b09d988ab439deBen Murdoch#if defined(TRACK_ALL_TASK_OBJECTS) 115c7f5f8508d98d5952d42ed7648c2a8f30a4da156Patrick Scott 116c7f5f8508d98d5952d42ed7648c2a8f30a4da156Patrick Scott // Pointer to instance were counts of objects with the same birth location 117c7f5f8508d98d5952d42ed7648c2a8f30a4da156Patrick Scott // (on the same thread) are stored. 118c7f5f8508d98d5952d42ed7648c2a8f30a4da156Patrick Scott Births* tracked_births_; 119c7f5f8508d98d5952d42ed7648c2a8f30a4da156Patrick Scott // The time this object was constructed. If its life consisted of a long 120c7f5f8508d98d5952d42ed7648c2a8f30a4da156Patrick Scott // waiting period, and then it became active, then this value is generally 121c7f5f8508d98d5952d42ed7648c2a8f30a4da156Patrick Scott // reset before the object begins it active life. 122c407dc5cd9bdc5668497f21b26b09d988ab439deBen Murdoch base::TimeTicks tracked_birth_time_; 123c7f5f8508d98d5952d42ed7648c2a8f30a4da156Patrick Scott 124c407dc5cd9bdc5668497f21b26b09d988ab439deBen Murdoch#endif // defined(TRACK_ALL_TASK_OBJECTS) 125c7f5f8508d98d5952d42ed7648c2a8f30a4da156Patrick Scott 126c7f5f8508d98d5952d42ed7648c2a8f30a4da156Patrick Scott DISALLOW_COPY_AND_ASSIGN(Tracked); 127c7f5f8508d98d5952d42ed7648c2a8f30a4da156Patrick Scott}; 128c7f5f8508d98d5952d42ed7648c2a8f30a4da156Patrick Scott 129c7f5f8508d98d5952d42ed7648c2a8f30a4da156Patrick Scott} // namespace tracked_objects 130c7f5f8508d98d5952d42ed7648c2a8f30a4da156Patrick Scott 131c7f5f8508d98d5952d42ed7648c2a8f30a4da156Patrick Scott#endif // BASE_TRACKED_H_ 132