forked from mirrors/gecko-dev
		
	# ignore-this-changeset Depends on D28954 Differential Revision: https://phabricator.services.mozilla.com/D28956 --HG-- extra : moz-landing-system : lando
		
			
				
	
	
		
			76 lines
		
	
	
	
		
			2.2 KiB
		
	
	
	
		
			C++
		
	
	
	
	
	
			
		
		
	
	
			76 lines
		
	
	
	
		
			2.2 KiB
		
	
	
	
		
			C++
		
	
	
	
	
	
/* -*- Mode: C++; tab-width: 2; indent-tabs-mode: nil; c-basic-offset: 2; -*- */
 | 
						|
/* This Source Code Form is subject to the terms of the Mozilla Public
 | 
						|
 * License, v. 2.0. If a copy of the MPL was not distributed with this
 | 
						|
 * file, You can obtain one at http://mozilla.org/MPL/2.0/. */
 | 
						|
 | 
						|
#ifndef ProcessedStack_h__
 | 
						|
#define ProcessedStack_h__
 | 
						|
 | 
						|
#include <string>
 | 
						|
#include <vector>
 | 
						|
#include "nsString.h"
 | 
						|
#if defined(MOZ_GECKO_PROFILER)
 | 
						|
#  include "shared-libraries.h"
 | 
						|
#endif  // MOZ_GECKO_PROFILER
 | 
						|
 | 
						|
namespace mozilla {
 | 
						|
namespace Telemetry {
 | 
						|
 | 
						|
// This class represents a stack trace and the modules referenced in that trace.
 | 
						|
// It is designed to be easy to read and write to disk or network and doesn't
 | 
						|
// include any logic on how to collect or read the information it stores.
 | 
						|
class ProcessedStack {
 | 
						|
 public:
 | 
						|
  ProcessedStack();
 | 
						|
  size_t GetStackSize() const;
 | 
						|
  size_t GetNumModules() const;
 | 
						|
 | 
						|
  struct Frame {
 | 
						|
    // The offset of this program counter in its module or an absolute pc.
 | 
						|
    uintptr_t mOffset;
 | 
						|
    // The index to pass to GetModule to get the module this program counter
 | 
						|
    // was in.
 | 
						|
    uint16_t mModIndex;
 | 
						|
  };
 | 
						|
  struct Module {
 | 
						|
    // The file name, /foo/bar/libxul.so for example.
 | 
						|
    // It can contain unicode characters.
 | 
						|
    nsString mName;
 | 
						|
    nsCString mBreakpadId;
 | 
						|
 | 
						|
    bool operator==(const Module& other) const;
 | 
						|
  };
 | 
						|
 | 
						|
  const Frame& GetFrame(unsigned aIndex) const;
 | 
						|
  void AddFrame(const Frame& aFrame);
 | 
						|
  const Module& GetModule(unsigned aIndex) const;
 | 
						|
  void AddModule(const Module& aFrame);
 | 
						|
 | 
						|
  void Clear();
 | 
						|
 | 
						|
 private:
 | 
						|
  std::vector<Module> mModules;
 | 
						|
  std::vector<Frame> mStack;
 | 
						|
};
 | 
						|
 | 
						|
// Get the current list of loaded modules, filter and pair it to the provided
 | 
						|
// stack. We let the caller collect the stack since different callers have
 | 
						|
// different needs (current thread X main thread, stopping the thread, etc).
 | 
						|
ProcessedStack GetStackAndModules(const std::vector<uintptr_t>& aPCs);
 | 
						|
 | 
						|
// This class optimizes repeated calls to GetStackAndModules.
 | 
						|
class BatchProcessedStackGenerator {
 | 
						|
 public:
 | 
						|
  BatchProcessedStackGenerator();
 | 
						|
  ProcessedStack GetStackAndModules(const std::vector<uintptr_t>& aPCs);
 | 
						|
 | 
						|
 private:
 | 
						|
#if defined(MOZ_GECKO_PROFILER)
 | 
						|
  SharedLibraryInfo mSortedRawModules;
 | 
						|
#endif
 | 
						|
};
 | 
						|
 | 
						|
}  // namespace Telemetry
 | 
						|
}  // namespace mozilla
 | 
						|
 | 
						|
#endif  // ProcessedStack_h__
 |