objdiff-wasm 3.0.0-alpha.2 → 3.0.0-beta.10

package/dist/config-schema.json

@@ -25,6 +25,20 @@
         }
       ]
     },
+    {
+      "id": "analyzeDataFlow",
+      "type": "boolean",
+      "default": false,
+      "name": "(Experimental) Perform data flow analysis",
+      "description": "Use data flow analysis to display known information about register contents where possible"
+    },
+    {
+      "id": "showDataFlow",
+      "type": "boolean",
+      "default": true,
+      "name": "Show data flow",
+      "description": "Show data flow analysis results in place of register name where present"
+    },
     {
       "id": "spaceBetweenArgs",
       "type": "boolean",
@@ -194,6 +208,13 @@
       "name": "Register '$' prefix",
       "description": "Display MIPS register names with a '$' prefix."
     },
+    {
+      "id": "ppc.calculatePoolRelocations",
+      "type": "boolean",
+      "default": true,
+      "name": "Calculate pooled data references",
+      "description": "Display pooled data references in functions as fake relocations."
+    },
     {
       "id": "x86.formatter",
       "type": "choice",
@@ -253,6 +274,14 @@
         "mips.registerPrefix"
       ]
     },
+    {
+      "id": "ppc",
+      "name": "PowerPC",
+      "properties": [
+        "ppc.calculatePoolRelocations",
+        "analyzeDataFlow"
+      ]
+    },
     {
       "id": "x86",
       "name": "x86",
@@ -261,4 +290,4 @@
       ]
     }
   ]
-}
+}

package/dist/interfaces/objdiff-core-diff.d.ts

@@ -1,10 +1,46 @@
 /** @module Interface objdiff:core/diff **/
-export function runDiff(left: Object | undefined, right: Object | undefined, config: DiffConfig): DiffResult;
+export function runDiff(left: Object | undefined, right: Object | undefined, config: DiffConfig, mapping: MappingConfig): DiffResult;
 export interface MappingConfig {
   mappings: Array<[string, string]>,
   selectingLeft?: string,
   selectingRight?: string,
 }
