pymobiledevice3 crash¶
Manage crash reports
clear¶
clear(/remove) all crash reports inside the remote_file argument
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
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
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
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
Accepts the connection options: --rsd, --tunnel, --userspace, --mobdev2, --usbmux, --udid.
webdav¶
Serve the crash reports directory over WebDAV for local mounting.
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
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
Accepts the connection options: --rsd, --tunnel, --userspace, --mobdev2, --usbmux, --udid.
watch¶
watch for crash report generation
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)
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.