dart-sdk/runtime/vm/code_observers.h
Vyacheslav Egorov d7a57a5df4 [vm] Add feature to connect AOT code to code comments via .debug_line
Option --write_code_comments_as_synthetic_source_to=file tells AOT
compiler to create a file which contains code comments for all code
objects written into an ELF snapshot and then emit a DWARF line number
program into .debug_line section which attributes code to code comments
in a way similar to how our own disassembler does it.

This enables tools like objdump to display our code comments as part of
the disassembly.

This CL also tweaks ifdefs in such a way that IL printer and code comments
facilities is now included into PRODUCT gen_snapshot binary.

TEST=manually run product build with --print-flow-graph and --write_code_comments_as_synthetic_source_to

Change-Id: Id6741013d43e1733b4ddeb34891a4d2fc06b9313
Reviewed-on: https://dart-review.googlesource.com/c/sdk/+/181380
Commit-Queue: Vyacheslav Egorov <vegorov@google.com>
Reviewed-by: Tess Strickland <sstrickl@google.com>
Reviewed-by: Alexander Markov <alexmarkov@google.com>
2021-02-02 11:35:00 +00:00

78 lines
2 KiB
C++

// Copyright (c) 2012, the Dart project authors. Please see the AUTHORS file
// for details. All rights reserved. Use of this source code is governed by a
// BSD-style license that can be found in the LICENSE file.
#ifndef RUNTIME_VM_CODE_OBSERVERS_H_
#define RUNTIME_VM_CODE_OBSERVERS_H_
#include "vm/allocation.h"
#include "vm/globals.h"
#include "include/dart_api.h"
#if !defined(PRODUCT)
namespace dart {
class CodeComments;
// Object observing code creation events. Used by external profilers and
// debuggers to map address ranges to function names.
class CodeObserver {
public:
CodeObserver() {}
virtual ~CodeObserver() {}
// Returns true if this observer is active and should be notified
// about newly created code objects.
virtual bool IsActive() const = 0;
// Notify code observer about a newly created code object with the
// given properties.
virtual void Notify(const char* name,
uword base,
uword prologue_offset,
uword size,
bool optimized,
const CodeComments* comments) = 0;
private:
DISALLOW_COPY_AND_ASSIGN(CodeObserver);
};
class Mutex;
class CodeObservers : public AllStatic {
public:
static void Init();
static void RegisterExternal(Dart_CodeObserver observer);
static void Register(CodeObserver* observer);
// Notify all active code observers about a newly created code object.
static void NotifyAll(const char* name,
uword base,
uword prologue_offset,
uword size,
bool optimized,
const CodeComments* comments);
// Returns true if there is at least one active code observer.
static bool AreActive();
static void Cleanup();
static Mutex* mutex() { return mutex_; }
private:
static Mutex* mutex_;
static intptr_t observers_length_;
static CodeObserver** observers_;
};
} // namespace dart
#endif // !defined(PRODUCT)
#endif // RUNTIME_VM_CODE_OBSERVERS_H_