CHANGELOG.md

Changelog

The format is based on Keep a Changelog.

Prerelease - Unreleased

v0.13.0 - 2026-03-06

Fixed

• fix(windows): prevent WHvDeletePartition race by @ludfjig in hyperlight-dev#1101
• Fix guest tracing filter by @dblnz in hyperlight-dev#977
• Add crashdump example and include snapshot/scratch in core dumps by @jsturtevant in hyperlight-dev#1264

Changed

• Make mem::exe::LoadInfo a struct, instead of an alias by @simongdavies in hyperlight-dev#1099
• Update snapshots by @simongdavies in hyperlight-dev#1098
• Breaking: GuestFunctionDefinition::new now takes a typed function pointer instead of usize by @ludfjig in hyperlight-dev#1241

Added

• Enable CoW by @syntactically in hyperlight-dev#1229

Removed

• Remove host function definition regions by @syntactically in hyperlight-dev#1178

v0.12.0 - 2025-12-09

Fixed

• Fix guest tracing deadlock when exception happens during tracing data serialization by @dblnz in hyperlight-dev#1066
• Fix StackOverflow produced by guest logging by @dblnz in hyperlight-dev#1067
• Fix guest call to halt not dropping allocated trace data leading to memory leak by @dblnz in hyperlight-dev#1072
• Update the interrupt handler for 16byte alignment by @jsturtevant in hyperlight-dev#1037

Added

• Guest function improvements and macros by @jprendes in hyperlight-dev#851
• Add metric for erroneous vCPU kicks from stale cancellations by @Copilot in hyperlight-dev#1034

Removed

• Remove outdated is_supported_platform (use is_hypervisor_present instead) and unused ExtraAllowedSyscall by @ludfjig in hyperlight-dev#1062

v0.11.0 - 2025-11-04

Fixed

• Fixes a race condition in killing Sandboxes by @simongdavies in hyperlight-dev#959

Changed

• Unify register representation across hypervisors by @ludfjig in hyperlight-dev#907
• Guest tracing improvements to use tracing crate by @dblnz in hyperlight-dev#844
• Serialize guest trace data using flatbuffers by @dblnz in hyperlight-dev#999

Added

• Add support for mmapped memory in crashdumps and guest debugging by @dblnz in hyperlight-dev#943
• Add poison state to sandbox by @ludfjig in hyperlight-dev#931
• Crashdump on demand by @simongdavies in hyperlight-dev#972

Removed

• Remove seccomp by @dblnz in hyperlight-dev#971
• Remove mshv2 feature by @dblnz in hyperlight-dev#973

v0.10.0 - 2025-10-02

Fixed

• Fix error code conversion for Exception enum TryFrom implementation by @vshailesh in hyperlight-dev#869
• Remove Allocations from Panic Handler by @adamperlin in hyperlight-dev#818

Changed

• Update rust to 1.89 by @simongdavies in hyperlight-dev#883
• Update mshv crates for Azure Linux to v0.6.1 (from v0.3.2) by @simongdavies in hyperlight-dev#891
• Only clear io buffer after unsuccessful guest call by @ludfjig in hyperlight-dev#811

v0.9.0 - 2025-08-28

Fixed

• fix release blocker so it only blocks on release branches by @simongdavies in hyperlight-dev#777
• Enforce release builds for benchmarks and simplify command interface by @Copilot in hyperlight-dev#741
• fix(guest-bin): align user memory allocations by @andreiltd in hyperlight-dev#753
• Fix unbounded growth of panic hook after each new sandbox by @ludfjig in hyperlight-dev#827
• Update the like-ci recipe by @simongdavies in hyperlight-dev#837
• Fixes to Host Call Fuzzing by @adamperlin in hyperlight-dev#840

Changed

• Optimize function call serializing by @ludfjig in hyperlight-dev#778
• Make the component macros support passing host resources to guests by @syntactically in hyperlight-dev#839
• Build c guests as required by benchmarks by @ludfjig in hyperlight-dev#822

Removed

