# Debug documentation Diagnose subsystem discrepancies using debug tools and logs that help you troubleshoot system-level issues. ## Debug overview Debug workflow Identify errors and locate the components that need debugging. https://docs.qualcomm.com/doc/80-70030-12/topic/identify_subsystem_to_be_debugged.html#identify-subsystem-to-be-debugged Debug methods Apply debugging methods to fix both hardware and software issues. https://docs.qualcomm.com/doc/80-70030-12/topic/debug_features.html#debugging-approaches ## Debug Linux user-space issues Debug using ltrace Trace library calls and debug application behavior. https://docs.qualcomm.com/doc/80-70030-12/topic/ltrace.html#ltrace Debug using Valgrind Identify memory-related issues. https://docs.qualcomm.com/doc/80-70030-12/topic/debug_using_valgrind.html#debug-using-valgrind Debug using GNU debugger Enable the GNU project debugger to identify application issues. https://docs.qualcomm.com/doc/80-70030-12/topic/debug_using_gdb.html#debug-using-gdb Collect coredumps Locate where the process crashed and uncover the root cause using coredump analysis. https://docs.qualcomm.com/doc/80-70030-12/topic/collect_coredumps.html#collect-coredumps Debug using gdbserver Troubleshoot effectively even when your device has limited space for debug symbols. https://docs.qualcomm.com/doc/80-70030-12/topic/debug_using_gdbserver.html#debug-using-gdbserver Debug with user-space logs Connect using SSH and use debug tools to identify and troubleshoot issues within the Linux user space. https://docs.qualcomm.com/doc/80-70030-12/topic/userspace_logs.html#userspace-logs Configure debug symbols Analyze system crashes by enabling debug symbols and using the right packages to parse coredumps. https://docs.qualcomm.com/doc/80-70030-12/topic/debug_symbols.html#debug-symbols Reboot the system Trigger controlled or forced system restarts to apply configuration changes, recover from critical faults, or initiate diagnostic workflows with minimal disruption. https://docs.qualcomm.com/doc/80-70030-12/topic/reboot_device_from_userspace.html#reboot-device-from-userspace ## Debug Linux kernel-space issues Enable kernel debugging Activate the debugfs file system to dynamically debug kernel components in real time. https://docs.qualcomm.com/doc/80-70030-12/topic/enable_kernel_debugging.html#enable-kernel-debugging Configure the kernel for debugging Explore common kernel settings that support debugging and help detect memory-related issues. https://docs.qualcomm.com/doc/80-70030-12/topic/general_debugging_linux_kernel.html#configure-the-kernel-for-debugging Assess memory usage Understand how virtual memory is managed and utilized to optimize system performance and stability. https://docs.qualcomm.com/doc/80-70030-12/topic/assess_memory_usage.html#assess-memory-usage Trace kernel functions Trace kernel functions at runtime to profile and debug complex system behavior. https://docs.qualcomm.com/doc/80-70030-12/topic/trace_kernel_functions.html#trace-kernel-functions Collect and parse RAM dump Capture and decode crash-time memory with platform tools to trace root causes and enable post-failure analysis. https://docs.qualcomm.com/doc/80-70030-12/topic/collect_and_parse_ram_dumps.html#collect-and-parse-ram-dumps Parse RAM dumps using RAMParser Analyze Qualcomm RAM dumps using the open-source Linux RAMParser to extract process stacks, IRQs, and work queues for in-depth crash diagnostics. https://docs.qualcomm.com/doc/80-70030-12/topic/parse_ram_dumps_using_linux_ramdump_parser_rdp.html#parse-ram-dumps-using-linux-ramdump-parser-rdp Parse RAM dumps using QCAP Analyze subsystem logs and identify the initial point of failure using QCAP. https://docs.qualcomm.com/doc/80-70030-12/topic/parse_ram_dumps_using_qcap.html#parse-ram-dumps-using-qcap Debug using the crash utility tool Inspect kernel state and debug post-crash issues on Linux systems by analyzing RAM dumps through a GDB-based CLI. https://docs.qualcomm.com/doc/80-70030-12/topic/crash_utility.html#crash-utility Debug using OpenOCD Perform real-time debugging, flashing, and boundary-scan testing on embedded targets using the OpenOCD on-chip interface. https://docs.qualcomm.com/doc/80-70030-12/topic/debug_using_openocd.html#debug-using-openocd ## Debug common system issues Debug watchdog timeout issues Debug watchdog-related failures to help your system recover from unexpected hardware or software crashes. https://docs.qualcomm.com/doc/80-70030-12/topic/watchdog_timeout.html#watchdog-timeout Debug bus hang and timeout issues Debug bus hang and timeout issues to prevent failures in components that can trigger critical system errors. https://docs.qualcomm.com/doc/80-70030-12/topic/general_system_debugging.html#erroneous-transaction-on-bus-error-and-timeout Identify the cause of hardware reset Use targeted debugging methods to identify the root cause of unexpected hardware resets and system reboots. https://docs.qualcomm.com/doc/80-70030-12/topic/reset_hardware.html#reset-hardware Last Published: Jun 21, 2026 [Next Topic Debug overview](https://docs.qualcomm.com/bundle/publicresource/80-70030-12/topics/Debug-overview.md)