Skip to content
  • Jeff Cody's avatar
    block: vhdx - log parsing, replay, and flush support · 0a43a1b5
    Jeff Cody authored
    This adds support for VHDX v0 logs, as specified in Microsoft's
    VHDX Specification Format v1.00:
    https://www.microsoft.com/en-us/download/details.aspx?id=34750
    
    
    
    The following support is added:
    
    * Log parsing, and validation - validate that an existing log
      is correct.
    
    * Log search - search through an existing log, to find any valid
      sequence of entries.
    
    * Log replay and flush - replay an existing log, and flush/clear
      the log when complete.
    
    The VHDX log is a circular buffer, with elements (sectors) of 4KB.
    
    A log entry is a variably-length number of sectors, that is
    comprised of a header and 'descriptors', that describe each sector.
    
    A log may contain multiple entries, know as a log sequence.  In a log
    sequence, each log entry immediately follows the previous entry, with an
    incrementing sequence number.  There can only ever be one active and
    valid sequence in the log.
    
    Each log entry must match the file log GUID in order to be valid (along
    with other criteria).  Once we have flushed all valid log entries, we
    marked the file log GUID to be zero, which indicates a buffer with no
    valid entries.
    
    Signed-off-by: default avatarJeff Cody <jcody@redhat.com>
    Signed-off-by: default avatarStefan Hajnoczi <stefanha@redhat.com>
    0a43a1b5