A comprehensive collection of crash-utility plugins for analyzing Linux kernel crash dumps, covering both kernel space and user space debugging. These plugins significantly improve debugging efficiency for Qualcomm platforms.

• Features
• Prerequisites
• Building
• Installation
• Supported Modules
• Usage
• Development Guide
• Tested Kernels
• Contributing
• License

• Comprehensive Coverage: 40+ plugins covering memory, process, device, and system analysis
• Dual Architecture Support: ARM64 and ARM32 platforms
• Flexible Build System: Single-module or multi-module compilation
• Android Integration: Special support for Android 11+ (API level 30+)
• Kernel Version Support: Tested on kernels 5.4 to 6.6

• CMake >= 3.21.1
• GCC with multilib support
• Linux development environment

# Install CMake sudo apt-get install cmake # Enable 32-bit architecture support sudo dpkg --add-architecture i386 sudo apt-get update # Install required libraries sudo apt-get install gcc-multilib g++-multilib \ libzstd-dev libzstd-dev:i386 \ libelf-dev libelf-dev:i386 \ libsystemd-dev libsystemd-dev:i386 \ pkg-config

The build system supports two modes:

1. Single-module mode (default): All plugins compiled into one plugins.so
2. Multi-module mode: Each plugin compiled as a separate .so file

cmake -DCMAKE_C_COMPILER="/usr/bin/gcc" \ -DCMAKE_CXX_COMPILER="/usr/bin/g++" \ -DCMAKE_BUILD_TYPE="Debug" \ -DCMAKE_BUILD_TARGET_ARCH="arm64" \ -DBUILD_TARGET_TOGETHER="1" \ -B output/arm64 cmake --build output/arm64

cmake -DCMAKE_C_COMPILER="/usr/bin/gcc" \ -DCMAKE_CXX_COMPILER="/usr/bin/g++" \ -DCMAKE_BUILD_TYPE="Debug" \ -DCMAKE_BUILD_TARGET_ARCH="arm64" \ -B output/arm64 cmake --build output/arm64

./build.sh

Load plugins into a running crash-8.0.6+ session:

# Single-module mode crash> extend <path-to>/output/arm64/plugins.so # Multi-module mode crash> extend <path-to>/output/arm64/binder.so crash> extend <path-to>/output/arm64/slub.so

Detailed usage examples are available in USAGE.md.

# Display all binder processes crash> binder -a # Show memory statistics crash> meminfo -a # Analyze SLUB cache crash> slub -a # Generate process coredump crash> coredump -p 1234 # Parse device tree crash> dts -a # View thermal zones crash> tm -d

For comprehensive command documentation, see:

crash>help<command>

1. Create header file (demo/demo.h):

/** * Copyright (c) Qualcomm Technologies, Inc. and/or its subsidiaries. * SPDX-License-Identifier: GPL-2.0-only*/ #ifndef DEMO_H_ #defineDEMO_H_ #include"plugin.h"classDemo: publicParserPlugin{public:Demo(); voidcmd_main(void) override; voidinit_offset(void) override; voidinit_command(void) override; DEFINE_PLUGIN_INSTANCE(Demo) }; #endif// DEMO_H_

2. Implement plugin (demo/demo.cpp):

#include"demo.h" #pragma GCC diagnostic push #pragma GCC diagnostic ignored "-Wpointer-arith" voidDemo::cmd_main(void){int c; if (argcnt < 2) cmd_usage(pc->curcmd, SYNOPSIS); while ((c = getopt(argcnt, args, "a")) != EOF){switch(c){case'a': // Your implementationbreak; default: argerrs++; break} } if (argerrs) cmd_usage(pc->curcmd, SYNOPSIS)} voidDemo::init_command(void){cmd_name = "demo"; help_str_list ={"demo", "your description", "demo -a", " -a show all information", NULL }} voidDemo::init_offset(void){// Initialize structure offsets if needed } #pragma GCC diagnostic pop

3. Register plugin in plugins.cpp:

#include"demo/demo.h"// Add instance declaration std::shared_ptr<Demo> Demo::instance = nullptr; // Register in plugin_init()voidplugin_init(void){plugins.push_back(make_and_init<Demo>()); // ... other plugins }

4. Update CMakeLists.txt:

list(APPEND PLUGIN_SOURCES demo/demo.cpp)

Follow steps 1-2 above, then:

3. Use macro in cpp file:

DEFINE_PLUGIN_COMMAND(Demo)

4. Add build rule in CMakeLists.txt:

add_plugin(demo demo/demo.cpp)

• Use MEMBER_OFFSET_INIT() for structure field offsets
• Handle both ARM64 and ARM32 architectures when applicable
• Add comprehensive help text in init_command()
• Use cmd_usage() for error handling
• Follow existing code style and patterns

• Linux kernel versions: 5.4 to 6.6
• Android versions: 11 (API 30) to 14 (API 34)
• Architectures: ARM64, ARM32

Contributions are welcome! Please see CONTRIBUTING.md and CODE-OF-CONDUCT.md.

• Crash Utility Official Site

• [email protected]

This project is licensed under the GPL v2 License. See LICENSE.txt for the full license text.

Note: This plugin collection is designed for debugging and analysis purposes. Always ensure you have proper authorization before analyzing system crash dumps.