Skip to content

Fix qemu-guest-agent startup failure by replacing --blacklist with --block-rpcs#16275

Open
Travisivart wants to merge 1 commit intomicrosoft:3.0-devfrom
Travisivart:travisivart/qemu-9.1-fix
Open

Fix qemu-guest-agent startup failure by replacing --blacklist with --block-rpcs#16275
Travisivart wants to merge 1 commit intomicrosoft:3.0-devfrom
Travisivart:travisivart/qemu-9.1-fix

Conversation

@Travisivart
Copy link
Copy Markdown
Member

@Travisivart Travisivart commented Mar 24, 2026

Merge Checklist
  • The toolchain has been rebuilt successfully (or no changes were made to it)
  • The toolchain/worker package manifests are up-to-date
  • Any updated packages successfully build (or no packages were changed)
  • Packages depending on static components modified in this PR (Golang, *-static subpackages, etc.) have had their Release tag incremented.
  • Package tests (%check section) have been verified with RUN_CHECK=y for existing SPEC files, or added to new SPEC files
  • All package sources are available
  • cgmanifest files are up-to-date and sorted
  • LICENSE-MAP files are up-to-date
  • All source files have up-to-date hashes in the *.signatures.json files
  • sudo make go-tidy-all and sudo make go-test-coverage pass
  • Documentation has been updated to match any changes to the build system
  • Ready to merge

Summary

QEMU 9.1 removed the deprecated --blacklist CLI option from qemu-ga, replacing it with --block-rpcs. The qemu-guest-agent systemd service file and sysconfig still referenced --blacklist, causing the guest agent to fail to start with:

qemu-ga: unrecognized option '--blacklist'

This PR updates the service file and sysconfig to use the new --block-rpcs flag and renames the BLACKLIST_RPC environment variable to BLOCK_RPCS.

Change Log
  • Replace --blacklist=${BLACKLIST_RPC} with --block-rpcs=${BLOCK_RPCS} in qemu-guest-agent.service
  • Rename BLACKLIST_RPC to BLOCK_RPCS and update comments in qemu-ga.sysconfig
  • Bump qemu Release from 1 to 2 and add changelog entry
Does this affect the toolchain?

NO

Associated issues
Test Methodology
  • Verified qemu-ga --help confirms --block-rpcs is the correct replacement flag
  • Confirmed via upstream QEMU commit and Red Hat BZ#2258100 that --blacklist was removed in QEMU 9.1
  • No source tarballs or signatures changed (only service/sysconfig files and spec release bump)

@Travisivart Travisivart requested a review from a team as a code owner March 24, 2026 23:07
@microsoft-github-policy-service microsoft-github-policy-service bot added Packaging 3.0-dev PRs Destined for AzureLinux 3.0 labels Mar 24, 2026
@Travisivart Travisivart force-pushed the travisivart/qemu-9.1-fix branch from 70b17c2 to eb19e58 Compare March 24, 2026 23:13
QEMU 9.1 removed the deprecated --blacklist CLI option from qemu-ga,
replacing it with --block-rpcs. The systemd service file still used the
old flag, causing qemu-guest-agent to fail to start.

Update qemu-guest-agent.service and qemu-ga.sysconfig to use --block-rpcs
and rename the BLACKLIST_RPC environment variable to BLOCK_RPCS.

Fixes: microsoft#15843
@Travisivart Travisivart force-pushed the travisivart/qemu-9.1-fix branch from eb19e58 to 6d25395 Compare March 24, 2026 23:42
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

3.0-dev PRs Destined for AzureLinux 3.0 Packaging

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants