Previous page

Next page

Locate page in Contents

Print this page

prlctl debug-dump

Creates a virtual machine dump in ELF format and saves it to a file. The resulting dump file can be opened with the Linux crash utility or (with some limitations) with the GDB debugger. To convert the dump file to a Windows or OS X format, use the supplied prlcore2dmp utility.

Syntax

prlctl debug-dump ID|NAME [--name dump_file_name] [--path output_directory_path]

Parameters

Name

Description

ID|NAME

Source virtual machine ID or name.

--name

Destination dump file name. If not specified, the file is named guest_<date>_<time>.dmp

--path

Destination directory. If not specified, the dump file will be created in the directory containing the virtual machine.

Remarks

To create a dump, the virtual machine must be running or paused. Suspended virtual machines are not supported by this command.

The command returns 0 (zero) on success and a non-zero value on failure.

Examples

The following command creates the guest_2015-08-10-215443.dmp dump file in the virtual machine directory. The virtual machine is specified by ID.

prlctl debug-dump {a885d908-4938-4d84-91bd-6eac81174cc1}

The following command created the /tmp/crash_D1.dmp file. The virtual machine is specified by name.

prlctl debug-dump "Win_8" --name crash_D1.dmp --path /tmp

Links

prlcore2dmp

General Syntax