idevicecrashreport

Retrieve crash reports and move them to a specified directory

$ idevicecrashreport [path/to/directory]

$ idevicecrashreport --keep [path/to/directory]

$ idevicecrashreport --extract [path/to/directory]

idevicecrashreport [-u UDID] [-d] [-h] [-l] [-V] [-x]

-d, --debug
    Enable communication debugging

-h, --help
    Print usage information

-l, --list
    List available crash reports without downloading

-u UDID, --udid UDID
    Target specific device by UDID

-V, --version
    Print version information

-x, --extract
    Extract all crash reports to current directory

idevicecrashreport is a command-line tool from the libimobiledevice suite, enabling Linux users to access crash logs from connected iOS devices without jailbreaking. It communicates via USB using Apple's protocols to fetch diagnostic data generated when apps or the system crash.

Ideal for developers debugging iOS apps on non-Apple hardware, it lists, extracts, or outputs crash reports in structured formats like .ips or .crash files. These contain stack traces, exception details, and binary images, aiding root cause analysis.

Usage involves connecting an iPhone/iPad via USB, ensuring the device is trusted (unlock and tap 'Trust'), then running the command. It supports multiple devices via UDID selection. Debug mode aids troubleshooting communication issues.

Extracted reports mirror Xcode's Organizer view, making it invaluable for cross-platform workflows. Requires libimobiledevice installed; supports iOS 5+ typically.

Device must be USB-connected and trusted; iOS version compatibility varies; -l and -x require -u for multi-device setups; root access not needed but usbmuxd must run.

On Debian/Ubuntu: sudo apt install libimobiledevice-utils; build from source via libimobiledevice.org.

Crash files saved as YYYY-MM-DD-HH.MM.SS-*.crash or *.ips in current directory with -x.

Part of libimobiledevice project (started 2007 by Nikias Bassen); idevicecrashreport added ~2010 for iOS 4+ diagnostics; actively maintained for modern iOS.

ideviceinfo(1), idevicesyslog(1), idevicedebugserverproxy(1), libimobiledevice(7)