Skip to content

pymobiledevice3 crash

Manage crash reports

clear

clear(/remove) all crash reports inside the remote_file argument

pymobiledevice3 crash clear [OPTIONS] [remote_file]

Arguments:

Argument Description
remote_file Path to clear [default: /]

Options:

Option Description
-f, --flush flush before clear

Accepts the connection options: --rsd, --tunnel, --userspace, --mobdev2, --usbmux, --udid.

parse

Parse a crash report file

pymobiledevice3 crash parse [OPTIONS] {remote_file}

Arguments:

Argument Description
remote_file [required]

Accepts the connection options: --rsd, --tunnel, --userspace, --mobdev2, --usbmux, --udid.

parse-latest

Parse latest top-level crash report(s) under a path, ordered by newest first

pymobiledevice3 crash parse-latest [OPTIONS] [remote_file]

Arguments:

Argument Description
remote_file Path whose top-level reports should be searched [default: /]

Options:

Option Description
-m, --match <str> Case-sensitive basename regex filter (repeatable; all must match - conjunction)
-mi, --match-insensitive <str> Case-insensitive basename regex filter (repeatable; all must match - conjunction)
-n, --count <int range> Maximum number of latest reports to parse [default: 1; x>=1]

Accepts the connection options: --rsd, --tunnel, --userspace, --mobdev2, --usbmux, --udid.

pull

pull all crash reports

pymobiledevice3 crash pull [OPTIONS] {out}

Arguments:

Argument Description
out [required]

Options:

Option Description
--remote-file <str> [default: /]
-e, --erase
-m, --match <str> Match given regex over enumerated basenames

Accepts the connection options: --rsd, --tunnel, --userspace, --mobdev2, --usbmux, --udid.

shell

start an afc shell

pymobiledevice3 crash shell [OPTIONS]

Accepts the connection options: --rsd, --tunnel, --userspace, --mobdev2, --usbmux, --udid.

webdav

Serve the crash reports directory over WebDAV for local mounting.

pymobiledevice3 crash webdav [OPTIONS] [path]

Arguments:

Argument Description
path AFC path to serve as the volume root (default: /) [default: /]

Options:

Option Description
--mount mount the served path locally and reveal it in your file manager
--host <str> local interface to bind [default: 127.0.0.1]
--bind-port <int> local TCP port (0 picks a free port) [default: 0]
--readonly expose the path read-only

Accepts the connection options: --rsd, --tunnel, --userspace, --mobdev2, --usbmux, --udid.

ls

List

pymobiledevice3 crash ls [OPTIONS]

Options:

Option Description
--remote-file <str> [default: /]
-d, --depth <int> [default: 1]

Accepts the connection options: --rsd, --tunnel, --userspace, --mobdev2, --usbmux, --udid.

flush

trigger com.apple.crashreportmover to flush all products into CrashReports directory

pymobiledevice3 crash flush [OPTIONS]

Accepts the connection options: --rsd, --tunnel, --userspace, --mobdev2, --usbmux, --udid.

watch

watch for crash report generation

pymobiledevice3 crash watch [OPTIONS]

Options:

Option Description
--name <str>
-r, --raw
--format <text\|json> Output format. 'json' emits one JSON object per line (NDJSON) on stdout. [default: text]

Accepts the connection options: --rsd, --tunnel, --userspace, --mobdev2, --usbmux, --udid.

sysdiagnose

get a sysdiagnose archive from device (requires user interaction)

pymobiledevice3 crash sysdiagnose [OPTIONS] {out}

Arguments:

Argument Description
out [required]

Options:

Option Description
-e, --erase erase file after pulling
-t, --timeout <float> Maximum time in seconds to wait for the completion of sysdiagnose archive

Accepts the connection options: --rsd, --tunnel, --userspace, --mobdev2, --usbmux, --udid.