Summary

This PR enhances error diagnostics in bundle extraction to provide actionable information when I/O failures occur during file extraction. Previously, the code only checked if the extracted size didn't match the expected size and emitted generic error messages. Now, it provides detailed diagnostics to help troubleshoot disk full, quota exceeded, permission denied, or hardware errors.

Changes

Enhanced error handling in src/native/corehost/bundle/extractor.cpp:

1. Added errno checking: Included <cerrno> to enable system error code inspection

2. Enhanced fwrite error handling for both compressed and non-compressed extraction paths:

   • Always report errno and strerror(errno) when fwrite fails
   • Report expected vs actual byte counts for write failures
   • Ensures file is closed before throwing exception

Example Error Messages

Before

Failure extracting contents of the application bundle. Expected size:1048576 Actual size:524288
I/O failure when writing extracted files.

After - Disk Full

Failure extracting contents of the application bundle. Expected size:1048576 Actual size:524288
I/O failure when writing extracted files. errno: 28, No space left on device

After - Permission Denied

Failure extracting contents of the application bundle. Expected size:1048576 Actual size:0
I/O failure when writing extracted files. errno: 13, Permission denied

After - Compressed File Write Failure

I/O failure when writing decompressed file.
Expected: 4096 bytes, Written: 2048 bytes, errno: 28, No space left on device

Benefits

• Actionable diagnostics: Provides specific error codes (ENOSPC, EDQUOT, EACCES, EIO) that indicate the root cause
• Better supportability: Users and support teams can quickly identify whether the issue is disk space, permissions, quotas, or hardware
• Simpler implementation: Direct errno reporting without conditional checks

Testing

• ✅ Built successfully: ./build.sh clr+libs+host -rc release
• ✅ All host tests passed: ./build.sh host.tests -rc release -test
  • AppHost.Bundle.Tests
  • HostActivation.Tests
  • Microsoft.NET.HostModel.Tests

Fixes #

This pull request was created as a result of the following prompt from Copilot chat.

Enhance error diagnostics in bundle extraction when fwrite fails in src/native/corehost/bundle/extractor.cpp. Currently, the code only checks if extracted_size != cast_size and emits a generic error. Instead, we should:

• Check ferror(file) and report errno and strerror(errno) for specific I/O errors.
• Report short writes distinctly from I/O errors.
• Check fclose(file) for flush errors and report errno and strerror(errno) if it fails.
• Emit more detailed trace output to help diagnose disk full, quota, permission, or hardware errors.

This change will improve supportability and troubleshooting for bundle extraction failures by providing actionable error diagnostics.

💬 Share your feedback on Copilot coding agent for the chance to win a $200 gift card! Click here to start the survey.