• Remove DbgMemAccessHandlerCaller trait and DbgMemAccessHandlerWrapper abstractions by @Copilot in hyperlight-dev#824

v0.8.0 - 2025-08-08

⚠️ hyperlight_component_macro::host_bindgen and hyperlight_component_macro::guest_bindgen used the Callable trait which no longer restores state after each function call and requires an explicit Snapshot Restore using the newly exposed Snapshot API. See hyperlight-dev#697 and hyperlight-dev#761

Fixed

• gdb: fix issue "Debug not enabled" when gdb feature was enabled by @dblnz in hyperlight-dev#678
• Fix Windows build with --no-default-features by @danbugs in hyperlight-dev#712
• fix(guest-bin): move logger initialization by @andreiltd in hyperlight-dev#755
• Fix mem mgr not initialized by @dblnz in hyperlight-dev#745

Changed

• Remove some dev-dependencies and cargo features to speed up compilation by @ludfjig in hyperlight-dev#535
• Introduce a separate KVM error variant of HyperlightError. by @ludfjig in https://github.com/hyperlight-dev/hyperlight/pull/771API. by @jprendes in hyperlight-dev#697
• Evolving and Devolving apis replaced by Snapshot API
  • Remove sandbox evolving and devolving and replace it with snapshotting API. by @jprendes in hyperlight-dev#697
  • Bring back the previous behavior of call_guest_function_by_name by @jprendes in hyperlight-dev#761

Added

• Memory Mapping Support
  • Support mapping host memory into the guest by @syntactically in hyperlight-dev#696
  • Make MultiUseSandbox::map_file_cow public by @ludfjig in hyperlight-dev#725
  • Add memory mapping support with KVM by @jprendes in hyperlight-dev#709
  • Make sure mmapped memory is not mapped writeable into sandbox in kvm by @ludfjig in hyperlight-dev#740
  • Make snapshots region aware by @ludfjig in hyperlight-dev#742
  • Restrict restoring sandboxes to snapshot taken on self by @ludfjig in hyperlight-dev#746
• Enable guest tracing by @dblnz in hyperlight-dev#695

Removed

• Removed the OutBHandler and MemAccessHandler abstractions and related implementations. by @simongdavies in hyperlight-dev#732

v0.7.0 - 2025-06-26

Fixed

• gdb: fix sandbox function cancellation when gdb enabled by @dblnz in hyperlight-dev#621
• Let windows decide at which address to map shared memory in surrogate process by @ludfjig in hyperlight-dev#637
• Don't log expected error on each guest function call by @ludfjig in hyperlight-dev#662
• Adds a missing clippy allow by @jsturtevant in hyperlight-dev#663

Changed

• improve the performance of building page tables by @simongdavies in hyperlight-dev#635
• Make interrupt retry delay methods Linux-only by @copilot-swe-agent in hyperlight-dev#647

Added

• Support ELF core dump creation on guest crash by @dblnz in hyperlight-dev#417
• Added capability to load extra blob data in sandbox by @danbugs in hyperlight-dev#605
• Add license scan report and status by @fossabot in hyperlight-dev#598
• Create GOVERNANCE.md by @benazirk in hyperlight-dev#556
• [host] adds init-paging feature by @danbugs in hyperlight-dev#639
• Enable guest debugging for HyperV on windows by @dblnz in hyperlight-dev#478

Removed

• Remove support for building PE files from hyperlight-guest-bin build.rs by @simongdavies in hyperlight-dev#572

v0.6.1 - 2025-06-12

Fixed

• Make OS_PAGE_SIZE public again by @jprendes in hyperlight-dev#609
• Bring back HostFunctionDefinitions Region by @danbugs in hyperlight-dev#600
• Allow hyperlight-host to build with x86_64-unknown-linux-musl target by @simongdavies in hyperlight-dev#601

v0.6.0 - 2025-06-06

Fixed

• Prevent openat from trapping on seccomp thread, by making it return EACCES instead by @ludfjig in hyperlight-dev#573

Changed

