synology_apm_repo.sdk.units.device_disk_fs module

DiskFsSibling: the units/content/disk_fs/-backed “filesystem inside a disk image” axis next to a VM or PC/PS disk-image leaf.

The disk image is opened through the owning DeviceProvider’s own unit, so this class never needs to know whether it came from the VM path or a PC/PS VirtualDiskContentSource.

class synology_apm_repo.sdk.units.device_disk_fs.DiskFsSibling(provider)

Bases: object

One DeviceProvider’s disk-fs sibling axis: builds the “<name> (filesystem)” node next to a disk-image leaf, and lazily parses it via DiskFilesystem the first time someone navigates into it — never eagerly for every disk in a listing.

root_node(*, disk_key, source_node, name)

The “<name> (filesystem)” sibling next to the disk-image leaf source_node. No I/O.

async resolve(handle)

The disk’s parsed filesystem, cached per disk_key; None when none could be recognized or the disk’s data is absent.

diagnostic_node(node, disk_key)
async children(node, *, offset=0, limit=None)

Partitions under a sibling root, or a directory’s entries under an entry node; one diagnostic leaf when no filesystem was found.

async open_entry(node, handle)

Open a file entry as a restorable unit.

Raises:

NotFoundError – No filesystem was recognized on the disk.