Skip to content

Latest commit

 

History

History
185 lines (127 loc) · 15.4 KB

README.md

File metadata and controls

185 lines (127 loc) · 15.4 KB

Lanchon REPIT

A Device-Only Data-Sparing Repartitioning Tool For Android

Powered by Flashize.


General Information (All Devices)

WHAT IS THE PROBLEM ?

many older devices, especially the ones originally released before emulated storage was available, were partitioned by the OEM in ways that hinder the installation and use of newer Android versions. for example, the Galaxy S2 GT-I9100 comes with a 0.5 GiB /system partition that is unable to fit CM 13.0 and Open GApps, even if you choose the pico version. though its flash is typically a generous 16 GiB, the stock /data partition is only 2 GiB which means that with today's ART you run out of space to install applications in no time. it also comes with a 0.5 GiB /preload partition that goes unused on custom ROMs.

people have typically solved this by repartitioning. on Samsung devices this is a tricky process that involves the use of download mode, a Windows PC, Windows device drivers that support the device's download mode, a 'pirated' proprietary PC software called Odin, the right PIT and other files, and correct configuration. (a free software alternative to Odin called Heimdall works on many devices and is cross platform and supports Linux PCs, but the rest of the hurdles remain.) the procedure has potential for hard-bricking if the wrong files are flashed. after repartitioning, all affected partitions must be reflashed or formatted anew, a procedure that many get wrong. and of course, all data in the affected partitions gets wiped (typically the complete device) making this an ultra-inconvenient affair.

WHAT IS REPIT ?

REPIT is a simple, safe, device-only, data-sparing, and easily portable repartitioning tool for Android devices:

  • device-only: just flash a zip file in recovery to repartition the device.
  • simple: rename the zip file before flashing to configure your choice of partition sizes, file systems, wipes, etc.
  • safe:
    • a correctly ported REPIT can never hard-brick your device.
    • before starting, REPIT checks for the existence of all the tools that will be needed for the task at hand, verifies that the current partition layout passes several sanity checks, checks and fixes all the involved file systems, and verifies that the new partition layout will meet its sanity checks too. REPIT performs a dry-run of the complete repartitioning process to detect possible problems early on.
    • if REPIT fails, it will nonetheless try to restore your device to a working in-between state. you can solve the blocking issue and REPIT again towards your goal, or otherwise REPIT back to your original configuration. (keeping the in-between state is not recommended as it usually involves 'wasted' unpartitioned space.)
    • my estimate is that between 500 to 1000 users already used REPIT for 'major' changes on the i9100 and no incidents of data loss were reported. (note: these are very stale numbers dating from March 2016, when REPIT was still in its infancy.)
  • easily portable: a simple configuration file is all that is needed to port REPIT to a new device.

you can look at the log of a demo run to get a feel for what REPIT can do. in this run on a Galaxy S2 it grows the /system and /data ext4 partitions to 1 and 6 GiB respectively, it wipes and shrinks the unused /preload partition to a minimum size, and it adjusts the size of the internal /sdcard vfat partition to occupy whatever space is left. REPIT plans, orders and undertakes a safe series of partition resize and move operations to reach its goal, all the while keeping and eye on details such as alignments and retaining the data present in the /system, /data and /sdcard partitions.

LIMITATIONS

  • REPIT requires TWRP 2 or TWRP 3. some recoveries unnecessarily hold device or partition locks during flashing, which prevents all repartitioning tools from working (parted, fdisk, gdisk, and of course REPIT). unfortunately the recoveries bundled with CM 11, 12.0, 12.1 and 13.0 display this issue and are incompatible. recent TWRP 2.8.7.* and 3.0.0.* recoveries comply with this requirement, but only when flashing zips from /tmp. (REPIT will automatically copy itself to /tmp if it detects locks, to help you relaunch from there.)
  • REPIT does not support encrypted phones.
  • REPIT will cause data loss if the repartitioning process is externally interrupted. plug into a power source!

