download_blocks


Description:

[ 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.

Parameters:

this

A GuestfsSession object

optargs

a GuestfsDownloadBlocks containing optional arguments

cancellable

A GCancellable object

Returns:

true on success, false on error