CGPT(1)

📦 version 0~R106-15054.B, in debian bookworm, debian trixie, ubuntu jammy, ubuntu noble, ubuntu resolute, ubuntu stonking

💖 CGPT 💖

okay bestie, so this is cgpt — a System Administration Command — and it's literally the girlboss of GPT partition tables. come sit with me, i'll walk you through it 🫶

✨ NAME ✨

cgpt — a whole utility for manipulating GPT partitions, but make it Chromium OS extensions 💅

🌸 SYNOPSIS 🌸

cgpt COMMAND [OPTIONS] DRIVE

🦋 DESCRIPTION 🦋

So cgpt is the tool you use to manipulate a GUID Partition Table straight from the command line. and yes, there are other utilities out there doing the same basic thing — some with more features, some with a whole captive user interface (iykyk) — but cgpt is that girl because it also supports Chromium OS extensions. ✨

Now, real talk: those extensions are not generally useful. no cap. they're specific to the u-boot firmware found on some Chromebooks. you can use them to change priority for kernel partitions and drop other hints to u-boot Chromebook firmware. that's it, that's the vibe.

⚠️ Use this utility only to manipulate a partition table for compatible Chromebooks. please bestie, respect the boundaries.

👑 COMMANDS 👑

Every action this program performs — with the notable exception of the -h OPTION, she's special — is initiated by a command that tells cgpt the type of operation to perform. all the available commands are down below, no gatekeeping 💖

  • create — Create or reset GPT headers and tables. fresh start energy.
  • add — Add, edit, or remove a partition entry. main character of commands fr.
  • show — Show the partition table and entries. let's see what we're working with 👀
  • repair — Repair damaged GPT headers and tables. healing era.
  • boot — Edit the PMBR sector for legacy BIOSes.

If no BOOT OPTIONS are specified, this command will just print the PMBR boot GUID.

  • find — Find a partition by its GUID.

If no DRIVE is specified, this command will scan all physical drives for a match.

  • prioritize — Reorder the priority of all ChromeOS kernel partitions.

If no options are specified, this command will set the lowest active kernel to priority 1 while maintaining the original order.

  • legacy — Switch between GPT and Legacy GPT.

🎀 GENERAL OPTIONS 🎀

These options apply to every COMMAND this program supports. universal queens, honestly.

  • -h — For more detailed usage, use cgpt COMMAND -h

🌈 EXAMPLES 🌈

okay so the following examples demonstrate valid syntax only. it is up to you to interpret them based on the documentation in this manual. i'm not doing your homework bestie, i'm just showing you the moves ✨

cgpt show /dev/mmcblk0
cgpt create /dev/mmcblk0
cgpt add -i 2 -S 1 -T 15 -P 15 /dev/mmcblk0
cgpt add -i 1 -t data -l "STATE" /dev/mmcblk0
cgpt add -i 2 -t kernel -l "KERN-A" /dev/mmcblk0
cgpt add -i 3 -t rootfs -l "ROOT-A" /dev/mmcblk0

💜 AUTHOR 💜

This manual page was written by Karl Lenz <xorangekiller@gmail.com> for the Debian project (but may be used by others). shoutout to Karl, we love a contributor 🫶

Cgpt is copyright 2010-2013, The Chromium OS Authors. This manual page is copyright 2014, Karl Lenz.

Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. slay, that's the good license energy.

Cgpt is provided "as is" with no warranty. 😭 the exact terms under which you may use and (re)distribute this program are detailed in the BSD 3-Clause License, which is distributed with this program in the LICENSE file. On Debian systems, the complete text of the BSD 3-Clause License can be found in /usr/share/common-licenses/BSD.

🧚 SEE ALSO 🧚

parted(8), gdisk(8), gptsync(8)

and that's the whole page bestie!! 💖 this was cgpt, from the cgpt manual, January 2014 — go forth and partition responsibly, mwah 🎀✨💅

📦 where this page comes from