bin/zxdb/client/process_observer.h

// Copyright 2018 The Fuchsia Authors. All rights reserved.
// Use of this source code is governed by a BSD-style license that can be
// found in the LICENSE file.

#pragma once

namespace zxdb {

class Err;
class LoadedModuleSymbols;
class Process;
class Thread;

// Note: process creation and destruction events are on the TargetObserver.
class ProcessObserver {
 public:
  // Called immediately after creating a new thread and before destroying it.
  virtual void DidCreateThread(Process* process, Thread* thread) {}
  virtual void WillDestroyThread(Process* process, Thread* thread) {}

  // Notification that a module with symbols is ready to use.
  //
  // Note: There is currently no notification for module loads absent symbol
  // information. If that's necessary, this will need refactoring.
  virtual void DidLoadModuleSymbols(Process* process,
                                    LoadedModuleSymbols* module) {}

  // Notification that the given module with symbols is about to be removed.
  virtual void WillUnloadModuleSymbols(Process* process,
                                       LoadedModuleSymbols* module) {}

  // Called when symbols for a loaded binary could not be loaded.
  virtual void OnSymbolLoadFailure(Process* process, const Err& err) {}
};

}  // namespace zxdb