dart::Image Class Reference

#include <image_snapshot.h>

Inheritance diagram for dart::Image:

Public Member Functions
	Image (const void *raw_memory)
	Image (const uword raw_memory)
void *	object_start () const
uword	object_size () const
bool	contains (uword address) const
uword *	bss () const
uword	instructions_relocated_address () const
const uint8_t *	build_id () const
intptr_t	build_id_length () const
bool	compiled_to_elf () const

Friends
class	AssemblyImageWriter
class	BitsContainer
class	BlobImageWriter
class	ImageWriter

Detailed Description

Definition at line 39 of file image_snapshot.h.

Constructor & Destructor Documentation

Image() [1/2]

dart::Image::Image ( const void *  raw_memory )

inlineexplicit

Definition at line 41 of file image_snapshot.h.

      : Image(reinterpret_cast<uword>(raw_memory)) {}

Image() [2/2]

dart::Image::Image ( const uword  raw_memory )

inlineexplicit

Definition at line 43 of file image_snapshot.h.

      : raw_memory_(raw_memory),
        snapshot_size_(FieldValue(raw_memory, HeaderField::ImageSize)),
        extra_info_(ExtraInfo(raw_memory_, snapshot_size_)) {
    ASSERT(Utils::IsAligned(raw_memory, kObjectStartAlignment));
  }

Member Function Documentation

bss()

uword * dart::Image::bss

(

)

const

Definition at line 68 of file image_snapshot.cc.

                        {
#if defined(DART_PRECOMPILED_RUNTIME)
  ASSERT(extra_info_ != nullptr);
  // There should always be a non-zero BSS offset.
  ASSERT(extra_info_->bss_offset_ != 0);
  // Returning a non-const uword* is safe because we're translating from
  // the start of the instructions (read-only) to the start of the BSS
  // (read-write).
  return reinterpret_cast<uword*>(raw_memory_ + extra_info_->bss_offset_);
#else
  return nullptr;
#endif
}

build_id()

const uint8_t * dart::Image::build_id

(

)

const

Definition at line 91 of file image_snapshot.cc.

                                     {
#if defined(DART_PRECOMPILED_RUNTIME)
  ASSERT(extra_info_ != nullptr);
  if (extra_info_->build_id_offset_ != kNoBuildId) {
    auto const note = reinterpret_cast<elf::Note*>(
        raw_memory_ + extra_info_->build_id_offset_);
    return note->data + note->name_size;
  }
#endif
  return nullptr;
}

build_id_length()

intptr_t dart::Image::build_id_length

(

)

const

Definition at line 103 of file image_snapshot.cc.

                                      {
#if defined(DART_PRECOMPILED_RUNTIME)
  ASSERT(extra_info_ != nullptr);
  if (extra_info_->build_id_offset_ != kNoBuildId) {
    auto const note = reinterpret_cast<elf::Note*>(
        raw_memory_ + extra_info_->build_id_offset_);
    return note->description_size;
  }
#endif
  return 0;
}

compiled_to_elf()

bool dart::Image::compiled_to_elf

(

)

const

Definition at line 115 of file image_snapshot.cc.

                                  {
#if defined(DART_PRECOMPILED_RUNTIME)
  ASSERT(extra_info_ != nullptr);
  // Since assembly snapshots can't set up this field correctly (instead,
  // it's initialized in BSS at snapshot load time), we use it to detect
  // direct-to-ELF snapshots.
  return extra_info_->instructions_relocated_address_ != kNoRelocatedAddress;
#else
  return false;
#endif
}

contains()

bool dart::Image::contains ( uword  address ) const

inline

Definition at line 59 of file image_snapshot.h.

                                     {
    uword start = reinterpret_cast<uword>(object_start());
    return address >= start && (address - start < object_size());
  }

instructions_relocated_address()

uword dart::Image::instructions_relocated_address

(

)

const

Definition at line 82 of file image_snapshot.cc.

                                                  {
#if defined(DART_PRECOMPILED_RUNTIME)
  ASSERT(extra_info_ != nullptr);
  return extra_info_->instructions_relocated_address_;
#else
  return kNoRelocatedAddress;
#endif
}

object_size()

uword dart::Image::object_size ( ) const

inline

Definition at line 57 of file image_snapshot.h.

{ return snapshot_size_ - kHeaderSize; }

object_start()

void * dart::Image::object_start ( ) const

inline

Definition at line 53 of file image_snapshot.h.

                             {
    return reinterpret_cast<void*>(raw_memory_ + kHeaderSize);
  }

Friends And Related Symbol Documentation

AssemblyImageWriter

friend class AssemblyImageWriter

friend

Definition at line 144 of file image_snapshot.h.

BitsContainer

friend class BitsContainer

friend

Definition at line 145 of file image_snapshot.h.

BlobImageWriter

friend class BlobImageWriter

friend

Definition at line 146 of file image_snapshot.h.

ImageWriter

friend class ImageWriter

friend

Definition at line 147 of file image_snapshot.h.

---

The documentation for this class was generated from the following files:

• third_party/dart-lang/sdk/runtime/vm/image_snapshot.h
• third_party/dart-lang/sdk/runtime/vm/image_snapshot.cc