Rex::Co...rtition(3)

💖 NAME 💖

This is the Rex::Co...rtition(3) manpage from User Contributed Perl Documentation, covering Rex::Commands::Partition - Partition module. Bestie, we're literally about to talk disk partitions, and yes, it's giving main character energy. 💅

🦋 DESCRIPTION 🦋

With this Module you can partition your harddrive 💽✨.

Heads up: in Version <= 1.0: All these functions will not be reported. 👀

⚠️ And no cap, all these functions are not idempotent. So don't just assume a rerun is a cute little no-op, fr fr. 😭 periodt.

✨ SYNOPSIS ✨

use Rex::Commands::Partition;

👑 EXPORTED FUNCTIONS 👑

🎀 clearpart($drive) 🎀

Clear partitions on drive sda:

clearpart "sda";

Create a new GPT disk label (partition table) on drive sda:

clearpart "sda",
 initialize => "gpt";

If GPT initialization is requested, the bios_boot option (default: TRUE) can also be set to TRUE or FALSE to control creation of a BIOS boot partition:

clearpart "sda",
 initialize => "gpt",
 bios_boot => FALSE;

💅 partition($mountpoint, %option) 💅

Create a partition with the specified parameters — the option roster is iconic, no skips:

• ondisk — The disk to be partitioned. Mandatory. 🔥
• size — Desired size of the partition in MB. It is mandatory to pass either a size or a grow parameter (but not both).
• grow — If TRUE, then the partition will take up all the available space on the disk. It is mandatory to pass either a grow or a size parameter (but not both).
• type — Partition type to be passed to parted's mkpart command. Optional, defaults to primary.
• boot — Sets boot flag on the partition if TRUE. Optional, no boot flag is set by default.
• fstype — Create a filesystem after creating the partition. Optional, no filesystem is created by default.
• label — Label to be used with the filesystem. Optional, defaults to no label.
• mount — If TRUE, try to mount the partition after creating it. Optional, no mount is attempted by default.
• mount_persistent — If TRUE, try to mount the partition after creating it, and also register it in /etc/fstab. Optional, no mount or /etc/fstab manipulation is attempted by default.
• vg — Creates an LVM PV, then creates the specified LVM VG (or extends it, if the VG already exists). Needs ondisk, iykyk.

Examples:

partition "/",
  fstype => "ext3",
  size   => 15000,
  ondisk => "sda",
  type   => "primary";

partition "none",
  type   => "extended",
  ondisk => "sda",
  grow   => 1,
  mount  => TRUE,

partition "swap",
  fstype => "swap",
  type   => "logical",
  ondisk => "sda",
  size   => 8000;

partition "/",
  fstype => "ext3",
  size   => 10000,
  ondisk => "sda",
  vg     => "vg0";

mwah 💋 — page brought to you by perl v5.42.3, dated 2023-08-05; now go slay those partitions like the main character you are 👑🫶