KernelTool is a versatile shell script that automates various tasks related to kernel debugging, filesystem extraction, file archiving, and core dump configuration. It is designed to assist developers and system administrators in managing kernel debugging sessions, extracting compressed filesystems, and setting up root filesystems for testing.
- Filesystem Extraction: Extracts compressed files (e.g., gzip) into a
rootfsdirectory. - Root Filesystem Archiving: Creates
.cpioor.cpio.gzarchives with custom binaries for testing. - Kernel Debugging Setup: Configures GDB for kernel debugging with pre-set breakpoints.
- Kernel Image Extraction: Extracts a compressed kernel image (
bzImage) into avmlinuxfile. - Core Dump Configuration: Configures core dump settings and prepares the environment for kernel crash analysis.
gcc- for compilingexp.cif you use the-meroptions.gdb- for kernel debugging when using the-gdboption.cpio,gzip,gunzip- for filesystem extraction and archiving.wget- for downloadingextract-vmlinuxif it is not already available.
curl https://raw.githubusercontent.com/kmm2003/KernelTool/refs/heads/main/KernelTool -o KernelTool && chmod +x KernelTool./KernelTool <option> [file_name]-ext <file_name>: Extracts the specified compressed file (e.g., gzip) into therootfsdirectory.-ext -vmlinux: ExtractsbzImagetovmlinuxusing theextract-vmlinuxscript.-mer -cpio <file_name>: Compilesexp.c, adds it torootfs, and creates arootfs.cpioarchive.-mer -gz -cpio <file_name>: Compilesexp.cinto a static binary, adds it torootfs, and creates a compressed archiverootfs.cpio.gz.-gdb <symbol_file> <address>: Configures GDB for kernel debugging, sets up remote debugging onlocalhost:1234, and adds asymbol filewith the specifiedload address.
./KernelTool -ext rootfs.cpio.gz
./KernelTool -ext -vmlinux
./KernelTool -mer -cpio rootfs.cpio
./KernelTool -mer -cpio -gz rootfs.cpio.gz
./KernelTool -gdb vmlinux 0x1000000-
Filesystem Extraction (
-ext <file_name>)- Deletes and recreates
rootfsdirectory. - Copies the specified file to
rootfsand decompresses if it’s gzip-compressed. - Extracts the archive using
cpio.
- Deletes and recreates
-
Kernel Image Extraction (
-ext -vmlinux)- Downloads the
extract-vmlinuxscript if not available. - Extracts
bzImageto produce avmlinuxfile for debugging.
- Downloads the
-
Root Filesystem Archiving (
-mer -cpio <file_name>and-mer -cpio -gz <file_name>)- Compiles
exp.cinto a static binary. - Moves the compiled binary to
rootfs4ABC . - Creates a
.cpioor.cpio.gzarchive for therootfsdirectory.
- Compiles
-
Kernel Debugging Setup (
-gdb <symbol_file> <address>)- Sets up GDB for kernel debugging.
- Configures the architecture and attaches to a remote session.
- Sets breakpoints and continues execution.