KO | EN

GitLite

Minimalist Open Source Repository Search Engine

gitlite — search

#typescript #ai-agents #developer-tools #cli #codex #claude-code #react #dsh-plugin #mcp #open-source #dsh #deepseek-harness

dump-android-partitions

★ 33 Open GitHub ↗

This is a tool which dumps (if possible) all android partitions to PC via USB adb connection. Requires root or some custon recovery with adb.

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

dump-android-partitions
=======================

## Overview
Dump all partitions on an Android device from PC via adb

## Description
(REQUIRES ROOT maybe on your Android device
)
You can dump all or argument-designated partitions of your Android device using this shell script.

This script gets a list of partitions from the Android device's /dev/block/**/by-name (by default),
and with each of the partitions, the script dumps a binary image of partition as if use with dd command,
the binary images are stored as files on your PC's storage.

## Demo
    $ adb devices -l
    List of devices attached
    XXXXXXXXXX             device product:shamu model:Nexus_6 device:shamu
    
    $ dump-android-partitions -a versions:
    $ ls
    aboot.img
    abootBackup.img
    boot.img
    cache.img
    cid.img
    keystore.img
    kpan.img
    logo.img
    logs.img
    mdm1dhob.img
    mdm1hob.img
    mdm1m9kefs1.img
    mdm1m9kefs2.img
    mdm1m9kefs3.img
    mdm1m9kefsc.img
    modem.img
    oem.img
    padA.img
    padB.img
    padC.img
    padD.img
    recovery.img
    rpm.img
    rpmBackup.img
    sbl1.img
    sbl1bak.img
    sdi.img
    sp.img
    system.img
    tz.img
    tzBackup.img
    utags.img
    utagsBackup.img
    versions.img

## Requirement
* one of following environments on your PC: Unix, or Cygwin, msys2, ubuntu on Windows (some are not tested.)
* bash command line shell on your PC
* adb command on your PC
* adb debug switch is ON on your Android device.
* read permissions for partitions-device-file's directory (/dev/block/**/by-name by default) on your Android device
* white permissions for working directory (/data/local/tmp by default) on your Android device

Some of above usually require ROOT permissions.

## Usage
    dump-android-partitions [-lvnt] [-p GLOB] [-s SERIAL] [-x EXCLUDE] [-w WORKDIR] {-a|PARTITION ...}
    dump-android-partitions -l {-a|PARTITION ...}
    dump-android-partitions -h
      -a
        dump all partitions except those designated with -x option
      -l
        list partition names on a device and exit
      -p GLOB
        A shell glob pattern to search directories that includes partition names as file(node) names
        example: dump-android-partitions -p /dev/block/platform/*/msm_sdcc.1/by-name
        To use multiple globs, you can repeat -p options.
        default: /dev/block/*/*/by-name /dev/block/*/*/*/by-name /dev/block/*/*/by-num /dev/block/*/*/*/by-num
      -s SERIAL
        use device with given serial number (overrides $ANDROID_SERIAL), same as adb command
      -t
        TEST mode.
        Get dumped images by both a traditional dd method and a cat method (dump-android-partitions is normailly used this),
        and compare both images by cmp command. If two images differ, perhaps the cat method is buggy.
      -w WORKDIR
        a working directory path on a remote adb device, used only on TEST mode.
        default: /data/local/tmp
      -x EXCLUDE
        A file includes partition names to be excluded from dumping
        default: dump.exclude
      -h
        print this message and exit
      -v
        verbosely echoing information messages
      -n
        dry-run
      PARTITION
        a partition name to be dumped. shell globbing available

## Example

## Install
    sudo mkdir -p /usr/local/bin
    sudo cp dump-android-partitions /usr/local/bin

## Contribution
(now working)

## Licence
[GPL v3](https://www.gnu.org/licenses/lgpl.txt)

## Author
[for2ando/forzando](https://github.com/for2ando)

dump-android-partitions

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README