# hovm

**Repository Path**: foreverofprogrammer/hovm

## Basic Information

- **Project Name**: hovm
- **Description**: Ho虚拟机
- **Primary Language**: C
- **License**: GPL-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 3
- **Forks**: 0
- **Created**: 2024-01-25
- **Last Updated**: 2026-05-25

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README



# HOVM

轻量级虚拟机器实现库。

## 项目简介

HOVM 是一个用 C 语言实现的轻量级虚拟机器（Virtual Machine）库，提供了基本的指令解析、内存管理、寄存器操作和算术运算功能。该项目旨在为教育和研究目的提供一个简洁、可扩展的虚拟机框架。

## 功能特性

- **指令解析**: 支持将字节码或脚本命令解析为可执行的指令结构
- **内存管理**: 提供动态内存分配、释放和访问功能
- **寄存器操作**: 模拟 CPU 寄存器的初始化、读取和更新
- **算术运算**: 支持加法、减法、乘法、除法等基础数学运算
- **文件操作**: 支持读取二进制文件和获取文件大小

## 文件结构

| 文件 | 说明 |
|------|------|
| `main.c` | 程序入口 |
| `command.c` / `command.h` | 命令解析与执行实现 |
| `file.c` / `file.h` | 文件操作相关函数 |
| `memory.c` / `memory.h` | 虚拟内存管理 |
| `registers.c` / `registers.h` | 寄存器操作 |
| `vmmath.c` / `vmmath.h` | 数学运算函数 |
| `vmmalloc.c` / `vmmalloc.h` | 内存分配管理 |

## 编译与运行

### 环境要求

- C 编译器（如 GCC）
- Windows 或 Linux 系统

### 编译步骤

在 Windows 环境下，可使用提供的批处理文件快速编译：

```bash
dll.bat
```

或手动编译：

```bash
gcc -o hovm main.c command.c file.c memory.c registers.c vmmath.c vmmalloc.c
```

### 运行

编译完成后，运行生成的可执行文件即可启动虚拟机。

## 使用说明

### 基本概念

- **内存 (Memory)**: 虚拟机分配的连续内存空间，用于存储数据和状态
- **寄存器 (Registers)**: 虚拟机中的快速存取存储单元，类似于 CPU 寄存器
- **命令 (Command)**: 待执行的指令，包含操作类型和操作数

### API 简要说明

```c
// 创建和释放内存
Memory create_memory(unsigned long memory_size);
void release_memory(Memory memory);

// 内存访问
unsigned char get_memory(Memory memory, unsigned long address);

// 寄存器操作
void init_registers(registers *r);
unsigned char get_register(registers r, unsigned char r_id, unsigned char default_value);
void update_register(registers *r, unsigned char r_id, unsigned char r_value);

// 命令执行
int execute_command(Command cmd, registers *r, Memory memory);

// 数学运算
Add add(unsigned short add1, unsigned short add2);
unsigned short sub(unsigned short sub1, unsigned short sub2);
unsigned short mul(unsigned short mul1, unsigned short mul2);
Div division(unsigned short div1, unsigned short div2);
```

## 示例

更多使用示例请參考源代码中的实现。

## 开源许可证

本项目具体许可证请查看 LICENSE 文件。