Decompilation Process

This page explains how to read and interpret Ghidra’s decompiled C output, with examples from the Crimsonland reverse engineering effort.

Decompiler Overview

Ghidra’s decompiler converts x86 assembly to C pseudocode by:

Lifting machine code to P-CODE intermediate representation
Analysis to recover control flow (loops, branches, switches)
Type inference from usage patterns and API signatures
Simplification to collapse redundant operations

Result: Readable C-like code that preserves program logic but may use odd variable names and casts.

Reading Decompiled Code

Function Signature

/* projectile_update @ 00420b90 */
void projectile_update(void)

Address comment tracks original location
Return type inferred from assembly (void if no eax usage)
Parameters reconstructed from stack/register access

Local Variables

Ghidra generates names like local_XX based on stack offset:

int local_e8;
float local_c0;
float local_bc;

Before renaming:

local_e8 = 0;
while (local_e8 < 0x60) {
    if (*(char*)(0x004926b8 + local_e8 * 0x40) != 0) {
        // ...
    }
    local_e8++;
}

After renaming (manual annotation):

int proj_idx = 0;
while (proj_idx < 0x60) {
    if (projectile_pool[proj_idx].active) {
        // ...
    }
    proj_idx++;
}

Global Access

Ghidra represents globals as DAT_ addresses:

float health = *(float*)(&DAT_004908d4 + player_idx * 0x360);

Interpretation:

Base address: 0x004908d4
Stride: 0x360 bytes per entry
Type: float at offset 0x00

After symbol recovery:

float health = player_health[player_idx];

Pointer Arithmetic

Decompiler shows raw pointer math:

pfVar1 = (float*)(&DAT_004926b8 + local_e8 * 0x40 + 0x08);
*pfVar1 = *pfVar1 + vel_x * delta_time;

Meaning: Access projectile_pool[local_e8].pos_x (offset 0x08) and add vel_x * delta_time.

Common Patterns

Pool Iteration

// Pattern: Loop over fixed-size pool
for (int i = 0; i < POOL_SIZE; i++) {
    if (pool[i].active) {
        update_entry(&pool[i]);
    }
}

Example (projectile update):

local_e8 = 0;
do {
    if (projectile_pool[local_e8].active != '\0') {
        // Update logic here
    }
    local_e8 = local_e8 + 1;
} while (local_e8 < 0x60);

Switch Statement

switch (projectile_type) {
    case 0x01:  // Pistol bullet
        damage = 10.0;
        break;
    case 0x06:  // Gauss beam
        damage = 50.0;
        hit_radius = 3.0;
        break;
    default:
        damage = 1.0;
}

Ghidra may show jump tables or cascading if statements depending on compiler optimization.

Function Calls

iVar7 = perk_count_get(perk_id_ion_gun_master);
if (iVar7 != 0) {
    local_c0 = 1.2;  // 20% damage boost
}

Convention:

Parameters passed via stack or registers (cdecl, fastcall, thiscall)
Return value in eax (integers) or st(0) (floats)

Float Casts

Floating-point math may show explicit casts:

float result = (float)((double)a * (double)b + (double)c);

Why: x87 FPU uses 80-bit extended precision internally; decompiler shows intermediate conversions. Parity note: Python rewrite must use float32 explicitly to match original precision.

Identifying Data Structures

Struct Access

Repeated offsets reveal struct layout:

// Read multiple fields from same base + index
active = *(char*)(base + idx * 0x40 + 0x00);
angle = *(float*)(base + idx * 0x40 + 0x04);
pos_x = *(float*)(base + idx * 0x40 + 0x08);
pos_y = *(float*)(base + idx * 0x40 + 0x0c);

Inferred struct:

typedef struct {
    u8 active;      // +0x00
    u8 _pad[3];
    float angle;    // +0x04
    float pos_x;    // +0x08
    float pos_y;    // +0x0c
    // ...
} projectile_t;  // 0x40 bytes

Array-of-Structs

projectile_t projectile_pool[0x60];

// Access: projectile_pool[i].field
for (int i = 0; i < 0x60; i++) {
    if (projectile_pool[i].active) {
        projectile_pool[i].pos_x += velocity * dt;
    }
}

Structure-of-Arrays

float fx_pos_x[0x80];
float fx_pos_y[0x80];
float fx_color_r[0x80];

// Access: array[i]
for (int i = 0; i < fx_queue_count; i++) {
    draw_sprite(fx_pos_x[i], fx_pos_y[i], fx_color_r[i]);
}

Identifying: Multiple parallel arrays with same stride, indexed together.

Control Flow

Loops

While loop:

while (condition) {
    // body
}

Do-while:

do {
    // body
} while (condition);

For loop (decompiler often shows as while):

int i = 0;
while (i < count) {
    // body
    i++;
}

Branches

if (player_health <= 0.0) {
    player_death_timer = 5.0;
    sfx_play(SOUND_DEATH);
}

Ghidra preserves branch structure from assembly (je, jne, jg).

Nested Conditions

Deeply nested if statements may indicate state machines or complex branching logic:

if (game_state == STATE_PLAYING) {
    if (player_alive) {
        if (input_fire_pressed) {
            weapon_fire();
        }
    } else {
        if (death_timer <= 0) {
            transition_to_game_over();
        }
    }
}

