# LC4 Disassembler

A C program that loads and disassembles LC4 object files, converting machine code back into human-readable assembly instructions.

## Overview

This project implements an LC4 (Little Computer 4) disassembler that:

- Loads LC4 object files (`.obj`) into memory using a linked list structure
- Parses the binary machine code
- Converts the machine code back into LC4 assembly language
- Displays the disassembled output

## Files

- `lc4.c` - Main program entry point
- `lc4_loader.c/h` - File parsing and memory loading functionality
- `lc4_memory.c/h` - Dynamic memory management using linked lists
- `lc4_disassembler.c/h` - Machine code to assembly conversion
- `obj_files_for_testing/` - Sample LC4 object files for testing

## Building

```bash
make
```

This will compile all source files and create the `lc4` executable.

## Usage

```bash
./lc4 <object_file>.obj
```

Example:

```bash
./lc4 obj_files_for_testing/test1.obj
```

## Testing

The `obj_files_for_testing/` directory contains various test files:

- Basic instruction tests (`test1.obj`, `test2.obj`, etc.)
- Factorial implementations (`dmem_fact_ec.obj`)
- Graphics/drawing programs (`user_draw.obj`)
- String manipulation (`user_string_ec.obj`)

## Cleaning

```bash
make clean    # Remove object files
make clobber  # Remove object files and executable
```