Skip to content

[docs] fix outdated and missing apt packages in QEMU Linux quick start - #11789

Open
shiptux wants to merge 1 commit into
RT-Thread:masterfrom
shiptux:docs/qemu-linux-deps
Open

[docs] fix outdated and missing apt packages in QEMU Linux quick start#11789
shiptux wants to merge 1 commit into
RT-Thread:masterfrom
shiptux:docs/qemu-linux-deps

Conversation

@shiptux

@shiptux shiptux commented Sep 8, 2026

Copy link
Copy Markdown

Problem

The dependency list in documentation/2.quick-start/quick_start_qemu/quick_start_qemu_linux.md no longer works on current Debian/Ubuntu releases:

  • gdb-arm-none-eabi no longer exists (dropped since Debian 11 / Ubuntu 22.04)
  • the qemu meta-package has been split up and can no longer be installed
  • libncurses5-dev has been removed; libncurses-dev replaces it
  • libstdc++-arm-none-eabi-newlib is missing, so linking fails with cannot find -lsupc++, which does not point at the missing package
  • kconfiglib is not mentioned at all, although scons --menuconfig needs it; python3-kconfiglib is packaged, while pip install kconfiglib is rejected by PEP 668 on recent releases

The list is also given as eleven separate sudo apt install commands.

Change

  • Merge the eleven single-package commands into one (packages verified to resolve with apt-get -s install on Debian 13)
  • Add a table mapping old package names to the current ones, for readers following older tutorials
  • Note the kconfiglib requirement where scons --menuconfig is first used, and why pip is not the way to install it

Verified on Debian 13 (trixie): the merged command resolves cleanly, and a from-scratch build of bsp/qemu-vexpress-a9 with these packages succeeds.

The dependency list in the QEMU (Ubuntu) quick start no longer works on
current Debian/Ubuntu releases:

- gdb-arm-none-eabi no longer exists (dropped since Debian 11 /
  Ubuntu 22.04); gdb-multiarch replaces it
- the qemu meta-package has been split up and can no longer be installed
- libncurses5-dev has been removed; libncurses-dev replaces it
- libstdc++-arm-none-eabi-newlib was missing, so linking fails with
  "cannot find -lsupc++", which does not point at the missing package
- kconfiglib was not mentioned at all, although scons --menuconfig needs
  it; python3-kconfiglib is packaged, and pip install kconfiglib is
  rejected by PEP 668 on recent releases

Merge the eleven single-package commands into one, add a table mapping
the old package names to the current ones, and note the kconfiglib
requirement where menuconfig is first used.

Verified with apt-get -s install on Debian 13.
@github-actions

github-actions Bot commented Sep 8, 2026

Copy link
Copy Markdown

👋 感谢您对 RT-Thread 的贡献!Thank you for your contribution to RT-Thread!

为确保代码符合 RT-Thread 的编码规范,请在你的仓库中执行以下步骤运行代码格式化工作流(如果格式化CI运行失败)。
To ensure your code complies with RT-Thread's coding style, please run the code formatting workflow by following the steps below (If the formatting of CI fails to run).


🛠 操作步骤 | Steps

  1. 前往 Actions 页面 | Go to the Actions page
    点击进入工作流 → | Click to open workflow →

  2. 点击 Run workflow | Click Run workflow

  • Use workflow from 保持默认分支(通常为 master
    Keep the default branch (usually master) in Use workflow from
  • branch 输入框填写 PR 分支 docs/qemu-linux-deps
    Enter PR branch docs/qemu-linux-deps in the branch field
  • 设置需排除的文件/目录(目录请以"/"结尾)
    Set files/directories to exclude (directories should end with "/")
  1. 等待工作流完成 | Wait for the workflow to complete
    格式化后的代码将作为独立提交推送至你的分支。
    The formatting changes will be pushed to your branch as a separate commit.

完成后,提交将自动更新至 docs/qemu-linux-deps 分支,关联的 Pull Request 也会同步更新。
Once completed, commits will be pushed to the docs/qemu-linux-deps branch automatically, and the related Pull Request will be updated.

如有问题欢迎联系我们,再次感谢您的贡献!💐
If you have any questions, feel free to reach out. Thanks again for your contribution!

@github-actions github-actions Bot added the Doc This PR/issue related with documents label Sep 8, 2026
@github-actions

github-actions Bot commented Sep 8, 2026

Copy link
Copy Markdown

📌 Code Review Assignment

🏷️ Tag: documentation

Reviewers: @CXSforHPU @GorrayLi @lianux-mm

Changed Files (Click to expand)
  • documentation/2.quick-start/quick_start_qemu/quick_start_qemu_linux.md

📊 Current Review Status (Last Updated: 2026-09-08 22:06 CST)


📝 Review Instructions

  1. 维护者可以通过单击此处来刷新审查状态: 🔄 刷新状态
    Maintainers can refresh the review status by clicking here: 🔄 Refresh Status

  2. 确认审核通过后评论 LGTM/lgtm
    Comment LGTM/lgtm after confirming approval

  3. PR合并前需至少一位维护者确认
    PR must be confirmed by at least one maintainer before merging

ℹ️ 刷新CI状态操作需要具备仓库写入权限。
ℹ️ Refresh CI status operation requires repository Write permission.

@CLAassistant

Copy link
Copy Markdown

CLA assistant check
Thank you for your submission! We really appreciate it. Like many open source projects, we ask that you sign our Contributor License Agreement before we can accept your contribution.


Cheng Li seems not to be a GitHub user. You need a GitHub account to be able to sign the CLA. If you have already a GitHub account, please add the email address used for this commit to your account.
You have signed the CLA already but the status is still pending? Let us recheck it.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Doc This PR/issue related with documents

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants