Crate vmgs

Implementation of the VMGS file format.

Implementation Notes

This particular implementation of the VMGS file format began life as a line-by-line port of the existing C++ VMGS code in Hyper-V. This kind of rote-porting was fairly common in the early days of the HvLite project (when folks were still getting a feel for Rust), though as time has gone on, most instances of rote-ported code have been refactored/rewritten to follow idiomatic Rust patterns.

Unfortunately, the VMGS code is pretty complex, and giving it a proper “deep clean” would require a non-trivial amount of developer effort, which as is often the case - not particularly easy to come by.

Sure, there’s been lots of incremental improvements to the code over the years, and the implementation is in much better shape today than it was in its early days… but the code still has plenty of echoes from that initial C++ port, which really ought to get ironed out.

Modules

• save_restore
• vmgs_helpers
  VMGS helper functions

Structs

• EncryptionAlgorithm
  Encryption algorithm used to encrypt VMGS file
• FileId
  VMGS fixed file IDs
• Vmgs
  Implementation of the VMGS file format, backed by a generic Disk device.
• VmgsFileInfo
  Info about a specific VMGS file.

Enums

• Error
  VMGS errors.