HOW TO REPIT

  1. if you think your data is invaluable then treat it as such: make a backup!
  2. get TWRP running on your device.
  3. make sure your battery is mostly charged.
  4. get the zip for your device from the link below.
  5. rename it to express your desired configuration (see below).
  6. PLUG INTO A POWER SOURCE. this operation might take a long time and must not be interrupted.
  7. flash the zip locally on the phone. (if you want to sideload instead, please see the note below.)

finally, go get a coffee or two. do not, under any circumstance, interrupt this script !!!

in case the script fails to start:

  • if the script cannot unmount all partitions, it will copy itself to the /tmp directory and ask you to flash it a second time from there.
  • if it still fails to unmount all partitions, or if it fails to lock the eMMC ('unable to reread the partition table'), then unplug the device from USB hosts such as PCs, reboot TWRP, and reflash the script immediately after boot up. (you may actually need to reflash twice, the second time from '/tmp'.) do not do anything after booting up and before flashing! in particular, do not connect the device to a PC or USB host as this might auto-mount the sdcard via MTP, and do not mount the sdcard as USB mass storage via TWRP's UI. in some rare cases you might need to use TWRP's UI to disable MTP before rebooting and to manually unmount all partitions before flashing the script from '/tmp'.
  • if locking issues remain, your phone is probably encrypted; this script is not compatible with encrypted phones.

if you want to sideload:

  • sideloading conceals the filename from the device, and thus filename-based configuration will not work.
  • to sideload you need to add a file called 'flashize/repit-settings' to the zip containing the full intended filename, or otherwise just the configuration part of it. for example, a file containing -system=1G is enough (the - is required). note that your recovery might require you to resign the zip after that change.
  • otherwise you can add the file directly to the device before sideloading, for example via adb push. in that case it must be named '/tmp/repit-settings'.

HOW TO CONFIGURE

configure the script by renaming the zip file before flashing it.

valid zip names: <prefix>[-partition1=<conf>][-partition2=<conf>]...<suffix>

valid partition <conf> values: [<size>(G|M)|same|min|max][+[keep|wipe][+[ext4|vfat|f2fs|swap|raw]]]

the defaults are device-dependent. please look inside your device's configuration file for more information. for configuration samples please see the i9100 section below.

Partition Data
  • keep: retain the data in the partition. if the partition needs to be moved or resized, this option usually makes the operation significantly slower, even if the partition is mostly empty.
  • wipe: wipe the partition. always wipe partitions that are empty or carry data that you do not care about: it will make REPIT faster and will result in less wear on the flash memory.
Partition Sizes
  • same: do not alter the size of this partition.
  • min: make this unused partition a minimum yet formattable size (typically 8 MiB, but device-dependent).
  • max: make this partition as big as possible (at most one partition per 'heap' can have its size set to 'max').
  • <size>(G|M): fractional number followed by a size unit expressing the desired partition size. the unit is either G for GiB or M for MiB. this value gets rounded to the nearest acceptable discreet value. the size granularity is device-dependent, but typically set to match the device-dependent partition alignment (which typically is 1 or 4 MiB).
Partition Types
  • ext4 and vfat: these partitions have full move, resize and wipe support.
  • f2fs: f2fs partitions can be moved and wiped, and can only be resized while wiping them.
    (tools to resize f2fs file systems do not exist for now.)
  • swap: swap partitions can be wiped, and can only be moved or resized while wiping them.
    (it makes no sense to retain their content.)
  • raw: raw partitions are treated as opaque blobs and can only be moved.
    (neither resizing nor wiping is supported.)
Supported Features
wipe keep + move keep + resize keep + move + resize crypto footer
ext4 YES YES (brute force) YES (efficient) YES (brute force) YES
vfat YES YES (efficient) YES (efficient) YES (efficient) no
f2fs YES YES (brute force) no no YES
swap YES no no no no
raw no YES no no no
  • brute force: the complete partition extent is operated upon.
  • efficient: only the stored data within the partition is operated upon.
  • crypto footer: support for encryption metadata at the end of the partition.

IN CASE OF ISSUES

