Skip to content

File

Retrieve files from the debuggee's filesystem. Useful when debugging a remote process over SSH or similar, where e.g. /proc/FOO/maps is needed from the remote system.

get(path)

Retrieves the contents of the specified file on the system where the current process is being debugged.

Returns:

Type Description
bytes

A byte array, or None.

get_file(path, try_local_path=False)

Downloads the specified file from the system where the current process is being debugged.

If the path is prefixed with "target:" the prefix is stripped (to support remote target paths properly).

If the try_local_path is set to True and the path exists locally and "target:" prefix is not present, it will return the local path instead of downloading the file.

Returns:

Type Description
str

The local path to the file

get_proc_exe_file()

Returns the local path to the debugged file name.

readlink(path) -> str

Read the link specified by 'path' on the system being debugged.

Handles local, qemu-usermode, and remote debugging cases.

remote_files_dir()

reset_remote_files()