Tess Strickland
f7699740cc
Adds a Mach-O loader, similar to the existing ELF loader, that
can be used on platforms that do not support loading Mach-O dynamic
libraries via dlopen().
Other changes:
* Renames the --force-load-elf-from-memory command line argument
to --force-load-from-memory.
* Use CPU_TYPE_ANY and CPU_SUBTYPE_ANY for architectures that do
not have specific constants in <mach/machine.h> (e.g., RISCV),
as the snapshot header check after loading also catches architecture
mismatches.
* Emit the unwinding information at the end of the text segment
for Windows Mach-O snapshots as is done for ELF ones.
TEST=vm/dart/unobfuscated_static_symbols_test
vm/dart/use_dwarf_stack_traces_flag_test
Issue: https://github.com/dart-lang/sdk/issues/60307
Change-Id: I34a2a334f47d18d5c4f4a712956e71fd0ac94024
Cq-Include-Trybots: luci.dart.try:vm-aot-linux-debug-x64-try,vm-mac-release-arm64-try,vm-aot-mac-release-arm64-try,vm-aot-mac-release-x64-try,vm-aot-dwarf-linux-product-x64-try,vm-linux-debug-x64-try,vm-mac-debug-arm64-try,vm-fuchsia-release-x64-try,vm-fuchsia-release-arm64-try,vm-linux-debug-ia32-try,vm-aot-linux-debug-simarm_x64-try,vm-aot-linux-debug-simriscv32-try,vm-aot-linux-debug-simriscv64-try,vm-aot-linux-release-simarm_x64-try,vm-gcc-linux-try,vm-ubsan-linux-release-arm64-try,vm-aot-win-release-arm64-try,vm-aot-win-release-x64-try,vm-win-release-x64-try,vm-win-release-arm64-try,vm-aot-win-debug-arm64-try,vm-win-debug-arm64-try
Reviewed-on: https://dart-review.googlesource.com/c/sdk/+/430100
Reviewed-by: Slava Egorov <vegorov@google.com>
Reviewed-by: Ryan Macnak <rmacnak@google.com>
71 lines
2.6 KiB
C
71 lines
2.6 KiB
C
// Copyright (c) 2025, 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_BIN_MACHO_LOADER_H_
|
|
#define RUNTIME_BIN_MACHO_LOADER_H_
|
|
|
|
#include "../include/dart_api.h"
|
|
|
|
typedef struct {
|
|
} Dart_LoadedMachODylib;
|
|
|
|
/// Load an Mach-O dynamic library object from a file.
|
|
///
|
|
/// On success, return a handle to the library which may be used to close it
|
|
/// in Dart_UnloadMachODylib. On error, returns 'nullptr' and sets 'error'. The
|
|
/// error string should not be 'free'-d.
|
|
///
|
|
/// `file_offset` may be non-zero to read an snapshot embedded inside another
|
|
/// type of file.
|
|
///
|
|
/// Look up the Dart snapshot symbols "_kVmSnapshotData",
|
|
/// "_kVmSnapshotInstructions", "_kVmIsolateData" and "_kVmIsolateInstructions"
|
|
/// into the respectively named out-parameters.
|
|
///
|
|
/// Dart_LoadMachODylib_Fd takes ownership of the file descriptor.
|
|
/// Dart_LoadMachODylib_Memory does not take ownership of the memory, but
|
|
/// borrows it for the duration of the call. The memory can be release as soon
|
|
// as Dart_LoadAOTSnapshot_Memory returns.
|
|
#if defined(__Fuchsia__) || defined(__linux__) || defined(__FreeBSD__)
|
|
DART_EXPORT Dart_LoadedMachODylib* Dart_LoadMachODylib_Fd(
|
|
int fd,
|
|
uint64_t file_offset,
|
|
const char** error,
|
|
const uint8_t** vm_snapshot_data,
|
|
const uint8_t** vm_snapshot_instrs,
|
|
const uint8_t** vm_isolate_data,
|
|
const uint8_t** vm_isolate_instrs);
|
|
#endif
|
|
|
|
/// Please see documentation for Dart_LoadMachODylib_Fd.
|
|
DART_EXPORT Dart_LoadedMachODylib* Dart_LoadMachODylib(
|
|
const char* filename,
|
|
uint64_t file_offset,
|
|
const char** error,
|
|
const uint8_t** vm_snapshot_data,
|
|
const uint8_t** vm_snapshot_instrs,
|
|
const uint8_t** vm_isolate_data,
|
|
const uint8_t** vm_isolate_instrs);
|
|
|
|
/// Please see documentation for Dart_LoadMachODylib_Fd.
|
|
DART_EXPORT Dart_LoadedMachODylib* Dart_LoadMachODylib_Memory(
|
|
const uint8_t* snapshot,
|
|
uint64_t snapshot_size,
|
|
const char** error,
|
|
const uint8_t** vm_snapshot_data,
|
|
const uint8_t** vm_snapshot_instrs,
|
|
const uint8_t** vm_isolate_data,
|
|
const uint8_t** vm_isolate_instrs);
|
|
|
|
/// Unloads an MachO dynamic library object loaded through
|
|
/// Dart_LoadMachODylib{_Fd, _Memory}.
|
|
///
|
|
/// Unlike dlclose(), this does not use reference counting.
|
|
/// Dart_LoadMachODylib{_Fd, _Memory} will return load the target library
|
|
/// separately each time it is called, and the results must be unloaded
|
|
/// separately.
|
|
DART_EXPORT void Dart_UnloadMachODylib(Dart_LoadedMachODylib* loaded);
|
|
|
|
#endif // RUNTIME_BIN_MACHO_LOADER_H_
|