dissect.archive 1.9.dev4__tar.gz → 1.9.dev5__tar.gz

{dissect_archive-1.9.dev4 → dissect_archive-1.9.dev5}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: dissect.archive
-Version: 1.9.dev4
+Version: 1.9.dev5
 Summary: A Dissect module implementing parsers for various archive and backup formats
 Author-email: Dissect Team <dissect@fox-it.com>
 License-Expression: AGPL-3.0-or-later

{dissect_archive-1.9.dev4 → dissect_archive-1.9.dev5}/dissect/archive/tibx/__init__.py

@@ -5,6 +5,7 @@ from dissect.archive.tibx.exception import (
     Error,
     InvalidArchiveError,
     InvalidPasswordError,
+    TibxError,
     UnsupportedFormatError,
 )
 from dissect.archive.tibx.stream import TibxVolumeStream
@@ -17,6 +18,7 @@ __all__ = [
     "InvalidArchiveError",
     "InvalidPasswordError",
     "RecoveryPoint",
+    "TibxError",
     "TibxVolume",
     "TibxVolumeStream",
     "UnsupportedFormatError",

{dissect_archive-1.9.dev4 → dissect_archive-1.9.dev5}/dissect/archive/tibx/exception.py

@@ -2,22 +2,24 @@
 
 from __future__ import annotations
 
+from dissect.archive.exception import Error
 
-class Error(Exception):
+
+class TibxError(Error):
     """Base exception for TIBX parsing errors."""
 
 
-class InvalidArchiveError(Error):
+class InvalidArchiveError(TibxError):
     """The file is not a TIBX archive."""
 
 
-class CorruptArchiveError(Error):
+class CorruptArchiveError(TibxError):
     """The archive is a TIBX archive but its structure is damaged."""
 
 
-class UnsupportedFormatError(Error):
+class UnsupportedFormatError(TibxError):
     """The archive uses a TIBX feature this parser does not (yet) support."""
 
 
-class InvalidPasswordError(Error):
+class InvalidPasswordError(TibxError):
     """The archive is encrypted and the supplied password is missing or wrong."""

{dissect_archive-1.9.dev4 → dissect_archive-1.9.dev5}/dissect/archive/tools/backup.py

@@ -6,12 +6,12 @@ import sys
 from pathlib import Path
 from typing import TYPE_CHECKING
 
-from dissect.archive.c_vma import c_vma
-from dissect.archive.vbk import VBK
-from dissect.archive.vma import VMA, _iter_mask
+from dissect.archive.vbk.vbk import VBK
+from dissect.archive.vma.c_vma import c_vma
+from dissect.archive.vma.vma import VMA, _iter_mask
 
 if TYPE_CHECKING:
-    from dissect.archive.vbk import DirItem
+    from dissect.archive.vbk.vbk import DirItem
 
 try:
     from rich.logging import RichHandler

dissect_archive-1.9.dev5/dissect/archive/vbk/__init__.py

@@ -0,0 +1,16 @@
+from __future__ import annotations
+
+from dissect.archive.exception import Error, FileNotFoundError, IsADirectoryError, NotADirectoryError
+from dissect.archive.vbk.vbk import VBK, DirItem, MetaBlob, SnapshotSlot, VBKError
+
+__all__ = [
+    "VBK",
+    "DirItem",
+    "Error",
+    "FileNotFoundError",
+    "IsADirectoryError",
+    "MetaBlob",
+    "NotADirectoryError",
+    "SnapshotSlot",
+    "VBKError",
+]

dissect_archive-1.9.dev5/dissect/archive/vbk/c_vbk.pyi

@@ -0,0 +1,482 @@
+# Generated by cstruct-stubgen
+from typing import BinaryIO, Literal, TypeAlias, overload
+
+import dissect.cstruct as __cs__
+
+class _c_vbk(__cs__.cstruct):
+    PAGE_SIZE: Literal[4096] = ...
+    class StorageHeader(__cs__.Structure):
+        FormatVersion: _c_vbk.uint32
+        Initialized: _c_vbk.uint32
+        DigestTypeLength: _c_vbk.uint32
+        DigestType: __cs__.CharArray
+        SnapshotSlotFormat: _c_vbk.uint32
+        StandardBlockSize: _c_vbk.uint32
+        ClusterAlign: _c_vbk.uint8
+        Unk0: __cs__.CharArray
+        ExternalStorageId: __cs__.CharArray
+        @overload
+        def __init__(
+            self,
+            FormatVersion: _c_vbk.uint32 | None = ...,
+            Initialized: _c_vbk.uint32 | None = ...,
+            DigestTypeLength: _c_vbk.uint32 | None = ...,
+            DigestType: __cs__.CharArray | None = ...,
+            SnapshotSlotFormat: _c_vbk.uint32 | None = ...,
+            StandardBlockSize: _c_vbk.uint32 | None = ...,
+            ClusterAlign: _c_vbk.uint8 | None = ...,
+            Unk0: __cs__.CharArray | None = ...,
+            ExternalStorageId: __cs__.CharArray | None = ...,
+        ): ...
+        @overload
+        def __init__(self, fh: bytes | memoryview | bytearray | BinaryIO, /): ...
+
+    class SnapshotSlotHeader(__cs__.Structure):
+        CRC: _c_vbk.uint32
+        ContainsSnapshot: _c_vbk.uint32
+        @overload
+        def __init__(self, CRC: _c_vbk.uint32 | None = ..., ContainsSnapshot: _c_vbk.uint32 | None = ...): ...
+        @overload
+        def __init__(self, fh: bytes | memoryview | bytearray | BinaryIO, /): ...
+
+    class DirectoryRootRecord(__cs__.Structure):
+        RootPage: _c_vbk.int64
+        Count: _c_vbk.uint64
+        @overload
+        def __init__(self, RootPage: _c_vbk.int64 | None = ..., Count: _c_vbk.uint64 | None = ...): ...
+        @overload
+        def __init__(self, fh: bytes | memoryview | bytearray | BinaryIO, /): ...
+
+    class BlocksStoreHeader(__cs__.Structure):
+        RootPage: _c_vbk.int64
+        Count: _c_vbk.uint64
+        FreeRootPage: _c_vbk.int64
+        DeduplicationRootPage: _c_vbk.int64
+        Unk0: _c_vbk.int64
+        Unk1: _c_vbk.int64
+        @overload
+        def __init__(
+            self,
+            RootPage: _c_vbk.int64 | None = ...,
+            Count: _c_vbk.uint64 | None = ...,
+            FreeRootPage: _c_vbk.int64 | None = ...,
+            DeduplicationRootPage: _c_vbk.int64 | None = ...,
+            Unk0: _c_vbk.int64 | None = ...,
+            Unk1: _c_vbk.int64 | None = ...,
+        ): ...
+        @overload
+        def __init__(self, fh: bytes | memoryview | bytearray | BinaryIO, /): ...
+
+    class CryptoStoreRecord(__cs__.Structure):
+        RootPage: _c_vbk.int64
+        @overload
+        def __init__(self, RootPage: _c_vbk.int64 | None = ...): ...
+        @overload
+        def __init__(self, fh: bytes | memoryview | bytearray | BinaryIO, /): ...
+
+    class SnapshotDescriptor(__cs__.Structure):
+        Version: _c_vbk.uint64
+        StorageEOF: _c_vbk.uint64
+        BanksCount: _c_vbk.uint32
+        DirectoryRoot: _c_vbk.DirectoryRootRecord
+        BlocksStore: _c_vbk.BlocksStoreHeader
+        CryptoStore: _c_vbk.CryptoStoreRecord
+        Unk0: _c_vbk.uint64
+        Unk1: _c_vbk.uint64
+        @overload
+        def __init__(
+            self,
+            Version: _c_vbk.uint64 | None = ...,
+            StorageEOF: _c_vbk.uint64 | None = ...,
+            BanksCount: _c_vbk.uint32 | None = ...,
+            DirectoryRoot: _c_vbk.DirectoryRootRecord | None = ...,
+            BlocksStore: _c_vbk.BlocksStoreHeader | None = ...,
+            CryptoStore: _c_vbk.CryptoStoreRecord | None = ...,
+            Unk0: _c_vbk.uint64 | None = ...,
+            Unk1: _c_vbk.uint64 | None = ...,
+        ): ...
+        @overload
+        def __init__(self, fh: bytes | memoryview | bytearray | BinaryIO, /): ...
+
+    class BankDescriptor(__cs__.Structure):
+        CRC: _c_vbk.uint32
+        Offset: _c_vbk.uint64
+        Size: _c_vbk.uint32
+        @overload
+        def __init__(
+            self, CRC: _c_vbk.uint32 | None = ..., Offset: _c_vbk.uint64 | None = ..., Size: _c_vbk.uint32 | None = ...
+        ): ...
+        @overload
+        def __init__(self, fh: bytes | memoryview | bytearray | BinaryIO, /): ...
+
+    class BanksGrain(__cs__.Structure):
+        MaxBanks: _c_vbk.uint32
+        StoredBanks: _c_vbk.uint32
+        @overload
+        def __init__(self, MaxBanks: _c_vbk.uint32 | None = ..., StoredBanks: _c_vbk.uint32 | None = ...): ...
+        @overload
+        def __init__(self, fh: bytes | memoryview | bytearray | BinaryIO, /): ...
+
+    class BankHeader(__cs__.Structure):
+        PageCount: _c_vbk.uint16
+        Flags: _c_vbk.uint16
+        Unk0: __cs__.CharArray
+        Unk1: _c_vbk.uint64
+        Unk2: __cs__.CharArray
+        @overload
+        def __init__(
+            self,
+            PageCount: _c_vbk.uint16 | None = ...,
+            Flags: _c_vbk.uint16 | None = ...,
+            Unk0: __cs__.CharArray | None = ...,
+            Unk1: _c_vbk.uint64 | None = ...,
+            Unk2: __cs__.CharArray | None = ...,
+        ): ...
+        @overload
+        def __init__(self, fh: bytes | memoryview | bytearray | BinaryIO, /): ...
+
+    class BankHeaderV71(__cs__.Structure):
+        PageCount: _c_vbk.uint16
+        Flags: _c_vbk.uint16
+        Unk0: __cs__.CharArray
+        KeySetId: __cs__.CharArray
+        Unk1: __cs__.CharArray
+        Unk2: __cs__.CharArray
+        Unk3: _c_vbk.uint32
+        Unk4: __cs__.CharArray
+        @overload
+        def __init__(
+            self,
+            PageCount: _c_vbk.uint16 | None = ...,
+            Flags: _c_vbk.uint16 | None = ...,
+            Unk0: __cs__.CharArray | None = ...,
+            KeySetId: __cs__.CharArray | None = ...,
+            Unk1: __cs__.CharArray | None = ...,
+            Unk2: __cs__.CharArray | None = ...,
+            Unk3: _c_vbk.uint32 | None = ...,
+            Unk4: __cs__.CharArray | None = ...,
+        ): ...
+        @overload
+        def __init__(self, fh: bytes | memoryview | bytearray | BinaryIO, /): ...
+
+    class MetaBlobHeader(__cs__.Structure):
+        NextPage: _c_vbk.int64
+        Unk0: _c_vbk.int32
+        @overload
+        def __init__(self, NextPage: _c_vbk.int64 | None = ..., Unk0: _c_vbk.int32 | None = ...): ...
+        @overload
+        def __init__(self, fh: bytes | memoryview | bytearray | BinaryIO, /): ...
+
+    class Lz4BlockHeader(__cs__.Structure):
+        Magic: _c_vbk.uint32
+        CRC: _c_vbk.uint32
+        SourceSize: _c_vbk.uint32
+        @overload
+        def __init__(
+            self,
+            Magic: _c_vbk.uint32 | None = ...,
+            CRC: _c_vbk.uint32 | None = ...,
+            SourceSize: _c_vbk.uint32 | None = ...,
+        ): ...
+        @overload
+        def __init__(self, fh: bytes | memoryview | bytearray | BinaryIO, /): ...
+
+    class BlocksVectorHeader(__cs__.Structure):
+        RootPage: _c_vbk.uint64
+        Count: _c_vbk.uint64
+        @overload
+        def __init__(self, RootPage: _c_vbk.uint64 | None = ..., Count: _c_vbk.uint64 | None = ...): ...
+        @overload
+        def __init__(self, fh: bytes | memoryview | bytearray | BinaryIO, /): ...
+
+    class SubFolderHeader(__cs__.Structure):
+        RootPage: _c_vbk.uint64
+        Count: _c_vbk.uint32
+        Data: __cs__.CharArray
+        @overload
+        def __init__(
+            self,
+            RootPage: _c_vbk.uint64 | None = ...,
+            Count: _c_vbk.uint32 | None = ...,
+            Data: __cs__.CharArray | None = ...,
+        ): ...
+        @overload
+        def __init__(self, fh: bytes | memoryview | bytearray | BinaryIO, /): ...
+
+    class ExtFibHeader(__cs__.Structure):
+        UpdateInProgress: _c_vbk.uint16
+        Unk3: _c_vbk.uint8
+        Format: _c_vbk.uint8
+        BlocksVector: _c_vbk.BlocksVectorHeader
+        FibSize: _c_vbk.uint64
+        Size: _c_vbk.uint64
+        FsObjAttachState: _c_vbk.uint8
+        Data: __cs__.CharArray
+        @overload
+        def __init__(
+            self,
+            UpdateInProgress: _c_vbk.uint16 | None = ...,
+            Unk3: _c_vbk.uint8 | None = ...,
+            Format: _c_vbk.uint8 | None = ...,
+            BlocksVector: _c_vbk.BlocksVectorHeader | None = ...,
+            FibSize: _c_vbk.uint64 | None = ...,
+            Size: _c_vbk.uint64 | None = ...,
+            FsObjAttachState: _c_vbk.uint8 | None = ...,
+            Data: __cs__.CharArray | None = ...,
+        ): ...
+        @overload
+        def __init__(self, fh: bytes | memoryview | bytearray | BinaryIO, /): ...
+
+    class IntFibHeader(__cs__.Structure):
+        UpdateInProgress: _c_vbk.uint16
+        Unk3: _c_vbk.uint8
+        Format: _c_vbk.uint8
+        BlocksVector: _c_vbk.BlocksVectorHeader
+        FibSize: _c_vbk.uint64
+        Size: _c_vbk.uint64
+        FsObjAttachState: _c_vbk.uint8
+        Data: __cs__.CharArray
+        @overload
+        def __init__(
+            self,
+            UpdateInProgress: _c_vbk.uint16 | None = ...,
+            Unk3: _c_vbk.uint8 | None = ...,
+            Format: _c_vbk.uint8 | None = ...,
+            BlocksVector: _c_vbk.BlocksVectorHeader | None = ...,
+            FibSize: _c_vbk.uint64 | None = ...,
+            Size: _c_vbk.uint64 | None = ...,
+            FsObjAttachState: _c_vbk.uint8 | None = ...,
+            Data: __cs__.CharArray | None = ...,
+        ): ...
+        @overload
+        def __init__(self, fh: bytes | memoryview | bytearray | BinaryIO, /): ...
+
+    class PatchHeader(__cs__.Structure):
+        Unk0: _c_vbk.uint32
+        BlocksVector: _c_vbk.BlocksVectorHeader
+        FibSize: _c_vbk.uint64
+        Unk4: _c_vbk.uint64
+        Data: __cs__.CharArray
+        @overload
+        def __init__(
+            self,
+            Unk0: _c_vbk.uint32 | None = ...,
+            BlocksVector: _c_vbk.BlocksVectorHeader | None = ...,
+            FibSize: _c_vbk.uint64 | None = ...,
+            Unk4: _c_vbk.uint64 | None = ...,
+            Data: __cs__.CharArray | None = ...,
+        ): ...
+        @overload
+        def __init__(self, fh: bytes | memoryview | bytearray | BinaryIO, /): ...
+
+    class IncrementHeader(__cs__.Structure):
+        Unk0: _c_vbk.uint32
+        BlocksVector: _c_vbk.BlocksVectorHeader
+        FibSize: _c_vbk.uint64
+        Unk4: _c_vbk.uint64
+        Data: __cs__.CharArray
+        @overload
+        def __init__(
+            self,
+            Unk0: _c_vbk.uint32 | None = ...,
+            BlocksVector: _c_vbk.BlocksVectorHeader | None = ...,
+            FibSize: _c_vbk.uint64 | None = ...,
+            Unk4: _c_vbk.uint64 | None = ...,
+            Data: __cs__.CharArray | None = ...,
+        ): ...
+        @overload
+        def __init__(self, fh: bytes | memoryview | bytearray | BinaryIO, /): ...
+
+    class DirItemType(__cs__.Enum):
+        # None = ...
+        SubFolder = ...
+        ExtFib = ...
+        IntFib = ...
+        Patch = ...
+        Increment = ...
+
+    class DirItemRecord(__cs__.Structure):
+        Type: _c_vbk.DirItemType
+        NameLength: _c_vbk.uint32
+        Name: __cs__.CharArray
+        PropsRootPage: _c_vbk.int64
+        Unk1: _c_vbk.uint32
+        Data: __cs__.CharArray
+        SubFolder: _c_vbk.SubFolderHeader
+        ExtFib: _c_vbk.ExtFibHeader
+        IntFib: _c_vbk.IntFibHeader
+        Patch: _c_vbk.PatchHeader
+        Increment: _c_vbk.IncrementHeader
+        @overload
+        def __init__(
+            self,
+            Type: _c_vbk.DirItemType | None = ...,
+            NameLength: _c_vbk.uint32 | None = ...,
+            Name: __cs__.CharArray | None = ...,
+            PropsRootPage: _c_vbk.int64 | None = ...,
+            Unk1: _c_vbk.uint32 | None = ...,
+            Data: __cs__.CharArray | None = ...,
+            SubFolder: _c_vbk.SubFolderHeader | None = ...,
+            ExtFib: _c_vbk.ExtFibHeader | None = ...,
+            IntFib: _c_vbk.IntFibHeader | None = ...,
+            Patch: _c_vbk.PatchHeader | None = ...,
+            Increment: _c_vbk.IncrementHeader | None = ...,
+        ): ...
+        @overload
+        def __init__(self, fh: bytes | memoryview | bytearray | BinaryIO, /): ...
+
+    class BlockFlags(__cs__.Flag):
+        # None = ...
+        Updated = ...
+        CommitInProgress = ...
+
+    class BlockLocationType(__cs__.Enum):
+        Normal = ...
+        Sparse = ...
+        Reserved = ...
+        Archived = ...
+        BlockInBlob = ...
+        BlockInBlobReserved = ...
+
+    class CompressionType(__cs__.Enum):
+        Plain = ...
+        RL = ...
+        ZLH = ...
+        ZLL = ...
+        LZ4 = ...
+
+    class MetaTableDescriptor(__cs__.Structure):
+        RootPage: _c_vbk.int64
+        BlockSize: _c_vbk.uint64
+        Count: _c_vbk.uint64
+        @overload
+        def __init__(
+            self,
+            RootPage: _c_vbk.int64 | None = ...,
+            BlockSize: _c_vbk.uint64 | None = ...,
+            Count: _c_vbk.uint64 | None = ...,
+        ): ...
+        @overload
+        def __init__(self, fh: bytes | memoryview | bytearray | BinaryIO, /): ...
+
+    class StgBlockDescriptor(__cs__.Structure):
+        Format: _c_vbk.uint8
+        UsageCounter: _c_vbk.uint32
+        Offset: _c_vbk.uint64
+        AllocatedSize: _c_vbk.uint32
+        Deduplication: _c_vbk.uint8
+        Digest: __cs__.CharArray
+        CompressionType: _c_vbk.CompressionType
+        Unk0: _c_vbk.uint8
+        CompressedSize: _c_vbk.uint32
+        SourceSize: _c_vbk.uint32
+        @overload
+        def __init__(
+            self,
+            Format: _c_vbk.uint8 | None = ...,
+            UsageCounter: _c_vbk.uint32 | None = ...,
+            Offset: _c_vbk.uint64 | None = ...,
+            AllocatedSize: _c_vbk.uint32 | None = ...,
+            Deduplication: _c_vbk.uint8 | None = ...,
+            Digest: __cs__.CharArray | None = ...,
+            CompressionType: _c_vbk.CompressionType | None = ...,
+            Unk0: _c_vbk.uint8 | None = ...,
+            CompressedSize: _c_vbk.uint32 | None = ...,
+            SourceSize: _c_vbk.uint32 | None = ...,
+        ): ...
+        @overload
+        def __init__(self, fh: bytes | memoryview | bytearray | BinaryIO, /): ...
+
+    class StgBlockDescriptorV7(__cs__.Structure):
+        Format: _c_vbk.uint8
+        UsageCounter: _c_vbk.uint32
+        Offset: _c_vbk.uint64
+        AllocatedSize: _c_vbk.uint32
+        Deduplication: _c_vbk.uint8
+        Digest: __cs__.CharArray
+        CompressionType: _c_vbk.CompressionType
+        Unk0: _c_vbk.uint8
+        CompressedSize: _c_vbk.uint32
+        SourceSize: _c_vbk.uint32
+        KeySetId: __cs__.CharArray
+        @overload
+        def __init__(
+            self,
+            Format: _c_vbk.uint8 | None = ...,
+            UsageCounter: _c_vbk.uint32 | None = ...,
+            Offset: _c_vbk.uint64 | None = ...,
+            AllocatedSize: _c_vbk.uint32 | None = ...,
+            Deduplication: _c_vbk.uint8 | None = ...,
+            Digest: __cs__.CharArray | None = ...,
+            CompressionType: _c_vbk.CompressionType | None = ...,
+            Unk0: _c_vbk.uint8 | None = ...,
+            CompressedSize: _c_vbk.uint32 | None = ...,
+            SourceSize: _c_vbk.uint32 | None = ...,
+            KeySetId: __cs__.CharArray | None = ...,
+        ): ...
+        @overload
+        def __init__(self, fh: bytes | memoryview | bytearray | BinaryIO, /): ...
+
+    class FibBlockDescriptor(__cs__.Structure):
+        BlockSize: _c_vbk.uint32
+        Type: _c_vbk.BlockLocationType
+        Digest: __cs__.CharArray
+        BlockId: _c_vbk.uint64
+        Flags: _c_vbk.BlockFlags
+        @overload
+        def __init__(
+            self,
+            BlockSize: _c_vbk.uint32 | None = ...,
+            Type: _c_vbk.BlockLocationType | None = ...,
+            Digest: __cs__.CharArray | None = ...,
+            BlockId: _c_vbk.uint64 | None = ...,
+            Flags: _c_vbk.BlockFlags | None = ...,
+        ): ...
+        @overload
+        def __init__(self, fh: bytes | memoryview | bytearray | BinaryIO, /): ...
+
+    class FibBlockDescriptorV7(__cs__.Structure):
+        BlockSize: _c_vbk.uint32
+        Type: _c_vbk.BlockLocationType
+        Digest: __cs__.CharArray
+        BlockId: _c_vbk.uint64
+        Flags: _c_vbk.BlockFlags
+        KeySetId: __cs__.CharArray
+        @overload
+        def __init__(
+            self,
+            BlockSize: _c_vbk.uint32 | None = ...,
+            Type: _c_vbk.BlockLocationType | None = ...,
+            Digest: __cs__.CharArray | None = ...,
+            BlockId: _c_vbk.uint64 | None = ...,
+            Flags: _c_vbk.BlockFlags | None = ...,
+            KeySetId: __cs__.CharArray | None = ...,
+        ): ...
+        @overload
+        def __init__(self, fh: bytes | memoryview | bytearray | BinaryIO, /): ...
+
+    class PatchBlockDescriptor(__cs__.Structure):
+        @overload
+        def __init__(self): ...
+        @overload
+        def __init__(self, fh: bytes | memoryview | bytearray | BinaryIO, /): ...
+
+    class PatchBlockDescriptorV7(__cs__.Structure):
+        @overload
+        def __init__(self): ...
+        @overload
+        def __init__(self, fh: bytes | memoryview | bytearray | BinaryIO, /): ...
+
+    class PropertyType(__cs__.Enum):
+        UInt32 = ...
+        UInt64 = ...
+        AString = ...
+        WString = ...
+        Binary = ...
+        Boolean = ...
+        End = ...
+
+# Technically `c_vbk` is an instance of `_c_vbk`, but then we can't use it in type hints
+c_vbk: TypeAlias = _c_vbk
+
+PAGE_SIZE = c_vbk.PAGE_SIZE

{dissect_archive-1.9.dev4/dissect/archive → dissect_archive-1.9.dev5/dissect/archive/vbk}/vbk.py

@@ -13,8 +13,8 @@ from dissect.util.hash.crc32c import crc32c
 from dissect.util.stream import AlignedStream
 from dissect.util.xmemoryview import xmemoryview
 
-from dissect.archive.c_vbk import PAGE_SIZE, c_vbk
-from dissect.archive.exceptions import Error, FileNotFoundError, IsADirectoryError, NotADirectoryError
+from dissect.archive.exception import Error, FileNotFoundError, IsADirectoryError, NotADirectoryError
+from dissect.archive.vbk.c_vbk import PAGE_SIZE, c_vbk
 
 if TYPE_CHECKING:
     from collections.abc import Iterator

dissect_archive-1.9.dev5/dissect/archive/vma/__init__.py

@@ -0,0 +1,9 @@
+from __future__ import annotations
+
+from dissect.archive.vma.vma import VMA, Device, Extent
+
+__all__ = [
+    "VMA",
+    "Device",
+    "Extent",
+]

dissect_archive-1.9.dev5/dissect/archive/vma/c_vma.pyi

@@ -0,0 +1,91 @@
+# Generated by cstruct-stubgen
+from typing import BinaryIO, Literal, TypeAlias, overload
+
+import dissect.cstruct as __cs__
+
+class _c_vma(__cs__.cstruct):
+    VMA_BLOCK_BITS: Literal[12] = ...
+    VMA_BLOCK_SIZE: Literal[4096] = ...
+    VMA_CLUSTER_BITS: Literal[16] = ...
+    VMA_CLUSTER_SIZE: Literal[65536] = ...
+    VMA_EXTENT_HEADER_SIZE: Literal[512] = ...
+    VMA_BLOCKS_PER_EXTENT: Literal[59] = ...
+    VMA_MAX_CONFIGS: Literal[256] = ...
+    VMA_MAX_EXTENT_SIZE: Literal[3867136] = ...
+    class VmaDeviceInfoHeader(__cs__.Structure):
+        devname_ptr: _c_vma.uint32
+        reserved0: _c_vma.uint32
+        size: _c_vma.uint64
+        reserved1: _c_vma.uint64
+        reserved2: _c_vma.uint64
+        @overload
+        def __init__(
+            self,
+            devname_ptr: _c_vma.uint32 | None = ...,
+            reserved0: _c_vma.uint32 | None = ...,
+            size: _c_vma.uint64 | None = ...,
+            reserved1: _c_vma.uint64 | None = ...,
+            reserved2: _c_vma.uint64 | None = ...,
+        ): ...
+        @overload
+        def __init__(self, fh: bytes | memoryview | bytearray | BinaryIO, /): ...
+
+    class VmaHeader(__cs__.Structure):
+        magic: __cs__.CharArray
+        version: _c_vma.uint32
+        uuid: __cs__.CharArray
+        ctime: _c_vma.int64
+        md5sum: __cs__.CharArray
+        blob_buffer_offset: _c_vma.uint32
+        blob_buffer_size: _c_vma.uint32
+        header_size: _c_vma.uint32
+        _reserved1: __cs__.CharArray
+        config_names: __cs__.Array[_c_vma.uint32]
+        config_data: __cs__.Array[_c_vma.uint32]
+        _reserved2: __cs__.CharArray
+        dev_info: __cs__.Array[_c_vma.VmaDeviceInfoHeader]
+        @overload
+        def __init__(
+            self,
+            magic: __cs__.CharArray | None = ...,
+            version: _c_vma.uint32 | None = ...,
+            uuid: __cs__.CharArray | None = ...,
+            ctime: _c_vma.int64 | None = ...,
+            md5sum: __cs__.CharArray | None = ...,
+            blob_buffer_offset: _c_vma.uint32 | None = ...,
+            blob_buffer_size: _c_vma.uint32 | None = ...,
+            header_size: _c_vma.uint32 | None = ...,
+            _reserved1: __cs__.CharArray | None = ...,
+            config_names: __cs__.Array[_c_vma.uint32] | None = ...,
+            config_data: __cs__.Array[_c_vma.uint32] | None = ...,
+            _reserved2: __cs__.CharArray | None = ...,
+            dev_info: __cs__.Array[_c_vma.VmaDeviceInfoHeader] | None = ...,
+        ): ...
+        @overload
+        def __init__(self, fh: bytes | memoryview | bytearray | BinaryIO, /): ...
+
+    class VmaExtentHeader(__cs__.Structure):
+        magic: __cs__.CharArray
+        reserved1: _c_vma.uint16
+        block_count: _c_vma.uint16
+        uuid: __cs__.CharArray
+        md5sum: __cs__.CharArray
+        blockinfo: __cs__.Array[_c_vma.uint64]
+        @overload
+        def __init__(
+            self,
+            magic: __cs__.CharArray | None = ...,
+            reserved1: _c_vma.uint16 | None = ...,
+            block_count: _c_vma.uint16 | None = ...,
+            uuid: __cs__.CharArray | None = ...,
+            md5sum: __cs__.CharArray | None = ...,
+            blockinfo: __cs__.Array[_c_vma.uint64] | None = ...,
+        ): ...
+        @overload
+        def __init__(self, fh: bytes | memoryview | bytearray | BinaryIO, /): ...
+
+# Technically `c_vma` is an instance of `_c_vma`, but then we can't use it in type hints
+c_vma: TypeAlias = _c_vma
+
+VMA_MAGIC: Literal[b"VMA\x00"] = ...
+VMA_EXTENT_MAGIC: Literal[b"VMAE"] = ...

{dissect_archive-1.9.dev4/dissect/archive → dissect_archive-1.9.dev5/dissect/archive/vma}/vma.py

@@ -13,8 +13,8 @@ from uuid import UUID
 from dissect.util import ts
 from dissect.util.stream import AlignedStream
 
-from dissect.archive.c_vma import VMA_EXTENT_MAGIC, VMA_MAGIC, c_vma
-from dissect.archive.exceptions import InvalidHeaderError
+from dissect.archive.exception import InvalidHeaderError
+from dissect.archive.vma.c_vma import VMA_EXTENT_MAGIC, VMA_MAGIC, c_vma
 
 if TYPE_CHECKING:
     from collections.abc import Iterator