#partition #table #filesystem #disk #gpt

bin+lib gptman

A GPT manager that allows you to copy partitions from one disk to another

5 releases (breaking)

✓ Uses Rust 2018 edition

new 0.5.0 Jul 14, 2019
0.4.0 Jul 14, 2019
0.3.0 May 1, 2019
0.2.0 Jan 10, 2019
0.1.0 Jan 7, 2019

#71 in Command line utilities

Download history 1/week @ 2019-03-30 3/week @ 2019-04-06 4/week @ 2019-04-13 3/week @ 2019-04-20 14/week @ 2019-04-27 5/week @ 2019-05-04 6/week @ 2019-05-11 12/week @ 2019-05-18 13/week @ 2019-05-25 3/week @ 2019-06-01 3/week @ 2019-06-08 10/week @ 2019-06-15 55/week @ 2019-06-22 9/week @ 2019-06-29 29/week @ 2019-07-06

55 downloads per month

MIT license

128KB
3K SLoC

Build Status Latest Version License Docs.rs LOC Dependency Status

gptman

A CLI tool for Linux that allows you to copy a partition from one disk to another and more.

A library that allows managing GUID partition tables.

Features

  • Read/Write GPT from 512 and 4096 bytes sector size disks
  • Create a new GPT on a disk (-i, --init)
  • Insert/delete a partition in the table (n, d)
  • Align partitions automatically (a)
  • Resize a partition (r)
  • Copy/clone a partition from one disk and insert it to another (c)
  • Change partition type (and list by category) (t)
  • Fix partitions order (f)
  • Change disk GUID (i)
  • Change partition name (L)
  • Change partition GUID (u)
  • Toggle legacy BIOS bootable (A)
  • Toggle no block IO protocol (B)
  • Toggle required partition flag (R)
  • Toggle attributes (S)
  • Customize columns to print (-o, --output)
  • Print raw data of disklabel (D)
  • Swap partition indexes (s)
  • Randomize disk's GUID and all partition's GUID (Z)
  • Copy/clone all partitions from one disk and insert it to another (C)
  • Write protective MBR

Installation

  • CLI:

    cargo install gptman
    

    Statically linked:

    cargo install --target=x86_64-unknown-linux-musl gptman
    
  • Library:

    Cargo.toml:

    [dependencies]
    gptman = { version = "0.2.0", default-features = false }
    

Library Usage

Reading all the partitions of a disk:

let mut f = std::fs::File::open("tests/fixtures/disk1.img")
    .expect("could not open disk");
let gpt = gptman::GPT::find_from(&mut f)
    .expect("could not find GPT");

println!("Disk GUID: {:?}", gpt.header.disk_guid);

for (i, p) in gpt.iter() {
    if p.is_used() {
        println!("Partition #{}: type = {:?}, size = {} bytes, starting lba = {}",
            i,
            p.partition_type_guid,
            p.size().unwrap() * gpt.sector_size,
            p.starting_lba);
    }
}

Creating new partitions:

let mut f = std::fs::File::open("tests/fixtures/disk1.img")
    .expect("could not open disk");
let mut gpt = gptman::GPT::find_from(&mut f)
    .expect("could not find GPT");

let free_partition_number = gpt.iter().find(|(i, p)| p.is_unused()).map(|(i, _)| i)
    .expect("no more places available");
let size = gpt.get_maximum_partition_size()
    .expect("no more space available");
let starting_lba = gpt.find_optimal_place(size)
    .expect("could not find a place to put the partition");
let ending_lba = starting_lba + size - 1;

gpt[free_partition_number] = gptman::GPTPartitionEntry {
    partition_type_guid: [0xff; 16],
    unique_parition_guid: [0xff; 16],
    starting_lba,
    ending_lba,
    attribute_bits: 0,
    partition_name: "A Robot Named Fight!".into(),
};

Creating a new partition table with one entry that fills the entire disk:

let ss = 512;
let data = vec![0; 100 * ss as usize];
let mut cur = std::io::Cursor::new(data);
let mut gpt = gptman::GPT::new_from(&mut cur, ss as u64, [0xff; 16])
    .expect("could not create partition table");

gpt[1] = gptman::GPTPartitionEntry {
    partition_type_guid: [0xff; 16],
    unique_parition_guid: [0xff; 16],
    starting_lba: gpt.header.first_usable_lba,
    ending_lba: gpt.header.last_usable_lba,
    attribute_bits: 0,
    partition_name: "A Robot Named Fight!".into(),
};

Dependencies

~3MB
~49K SLoC