Resolve issue with config file writing sections outside of their expected header.#13898
Merged
Resolve issue with config file writing sections outside of their expected header.#13898
Conversation
Contributor
There was a problem hiding this comment.
Pull request overview
This PR fixes a critical bug in the WSL configuration file parser where key-value pairs could be written before their section headers, causing "Unknown key" errors when parsing .wslconfig files. The fix moves the key-value writing logic to trigger immediately when a new section header is encountered, ensuring proper INI file structure is maintained.
- Relocated key-value insertion logic from after section parsing to before encountering new section headers
- Added comprehensive test coverage with 6 regression tests covering edge cases like empty sections, duplicate sections, and EOF scenarios
- Updated developer documentation to emphasize the need for full builds before running tests
Reviewed changes
Copilot reviewed 3 out of 3 changed files in this pull request and generated 1 comment.
| File | Description |
|---|---|
src/shared/configfile/configfile.cpp |
Moved key-value writing logic from ParseSection label to before case '[' to ensure keys are written to their current section before transitioning to a new section; removed unused newKeyValueInsertPos variable |
test/windows/UnitTests.cpp |
Added 6 comprehensive regression tests for issue #12671 covering the bug scenario, empty files, multiple same-section instances, EOF without trailing newline, empty sections, and section headers at EOF |
.github/copilot-instructions.md |
Added critical warning about requiring full project builds before running tests, with explanation of component dependencies |
OneBlue
approved these changes
Dec 15, 2025
benhillis
added a commit
that referenced
this pull request
Dec 20, 2025
* cleanup: minor tweaks to path translation failed messages (#13892) Co-authored-by: Ben Hillis <benhill@ntdev.microsoft.com> * Localization change from build: 135812430 (#13905) * Localization change from build: 135812430 * Apply suggestions from code review Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com> * remove unused string --------- Co-authored-by: WSL localization <noreply@microsoft.com> Co-authored-by: Ben Hillis <benhillis@gmail.com> Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com> Co-authored-by: Ben Hillis <benhill@ntdev.microsoft.com> * Resolve issue with config file writing sections outside of their expected header. (#13898) * Resolve issue with config file writing sections outside of their expected header. * add more writewslconfig variations * formatting --------- Co-authored-by: Ben Hillis <benhill@ntdev.microsoft.com> * Resolve issue with buttons on notifications not working correctly (#13921) * Resolve issue with buttons on notifications not working correctly * pr feedback --------- Co-authored-by: Ben Hillis <benhill@ntdev.microsoft.com> * Fix minor typo in UserConfig.cmake.sample (.exe instead of .dll) (#13926) Co-authored-by: Ben Hillis <benhill@ntdev.microsoft.com> * test: extend networking test coverage (#13914) * test: extend coverage of virtioproxy networking mode * test: add dns test variations to all networking classes * remove bridged dns variations * pr feedback --------- Co-authored-by: Ben Hillis <benhill@ntdev.microsoft.com> * cleanup: remove duplicate AppId registration for wsldevicehost.dll (#13928) Co-authored-by: Ben Hillis <benhill@ntdev.microsoft.com> * Remove the explicit desktop field when creating a Windows process (#13930) * [GH 13837] Remove trailing slash from $XDG_RUNTIME_DIR (#13929) * [GH 13837] Remove trailing slash from $XDG_RUNTIME_DIR * pr feedback --------- Co-authored-by: Ben Hillis <benhill@ntdev.microsoft.com> * test: add more path translation variations (#13927) * test: add more path translation variations * Update test/windows/SimpleTests.cpp Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com> --------- Co-authored-by: Ben Hillis <benhill@ntdev.microsoft.com> * virtiofs: enable additional test cases and skip one racey test (#13933) Co-authored-by: Ben Hillis <benhill@ntdev.microsoft.com> * cleanup: add scsi disks during VM creation (#13939) * cleanup: add scsi disks during VM creation * pr feedback --------- Co-authored-by: Ben Hillis <benhill@ntdev.microsoft.com> * cleanup: hcs logging improvements (#13942) Co-authored-by: Ben Hillis <benhill@ntdev.microsoft.com> * cleanup: switch drvfs.cpp to use common MountUtil helper (#13890) * cleanup: switch drvfs.cpp to use common MountUtil helper * adjust mount.drvfs error logging * adjust mount.drvfs error logging --------- Co-authored-by: Ben Hillis <benhill@ntdev.microsoft.com> --------- Co-authored-by: Ben Hillis <benhill@ntdev.microsoft.com> Co-authored-by: Blue <OneBlue@users.noreply.github.com> Co-authored-by: WSL localization <noreply@microsoft.com> Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
This change resolves an issue with writing the .wslconfig file where entries may be written without the correct header preceding them, causing the setting to fail to parse.
Resolves #12671