Type Inference Challenges

Ambiguous Types

Without debug symbols, Ghidra guesses types from context:

int iVar7 = some_function();  // Could be bool, enum, or int

Solution: Cross-reference with runtime captures to confirm actual values.

Pointer Confusion

void* pvVar3 = (void*)0x00480348;
int value = *(int*)((int)pvVar3 + 0x1c8);

Better interpretation (after struct definition):

crimson_cfg_t* config = (crimson_cfg_t*)0x00480348;
int keybind = config->keybinds_p1[0];

Float vs Int

Memory operations may show wrong type:

int iVar7 = *(int*)(player_base + 0x2a8);  // Actually a float!

Detection: Usage in FPU instructions (fadd, fmul) indicates float.

Working with Decompiled Output

Keep Original Addresses

Preserve address comments for cross-referencing:

/* projectile_update @ 00420b90 */
void projectile_update(void)
{
    /* LAB_00420c45: */
    if (projectile_type == 0x15) {
        // ...
    }
}

Labels like LAB_00420c45 map to assembly locations.

Annotate with Evidence

Add comments linking to runtime captures:

// Confirmed via Frida: Fire Bullets bonus forces type 0x2d
if (owner_id <= -100 && player_fire_bullets_timer[owner_id] > 0.0) {
    type_id = 0x2d;
}

Split Complex Functions

Large functions (1000+ lines) benefit from extraction:

uv run scripts/ghidra_hotspot_extract.py \
  --function projectile_update \
  --depth 1

Focus on subsections in work/ directory for detailed annotation.

Example: Projectile Update

Let’s walk through a real decompiled function:

Raw Decompile

void FUN_00420b90(void)
{
  int iVar1;
  float fVar2;
  int local_e8;
  float local_c0;
  
  local_c0 = 1.0;
  iVar1 = FUN_0042fcf0(0x3a);
  if (iVar1 != 0) {
    local_c0 = 1.2;
  }
  
  local_e8 = 0;
  do {
    if (*(char*)(0x004926b8 + local_e8 * 0x40) != '\0') {
      fVar2 = *(float*)(0x004926b8 + local_e8 * 0x40 + 0x24);
      if (fVar2 <= 0.0) {
        *(undefined*)(0x004926b8 + local_e8 * 0x40) = 0;
      } else {
        *(float*)(0x004926b8 + local_e8 * 0x40 + 0x24) = fVar2 - *(float*)0x00480840;
        // ... movement and collision logic
      }
    }
    local_e8 = local_e8 + 1;
  } while (local_e8 < 0x60);
}

After Symbol Recovery

void projectile_update(void)
{
  int has_ion_perk;
  float damage_multiplier;
  int proj_idx;
  float life_timer;
  
  damage_multiplier = 1.0;
  has_ion_perk = perk_count_get(PERK_ION_GUN_MASTER);
  if (has_ion_perk != 0) {
    damage_multiplier = 1.2;  // +20% damage
  }
  
  proj_idx = 0;
  do {
    if (projectile_pool[proj_idx].active) {
      life_timer = projectile_pool[proj_idx].life_timer;
      if (life_timer <= 0.0) {
        projectile_pool[proj_idx].active = 0;  // Despawn
      } else {
        projectile_pool[proj_idx].life_timer = life_timer - delta_time;
        // ... movement and collision logic
      }
    }
    proj_idx++;
  } while (proj_idx < PROJECTILE_POOL_SIZE);
}

With Type Definitions

void projectile_update(void)
{
  float damage_multiplier = 1.0;
  
  if (perk_count_get(PERK_ION_GUN_MASTER)) {
    damage_multiplier = 1.2;
  }
  
  for (int i = 0; i < PROJECTILE_POOL_SIZE; i++) {
    projectile_t* proj = &projectile_pool[i];
    if (!proj->active) continue;
    
    proj->life_timer -= delta_time;
    if (proj->life_timer <= 0.0) {
      proj->active = false;
      continue;
    }
    
    // Update position
    proj->pos_x += proj->vel_x * proj->speed_scale * delta_time;
    proj->pos_y += proj->vel_y * proj->speed_scale * delta_time;
    
    // Collision detection...
  }
}

Ghidra Workflow

Complete static analysis process

Struct Recovery

Reconstructing data structures

Frida Capture

Validating decompiled logic with runtime data

Overview

Static Analysis

Runtime Analysis

File Formats

Data Structures

Documentation Index

​Decompiler Overview

​Reading Decompiled Code

​Function Signature

​Local Variables

​Global Access

​Pointer Arithmetic

​Common Patterns

​Pool Iteration

​Switch Statement

​Function Calls

​Float Casts

​Identifying Data Structures

​Struct Access

​Array-of-Structs

​Structure-of-Arrays

​Control Flow

​Loops

​Branches

​Nested Conditions

​Type Inference Challenges

​Ambiguous Types

​Pointer Confusion

​Float vs Int

​Working with Decompiled Output

​Keep Original Addresses

​Annotate with Evidence

​Split Complex Functions

​Example: Projectile Update

​Raw Decompile

​After Symbol Recovery

​With Type Definitions

​Related Pages