if there are any problems, read the log! you can scroll it on TWRP. most likely it will tell you what is wrong and what to do about it. if not, make sure to somehow record the log. REPIT logs to file '/tmp/lanchon-repit.log'. otherwise, you can obtain a copy of TWRP's log (which includes REPIT's log), or if not at least take a picture of it with your camera. in TWRP 2.8.7.* you can see a full screen log by hitting the back button once, then the center button at the bottom of the screen that looks like a TV screen. after recording the log, you can try reflashing the script if you understand what happened and flashing it again makes sense.

PLEASE NOTE: your 'did not work' report is useless unless you post info from your log.


Device-Specific Information

each supported device has a unique targeted build of REPIT in the download section. you can also find device-specific information in the device tree; try searching by device codename using Github's find file. all configuration options for a specific device are defined in the corresponding <device-codename>.sh file and the common.sh files that might exist in the same directory and in directories above it. you might also find device-specific readme files with relevant information.

IF YOUR DEVICE IS NOT SUPPORTED

so your device is unsupported, tough luck... but porting REPIT to a new device is an easy job; you can either do it yourself or request that i do it for you. to request a new port, please follow this steps; port requests are welcome. if you want to get your hands dirty, check the configuration files for i9100 (1, 2), they are the most complete and commented. but usually you can get away with much less, take a look at i9300. for an example of how to handle out-of-order partitions, check out janice.


The Galaxy S2 Family

REPIT started its life as i9100-only tool and it inherits this doc section from the good old days.

IMPORTANT NOTE: this script will not work if your phone is encrypted. you need to decrypt your phone first. this was found and reported by XDA user jer194 here. if you run the script on an encrypted phone anyway, no damage will come: it will just refuse to start, complaining that it cannot reread the partition table.

IF... your stock-partitioned device cannot flash gapps after updating to CM 13.0

download and flash the file as it is. it will get most space from the unused /preload partition and only 8 MiB for the internal sdcard, and then make /system 1 GiB in size. it will keep you current /data size constant, whatever it is. it will retain all data except data in /preload, which is unused in custom roms (but some multi-boot setups use it).

IF... your device is usable

you can nonetheless use this script to do general repartitioning, file system fixing, wiping, and/or file system type changes. download the script, rename it to express your desired configuration (see below), and then flash it.

Galaxy S2 HOW TO

first get official TWRP running on your device, then follow the generic how-to.

valid zip names: <prefix>[-system=<conf>][-data=<conf>][-sdcard=<conf>][-preload=<conf>]<suffix>

for this device, partition alignment is 4 MiB and partition sizes get rounded to the nearest 4 MiB boundary. (it is typical for all devices to use the same value for partition alignment and granularity.)

Galaxy S2 Defaults
  • -system=same+keep+ext4
  • -data=same+keep+ext4
  • -sdcard=same+keep+vfat <-- note vfat here
  • -preload=same+keep+ext4
Galaxy S2 Samples
  • repartition to stock, wiping preload (in case you used a very small preload before):
    (note: in general it is not recommended to resize file systems by large factors.)
    lanchon-repit-XXXXXXXX-system=0.5G-data=2G-sdcard=max-preload=0.5G+wipe-i9100.zip
  • repartition to stock (without wiping preload):
    -system=0.5G-data=2G-sdcard=max-preload=0.5G
  • wipe data:
    -data=+wipe
  • wipe/change internal sdcard to ext4 (not recommended):
    -sdcard=+wipe+ext4
  • repartition to 1 GiB system, 6 GiB data, no preload...
    • ...keeping all other data:
      -system=1G-data=6G-sdcard=max-preload=min+wipe
    • ...keeping all other data, for phones with ext4-formatted internal sdcard:
      -system=1G-data=6G-sdcard=max++ext4-preload=min+wipe
    • ...keeping system and sdcard but WIPING DATA:
      (note: wiping data is much faster than moving it around if system is being resized and data is large.)
      -system=1G-data=6G+wipe-sdcard=max-preload=min+wipe

Disclaimer

i believe this software to be very safe and i exercised it a lot before posting it. but i accept no responsibility if your data is lost or your device is bricked.



for historical information regarding the CHEF-KOCH incident (and XDA's response), please follow this link.