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: toml [dependencies] gptman = { version = "0.2.0", default-features = false }

Library Usage

Reading all the partitions of a disk:

```rust 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.isused() { println!("Partition #{}: type = {:?}, size = {} bytes, starting lba = {}", i, p.partitiontypeguid, p.size().unwrap() * gpt.sectorsize, p.starting_lba); } } ```

Creating new partitions:

```rust 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 freepartitionnumber = gpt.iter().find(|(i, p)| p.isunused()).map(|(i, _)| i) .expect("no more places available"); let size = gpt.getmaximumpartitionsize() .expect("no more space available"); let startinglba = gpt.findoptimalplace(size) .expect("could not find a place to put the partition"); let endinglba = starting_lba + size - 1;

gpt[freepartitionnumber] = gptman::GPTPartitionEntry { partitiontypeguid: [0xff; 16], uniquepartitionguid: [0xff; 16], startinglba, endinglba, attributebits: 0, partitionname: "A Robot Named Fight!".into(), }; ```

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

```rust 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 { partitiontypeguid: [0xff; 16], uniquepartitionguid: [0xff; 16], startinglba: gpt.header.firstusablelba, endinglba: gpt.header.lastusablelba, attributebits: 0, partitionname: "A Robot Named Fight!".into(), }; ```