• Remove hypervisor_handler thread by @ludfjig in hyperlight-dev#533
• Make GuestBinary::Buffer variant take slice instead of owned vec by @ludfjig in hyperlight-dev#559

Added

• Add component bindgen macros by @syntactically in hyperlight-dev#376
• Adding ws2025 to the dep_rest matrix by @marosset in hyperlight-dev#551

v0.5.1 - 2025-06-02

Fixed

• Fixed an issue with the hyperlight_host not building on v0.5.0

v0.5.0 - 2025-05-28

Changed

• Change base address from 0x200_000 to 0x0 by @danbugs in hyperlight-dev#450
• Unify HostFunctionXX traits into a single HostFunction by @jprendes in https://github.com/hyperlight-dev/hyperlight/pull/
• Improve the ergonomics of registering host functions by @jprendes in hyperlight-dev#468
• Remove generics from SupportedParameterType and SupportedReturnType traits by @jprendes in hyperlight-dev#475
• Improve ergonomics of SupportedParameterType and SupportedReturnType by @jprendes in hyperlight-dev#476

Fixed

• Add error logging when MapViewOfFileNuma2 fails by @ludfjig in hyperlight-dev#460
• Make common and guest libs portable by @danbugs in hyperlight-dev#524
• Fix breaking changes for hyperlight js by @simongdavies in hyperlight-dev#531

Added

• Gdb debug improvements by @dblnz in hyperlight-dev#456

Removed

• Remove kernel stack and boot stack memory regions by @danbugs in hyperlight-dev#451
• Removing HostFunctionDefinitions region by @danbugs in hyperlight-dev#453
• Removed host error region by @danbugs in hyperlight-dev#457
• Remove dependency on the paste crate by @jprendes in hyperlight-dev#467
• Remove support from hyperlight_host for PE formatted guests by @simongdavies in hyperlight-dev#485
• Remove in process mode from hyperlight-host by @simongdavies in hyperlight-dev#490
• Remove host_print_writer from the arguments to UninitializedSandbox::new by @jprendes in hyperlight-dev#487

v0.4.0 - 2025-04-30

Changed

• Metrics are now emitted using the metrics crate by @ludfjig in #361

Fixed

• Fixed race condition causing thread to incorrectly believe it finished executing by @ludfjig in #385
• Fixed incorrect logging levels in guest by @simongdavies in #410
• Fixed missing compiler flags for building c guests by @prydt in #421

v0.3.0 - 2025-03-27

Added

• Gdb support for mshv guests #327 by @dblnz in #327
• Add fuzzing targets for fuzzing guest and host call parameters and return value by @ludfjig in #259

Changed

• Make host-guest result API generic by @ludfjig in #259

Removed

Fixed

• Fixed devcontainer permission issues by @myadav in #326

v0.2.0 - 2025-02-25

Added

• Adds support for Azure Linux 3 by @simongdavies in #51
• Add GDB support by @dblnz in #111
• Document DCO by @devigned in #22
• Run CI on intel machines by @danbugs in #32
• Run spell checks on repo by @andreiltd in #58
• Add devcontainer config by @dblnz in #54
• Add exception handling to Hyperlight guest by @danbugs in #250
• Add community meeting info to our README.md by @marosset in #231

Changed

• Avoid eagerly doing unnecessary string formatting by @ludfjig in #73
• Use CreateFileMapping\MapViewOfFile and UnmapViewOfFile\CloseHandle instead of VirtualAllocEx and VirtualFreeEx on Windows by @simongdavies in #135
• Avoid requiring specific environment variables during testing by @ludfjig in #108

Removed

• Remove SingleUseSandbox by @ludfjig in #125
• Remove custom alloca by @ludfjig in #106

Fixed

• Fix issues with using CreateMapViewOfFile with inprocess feature by @simongdavies in #2340
• Reset guest memory when guest function fails by @ludfjig in #208
• Improve error when guest binary not found by @ludfjig in #55
• Ensure windows version is supported by @simongdavies in #110

v0.1.0 - 2024-11-24

The Initial Hyperlight Release 🎉