[ Version ( since = "1.33.45" ) ]
public bool download_blocks (string device, int64 start, int64 stop, string filename, DownloadBlocks? optargs, Cancellable? cancellable = null) throws Error
download the given data units from the disk
Download the data units from start address to stop from the disk partition (eg. /dev/sda1) and save them as filename on the local machine.
The use of this API on sparse disk image formats such as QCOW, may result in large zero-filled files downloaded on the host.
The size of a data unit varies across filesystem implementations. On NTFS filesystems data units are referred as clusters while on ExtX ones they are referred as fragments.
If the optional unallocated flag is true (default is false), only the unallocated blocks will be extracted. This is useful
to detect hidden data or to retrieve deleted files which data units have not been overwritten yet.
This function depends on the feature "sleuthkit". See also feature_available.
| this |
A GuestfsSession object |
| optargs |
a GuestfsDownloadBlocks containing optional arguments |
| cancellable |
A GCancellable object |
|
true on success, false on error |