Files
reverse-engineering-anything/src/composition/binaryDiagnostics.ts
T
Matt Van Hornandgensokyo-dev 637e4cb60c feat(native): inspect DWARF compile units offline
Add bounded offline DWARF compilation-unit inspection with source provenance, explicit coverage, caller-selected controls and shared ELF compression framing.

Assisted-by: Suika (gensokyo-skills:suika-scatter-gather-planning)
Co-authored-by: gensokyo-dev <342580529+gensokyo-dev@users.noreply.github.com>
2026-11-17 10:04:46 +00:00

125 lines
7.8 KiB
TypeScript

import { HOST_PLATFORM, type HostPlatform } from "../platform/HostPlatform.js";
import { PeLoadConfigService } from "../application/binaryDiagnostics/PeLoadConfigService.js";
import { PeLoadConfigProvider } from "../native/pe/PeLoadConfigProvider.js";
import { BinaryHardeningService } from "../application/binaryDiagnostics/BinaryHardeningService.js";
import { BinaryHardeningProvider } from "../native/hardening/BinaryHardeningProvider.js";
import { ByteEntropyService } from "../application/binaryDiagnostics/ByteEntropyService.js";
import { RecordedCrashService } from "../application/binaryDiagnostics/RecordedCrashService.js";
import { PwntoolsRecordedCrashProvider } from "../native/pwntools/PwntoolsRecordedCrashProvider.js";
import { BinaryLayoutService } from "../application/binaryDiagnostics/BinaryLayoutService.js";
import { PwntoolsLayoutProvider } from "../native/pwntools/PwntoolsLayoutProvider.js";
import { PeResourcesService } from "../application/binaryDiagnostics/PeResourcesService.js";
import { PeResourcesProvider } from "../native/pe/PeResourcesProvider.js";
import { PeCertificatesService } from "../application/binaryDiagnostics/PeCertificatesService.js";
import { PeCertificatesProvider } from "../native/pe/PeCertificatesProvider.js";
import { PeImportsService } from "../application/binaryDiagnostics/PeImportsService.js";
import { PeImportsProvider } from "../native/pe/PeImportsProvider.js";
import { WindowsShortcutService } from "../application/binaryDiagnostics/WindowsShortcutService.js";
import { WindowsShortcutProvider } from "../native/windows/WindowsShortcutProvider.js";
import { ElfNotesService } from "../application/binaryDiagnostics/ElfNotesService.js";
import { ElfNotesProvider } from "../native/elf/ElfNotesProvider.js";
import { DwarfUnitsService } from "../application/binaryDiagnostics/DwarfUnitsService.js";
import { DwarfUnitsProvider } from "../native/dwarf/DwarfUnitsProvider.js";
import { ElfDebugLinkService } from "../application/binaryDiagnostics/ElfDebugLinkService.js";
import { ElfDebugLinkProvider } from "../native/elf/ElfDebugLinkProvider.js";
import { NativeInitializersService } from "../application/binaryDiagnostics/NativeInitializersService.js";
import { NativeInitializersProvider } from "../native/initializers/NativeInitializersProvider.js";
import { ElfUnwindRangesService } from "../application/binaryDiagnostics/ElfUnwindRangesService.js";
import { ElfUnwindRangesProvider } from "../native/elf/ElfUnwindRangesProvider.js";
import { AppleIpsService } from "../application/binaryDiagnostics/AppleIpsService.js";
import { AppleIpsProvider } from "../native/apple/AppleIpsProvider.js";
import { KernelModuleService } from "../application/binaryDiagnostics/KernelModuleService.js";
import { KernelModuleProvider } from "../native/elf/KernelModuleProvider.js";
import { ElfDependenciesService } from "../application/binaryDiagnostics/ElfDependenciesService.js";
import { ElfDependenciesProvider } from "../native/elf/ElfDependenciesProvider.js";
import { KernelBuildConfigService } from "../application/binaryDiagnostics/KernelBuildConfigService.js";
import { KernelBuildConfigProvider } from "../native/elf/KernelBuildConfigProvider.js";
import type { ArtifactResourceScope } from "../resources/index.js";
import { NativeExportsService } from "../application/binaryDiagnostics/NativeExportsService.js";
import { NativeExportsProvider } from "../native/exports/NativeExportsProvider.js";
import { DevicetreeService } from "../application/binaryDiagnostics/DevicetreeService.js";
import { DevicetreeProvider } from "../firmware/devicetree/DevicetreeProvider.js";
export const createDevicetreeService = (): DevicetreeService =>
new DevicetreeService(new DevicetreeProvider());
/** Portable PE inspection with no engine, installation or target acquisition. */
export const createPeResourcesService = (): PeResourcesService =>
new PeResourcesService(new PeResourcesProvider());
/** Portable Authenticode table inspection with no engine or catalog verification. */
export const createPeCertificatesService = (): PeCertificatesService =>
new PeCertificatesService(new PeCertificatesProvider());
/** Portable PE import-table inspection with no engine or catalog verification. */
export const createPeImportsService = (): PeImportsService =>
new PeImportsService(new PeImportsProvider());
/** Portable Shell Link inspection with no COM, engine or target resolution. */
export const createWindowsShortcutService = (): WindowsShortcutService =>
new WindowsShortcutService(new WindowsShortcutProvider());
/** Portable PE/ELF export tables with no engine, toolchain or target acquisition. */
export const createNativeExportsService = (): NativeExportsService =>
new NativeExportsService(new NativeExportsProvider());
/** Portable ELF note-table inspection with no engine or package catalog. */
export const createElfNotesService = (): ElfNotesService =>
new ElfNotesService(new ElfNotesProvider());
/** Portable DWARF compile-unit inspection with no engine or debug package. */
export const createDwarfUnitsService = (): DwarfUnitsService =>
new DwarfUnitsService(new DwarfUnitsProvider());
/** Portable ELF separate-debug linkage inspection with no engine or network lookup. */
export const createElfDebugLinkService = (): ElfDebugLinkService =>
new ElfDebugLinkService(new ElfDebugLinkProvider());
/** Portable ELF and Mach-O initializer and finalizer listing with no engine. */
export const createNativeInitializersService = (): NativeInitializersService =>
new NativeInitializersService(new NativeInitializersProvider());
/** Portable ELF unwind-range inspection with no engine or disassembler. */
export const createElfUnwindRangesService = (): ElfUnwindRangesService =>
new ElfUnwindRangesService(new ElfUnwindRangesProvider());
/** Portable Apple .ips inspection with no engine, Xcode or target acquisition. */
export const createAppleIpsService = (): AppleIpsService =>
new AppleIpsService(new AppleIpsProvider());
/** Portable Linux kernel-module metadata inspection with no engine or host `modinfo`. */
export const createKernelModuleService = (): KernelModuleService =>
new KernelModuleService(new KernelModuleProvider());
/** Portable Linux kernel banner and embedded build-config inspection with no engine or host tools. */
export const createKernelBuildConfigService = (): KernelBuildConfigService =>
new KernelBuildConfigService(new KernelBuildConfigProvider());
/** Portable ELF dynamic-dependency inspection with no loader or host `ldd`. */
export const createElfDependenciesService = (): ElfDependenciesService =>
new ElfDependenciesService(new ElfDependenciesProvider());
/** Compose the offline adapter without import-time I/O or dependency acquisition. */
export const createBinaryLayoutService = (
environment: Readonly<NodeJS.ProcessEnv> = process.env,
host: HostPlatform = HOST_PLATFORM,
): BinaryLayoutService =>
new BinaryLayoutService(
new PwntoolsLayoutProvider(environment, undefined, undefined, host),
);
/** Compose recorded-core inspection without acquiring a debugger or toolchain. */
export const createRecordedCrashService = (
environment: Readonly<NodeJS.ProcessEnv> = process.env,
host: HostPlatform = HOST_PLATFORM,
): RecordedCrashService =>
new RecordedCrashService(
new PwntoolsRecordedCrashProvider(environment, undefined, undefined, host),
);
/** Provider-free local byte analysis. */
export const createByteEntropyService = (
resources?: ArtifactResourceScope,
): ByteEntropyService => new ByteEntropyService(undefined, resources);
export const createPeLoadConfigService = (): PeLoadConfigService =>
new PeLoadConfigService(new PeLoadConfigProvider());
/** Portable ELF, PE, and Mach-O hardening inspection with no engine or toolchain. */
export const createBinaryHardeningService = (): BinaryHardeningService =>
new BinaryHardeningService(new BinaryHardeningProvider());