gem5 模拟器

本仓库包含 gem5 模拟器的完整源代码、所有测试及回归测试相关内容。

gem5 模拟器是一个用于计算机系统架构研究的模块化平台，涵盖系统级架构和处理器微架构。它主要用于评估新的硬件设计、系统软件变更以及编译时和运行时系统优化。

官方网站地址：http://www.gem5.org。

测试状态

注意：以下测试状态基于 gem5 的 develop 分支：https://github.com/gem5/gem5/tree/develop。

入门指南

建议从 http://www.gem5.org/about 开始了解。有关构建模拟器和入门的更多信息，请参阅 http://www.gem5.org/documentation 和 http://www.gem5.org/documentation/learning_gem5/introduction。

构建 gem5

构建 gem5 需要以下软件：g++ 或 clang、Python（gem5 会链接 Python 解释器）、SCons、zlib、m4。如果需要跟踪捕获和回放支持，还需 protobuf。有关这些工具的最低版本要求，请详见 http://www.gem5.org/documentation/general_docs/building。

解决所有依赖后，执行 scons build/ALL/gem5.opt 可构建包含所有 gem5 ISA 的优化版本二进制文件（gem5.opt）。如果只需编译包含单个 ISA 的 gem5，可将 ALL 替换为相应 ISA 的名称。有效选项包括 ARM、NULL、MIPS、POWER、RISCV、SPARC 和 X86。完整选项列表可在 build_opts 目录中找到。

有关构建 gem5 的更多信息，请参见 https://www.gem5.org/documentation/general_docs/building。

源代码树

主源代码树包含以下子目录：

• build_opts：gem5 的预制默认配置
• build_tools：gem5 构建过程内部使用的工具
• configs：示例仿真配置脚本
• ext：构建 gem5 所需的不太常见的外部软件包
• include：供其他程序使用的头文件
• site_scons：构建系统的模块化组件
• src：gem5 模拟器的源代码。C++ 源代码、Python 包装器和 Python 标准库位于此目录中。
• system：用于仿真系统的一些可选系统软件的源代码
• tests：回归测试
• util：有用的实用程序和文件

gem5 资源

要运行全系统仿真，根据 gem5 的配置以及您尝试运行的工作负载类型，您可能需要已编译的系统固件、内核二进制文件和一个或多个磁盘镜像。许多此类资源可从 https://resources.gem5.org 获取。

有关 gem5 资源的更多信息，请参见 https://www.gem5.org/documentation/general_docs/gem5_resources/。

获取帮助、报告错误和请求功能

我们为用户和开发人员提供了多种渠道，以获取帮助、报告错误、请求功能或参与社区讨论。以下是我们推荐使用的一些最常用渠道。

• GitHub Discussions：GitHub 讨论页面。可用于发起讨论或提问。网址为 https://github.com/orgs/gem5/discussions。
• GitHub Issues：用于报告错误或请求功能的 GitHub 问题页面。网址为 https://github.com/gem5/gem5/issues。
• Jira Issue Tracker：用于报告错误或请求功能的 Jira 问题跟踪器。网址为 https://gem5.atlassian.net/。
• Slack：一个 Slack 服务器，设有多个频道，供 gem5 社区参与各种讨论。请访问 https://www.gem5.org/join-slack 加入。
• gem5-users@gem5.org：供 gem5 用户提问或发起讨论的邮件列表。要加入该邮件列表，请访问 https://www.gem5.org/mailing_lists。
• gem5-dev@gem5.org：供 gem5 开发人员提问或发起讨论的邮件列表。要加入该邮件列表，请访问 https://www.gem5.org/mailing_lists。

为 gem5 做贡献

我们希望您能享受使用 gem5 的过程。在合适的情况下，我们建议您分享对本项目的贡献。https://www.gem5.org/contributing 可以帮助您入门。更多信息请参见 CONTRIBUTING.md 文件。