+export type SymbolRef = number;
+/**
+ * # Variants
+ * 
+ * ## `"unknown"`
+ * 
+ * ## `"function"`
+ * 
+ * ## `"object"`
+ * 
+ * ## `"section"`
+ */
+export type SymbolKind = 'unknown' | 'function' | 'object' | 'section';
+export interface SymbolFlags {
+  global?: boolean,
+  local?: boolean,
+  weak?: boolean,
+  common?: boolean,
+  hidden?: boolean,
+  hasExtra?: boolean,
+  sizeInferred?: boolean,
+  ignored?: boolean,
+}
+export interface SymbolInfo {
+  id: SymbolRef,
+  name: string,
+  demangledName?: string,
+  address: bigint,
+  size: bigint,
+  kind: SymbolKind,
+  section?: number,
+  sectionName?: string,
+  flags: SymbolFlags,
+  align?: number,
+  virtualAddress?: bigint,
+}
 export interface DiffResult {
   left?: ObjectDiff,
   right?: ObjectDiff,
@@ -22,6 +58,7 @@ export class Object {
    */
   private constructor();
   static parse(data: Uint8Array, config: DiffConfig): Object;
+  hash(): bigint;
 }
 
 export class ObjectDiff {
@@ -29,5 +66,6 @@ export class ObjectDiff {
    * This type does not have a public constructor.
    */
   private constructor();
-  findSymbol(name: string, sectionName: string | undefined): number | undefined;
+  findSymbol(name: string, sectionName: string | undefined): SymbolInfo | undefined;
+  getSymbol(id: number): SymbolInfo | undefined;
 }

package/dist/interfaces/objdiff-core-display.d.ts

@@ -1,15 +1,16 @@
 /** @module Interface objdiff:core/display **/
 export function displaySections(diff: ObjectDiff, filter: SymbolFilter, config: DisplayConfig): Array<SectionDisplay>;
-export function displaySymbol(diff: ObjectDiff, symbol: SectionDisplaySymbol): SymbolDisplay;
-export function displayInstructionRow(diff: ObjectDiff, symbol: SectionDisplaySymbol, rowIndex: number, config: DiffConfig): InstructionDiffRow;
-export function symbolContext(diff: ObjectDiff, symbol: SectionDisplaySymbol): Array<ContextItem>;
-export function symbolHover(diff: ObjectDiff, symbol: SectionDisplaySymbol): Array<HoverItem>;
-export function instructionContext(diff: ObjectDiff, symbol: SectionDisplaySymbol, rowIndex: number, config: DiffConfig): Array<ContextItem>;
-export function instructionHover(diff: ObjectDiff, symbol: SectionDisplaySymbol, rowIndex: number, config: DiffConfig): Array<HoverItem>;
+export function displaySymbol(diff: ObjectDiff, symbol: SymbolRef): SymbolDisplay;
+export function displayInstructionRow(diff: ObjectDiff, symbol: SymbolRef, rowIndex: number, config: DiffConfig): InstructionDiffRow;
+export function symbolContext(diff: ObjectDiff, symbol: SymbolRef): Array<ContextItem>;
+export function symbolHover(diff: ObjectDiff, symbol: SymbolRef): Array<HoverItem>;
+export function instructionContext(diff: ObjectDiff, symbol: SymbolRef, rowIndex: number, config: DiffConfig): Array<ContextItem>;
+export function instructionHover(diff: ObjectDiff, symbol: SymbolRef, rowIndex: number, config: DiffConfig): Array<HoverItem>;
 export type Object = import('./objdiff-core-diff.js').Object;
 export type ObjectDiff = import('./objdiff-core-diff.js').ObjectDiff;
 export type DiffConfig = import('./objdiff-core-diff.js').DiffConfig;
-export type SymbolRef = number;
+export type SymbolInfo = import('./objdiff-core-diff.js').SymbolInfo;
+export type SymbolRef = import('./objdiff-core-diff.js').SymbolRef;
 export interface DisplayConfig {
   showHiddenSymbols: boolean,
   showMappedSymbols: boolean,
@@ -19,48 +20,15 @@ export interface SymbolFilter {
   regex?: string,
   mapping?: SymbolRef,
 }
-export interface SectionDisplaySymbol {
-  symbol: SymbolRef,
-  isMappingSymbol: boolean,
-}
 export interface SectionDisplay {
   id: string,
   name: string,
   size: bigint,
   matchPercent?: number,
-  symbols: Array<SectionDisplaySymbol>,
-}
-/**
- * # Variants
- * 
- * ## `"unknown"`
- * 
- * ## `"function"`
- * 
- * ## `"object"`
- * 
- * ## `"section"`
- */
-export type SymbolKind = 'unknown' | 'function' | 'object' | 'section';
-export interface SymbolFlags {
-  global?: boolean,
-  local?: boolean,
-  weak?: boolean,
-  common?: boolean,
-  hidden?: boolean,
-  hasExtra?: boolean,
-  sizeInferred?: boolean,
+  symbols: Uint32Array,
 }
 export interface SymbolDisplay {
-  name: string,
-  demangledName?: string,
-  address: bigint,
-  size: bigint,
-  kind: SymbolKind,
-  section?: number,
-  flags: SymbolFlags,
-  align?: number,
-  virtualAddress?: bigint,
+  info: SymbolInfo,
   targetSymbol?: SymbolRef,
   matchPercent?: number,
   diffScore?: [bigint, bigint],
@@ -103,8 +71,12 @@ export interface ContextItemSeparator {
  * ## `"emphasized"`
  * 
  * ## `"special"`
+ * 
+ * ## `"delete"`
+ * 
+ * ## `"insert"`
  */
-export type HoverItemColor = 'normal' | 'emphasized' | 'special';
+export type HoverItemColor = 'normal' | 'emphasized' | 'special' | 'delete' | 'insert';
 export interface HoverItemText {
   label: string,
   value: string,
@@ -174,7 +146,7 @@ export interface DiffTextSpacing {
 export interface DiffTextEol {
   tag: 'eol',
 }
-export type DiffTextColor = DiffTextColorNormal | DiffTextColorDim | DiffTextColorBright | DiffTextColorReplace | DiffTextColorDelete | DiffTextColorInsert | DiffTextColorRotating;
+export type DiffTextColor = DiffTextColorNormal | DiffTextColorDim | DiffTextColorBright | DiffTextColorReplace | DiffTextColorDataFlow | DiffTextColorDelete | DiffTextColorInsert | DiffTextColorRotating;
 export interface DiffTextColorNormal {
   tag: 'normal',
 }
@@ -187,6 +159,9 @@ export interface DiffTextColorBright {
 export interface DiffTextColorReplace {
   tag: 'replace',
 }
+export interface DiffTextColorDataFlow {
+  tag: 'data-flow',
+}
 export interface DiffTextColorDelete {
   tag: 'delete',
 }