mirror of
https://github.com/dart-lang/sdk
synced 2024-09-06 00:59:09 +00:00
![Vyacheslav Egorov](/assets/img/avatar_default.png)
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>
36 lines
1 KiB
C++
36 lines
1 KiB
C++
// Copyright (c) 2019, 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_COMMENTS_H_
|
|
#define RUNTIME_VM_CODE_COMMENTS_H_
|
|
|
|
#include "vm/globals.h" // For INCLUDE_IL_PRINTER
|
|
#if defined(INCLUDE_IL_PRINTER)
|
|
|
|
namespace dart {
|
|
|
|
// An abstract representation of comments associated with the given code
|
|
// object. We assume that comments are sorted by PCOffset.
|
|
class CodeComments {
|
|
public:
|
|
CodeComments() = default;
|
|
virtual ~CodeComments() = default;
|
|
|
|
virtual intptr_t Length() const = 0;
|
|
virtual intptr_t PCOffsetAt(intptr_t index) const = 0;
|
|
virtual const char* CommentAt(intptr_t index) const = 0;
|
|
};
|
|
|
|
#if !defined(DART_PRECOMPILED_RUNTIME)
|
|
namespace compiler {
|
|
class Assembler;
|
|
}
|
|
const CodeComments& CreateCommentsFrom(compiler::Assembler* assembler);
|
|
#endif
|
|
|
|
} // namespace dart
|
|
|
|
#endif // defined(INCLUDE_IL_PRINTER)
|
|
#endif // RUNTIME_VM_CODE_COMMENTS_H_
|