lib/geom/part/gpart.8

   1 .\" Copyright (c) 2007, 2008 Marcel Moolenaar
   2 .\" All rights reserved.
   3 .\"
   4 .\" Redistribution and use in source and binary forms, with or without
   5 .\" modification, are permitted provided that the following conditions
   6 .\" are met:
   7 .\" 1. Redistributions of source code must retain the above copyright
   8 .\"    notice, this list of conditions and the following disclaimer.
   9 .\" 2. Redistributions in binary form must reproduce the above copyright
  10 .\"    notice, this list of conditions and the following disclaimer in the
  11 .\"    documentation and/or other materials provided with the distribution.
  12 .\"
  13 .\" THIS SOFTWARE IS PROVIDED BY THE AUTHORS AND CONTRIBUTORS ``AS IS'' AND
  14 .\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
  15 .\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
  16 .\" ARE DISCLAIMED.  IN NO EVENT SHALL THE AUTHORS OR CONTRIBUTORS BE LIABLE
  17 .\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
  18 .\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
  19 .\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
  20 .\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
  21 .\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
  22 .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
  23 .\" SUCH DAMAGE.
  24 .\"
  25 .\" $FreeBSD$
  26 .\"
  27 .Dd June 17, 2018
  28 .Dt GPART 8
  29 .Os
  30 .Sh NAME
  31 .Nm gpart
  32 .Nd "control utility for the disk partitioning GEOM class"
  33 .Sh SYNOPSIS
  34 .\" ==== ADD ====
  35 .Nm
  36 .Cm add
  37 .Fl t Ar type
  38 .Op Fl a Ar alignment
  39 .Op Fl b Ar start
  40 .Op Fl s Ar size
  41 .Op Fl i Ar index
  42 .Op Fl l Ar label
  43 .Op Fl f Ar flags
  44 .Ar geom
  45 .\" ==== BACKUP ====
  46 .Nm
  47 .Cm backup
  48 .Ar geom
  49 .\" ==== BOOTCODE ====
  50 .Nm
  51 .Cm bootcode
  52 .Op Fl b Ar bootcode
  53 .Op Fl p Ar partcode Fl i Ar index
  54 .Op Fl f Ar flags
  55 .Ar geom
  56 .\" ==== COMMIT ====
  57 .Nm
  58 .Cm commit
  59 .Ar geom
  60 .\" ==== CREATE ====
  61 .Nm
  62 .Cm create
  63 .Fl s Ar scheme
  64 .Op Fl n Ar entries
  65 .Op Fl f Ar flags
  66 .Ar provider
  67 .\" ==== DELETE ====
  68 .Nm
  69 .Cm delete
  70 .Fl i Ar index
  71 .Op Fl f Ar flags
  72 .Ar geom
  73 .\" ==== DESTROY ====
  74 .Nm
  75 .Cm destroy
  76 .Op Fl F
  77 .Op Fl f Ar flags
  78 .Ar geom
  79 .\" ==== MODIFY ====
  80 .Nm
  81 .Cm modify
  82 .Fl i Ar index
  83 .Op Fl l Ar label
  84 .Op Fl t Ar type
  85 .Op Fl f Ar flags
  86 .Ar geom
  87 .\" ==== RECOVER ====
  88 .Nm
  89 .Cm recover
  90 .Op Fl f Ar flags
  91 .Ar geom
  92 .\" ==== RESIZE ====
  93 .Nm
  94 .Cm resize
  95 .Fl i Ar index
  96 .Op Fl a Ar alignment
  97 .Op Fl s Ar size
  98 .Op Fl f Ar flags
  99 .Ar geom
 100 .\" ==== RESTORE ====
 101 .Nm
 102 .Cm restore
 103 .Op Fl lF
 104 .Op Fl f Ar flags
 105 .Ar provider
 106 .Op Ar ...
 107 .\" ==== SET ====
 108 .Nm
 109 .Cm set
 110 .Fl a Ar attrib
 111 .Fl i Ar index
 112 .Op Fl f Ar flags
 113 .Ar geom
 114 .\" ==== SHOW ====
 115 .Nm
 116 .Cm show
 117 .Op Fl l | r
 118 .Op Fl p
 119 .Op Ar geom ...
 120 .\" ==== UNDO ====
 121 .Nm
 122 .Cm undo
 123 .Ar geom
 124 .\" ==== UNSET ====
 125 .Nm
 126 .Cm unset
 127 .Fl a Ar attrib
 128 .Fl i Ar index
 129 .Op Fl f Ar flags
 130 .Ar geom
 131 .\"
 132 .Nm
 133 .Cm list
 134 .Nm
 135 .Cm status
 136 .Nm
 137 .Cm load
 138 .Nm
 139 .Cm unload
 140 .Sh DESCRIPTION
 141 The
 142 .Nm
 143 utility is used to partition GEOM providers, normally disks.
 144 The first argument is the action to be taken:
 145 .Bl -tag -width ".Cm bootcode"
 146 .\" ==== ADD ====
 147 .It Cm add
 148 Add a new partition to the partitioning scheme given by
 149 .Ar geom .
 150 The partition type must be specified with
 151 .Fl t Ar type .
 152 The partition's location, size, and other attributes will be calculated
 153 automatically if the corresponding options are not specified.
 154 .Pp
 155 The
 156 .Cm add
 157 command accepts these options:
 158 .Bl -tag -width 12n
 159 .It Fl a Ar alignment
 160 If specified, then
 161 .Nm
 162 utility tries to align
 163 .Ar start
 164 offset and partition
 165 .Ar size
 166 to be multiple of
 167 .Ar alignment
 168 value.
 169 .It Fl b Ar start
 170 The logical block address where the partition will begin.
 171 A SI unit suffix is allowed.
 172 .It Fl f Ar flags
 173 Additional operational flags.
 174 See the section entitled
 175 .Sx "OPERATIONAL FLAGS"
 176 below for a discussion
 177 about its use.
 178 .It Fl i Ar index
 179 The index in the partition table at which the new partition is to be
 180 placed.
 181 The index determines the name of the device special file used
 182 to represent the partition.
 183 .It Fl l Ar label
 184 The label attached to the partition.
 185 This option is only valid when used on partitioning schemes that support
 186 partition labels.
 187 .It Fl s Ar size
 188 Create a partition of size
 189 .Ar size .
 190 A SI unit suffix is allowed.
 191 .It Fl t Ar type
 192 Create a partition of type
 193 .Ar type .
 194 Partition types are discussed below in the section entitled
 195 .Sx "PARTITION TYPES" .
 196 .El
 197 .\" ==== BACKUP ====
 198 .It Cm backup
 199 Dump a partition table to standard output in a special format used by the
 200 .Cm restore
 201 action.
 202 .\" ==== BOOTCODE ====
 203 .It Cm bootcode
 204 Embed bootstrap code into the partitioning scheme's metadata on the
 205 .Ar geom
 206 (using
 207 .Fl b Ar bootcode )
 208 or write bootstrap code into a partition (using
 209 .Fl p Ar partcode
 210 and
 211 .Fl i Ar index ) .
 212 .Pp
 213 The
 214 .Cm bootcode
 215 command accepts these options:
 216 .Bl -tag -width 10n
 217 .It Fl b Ar bootcode
 218 Embed bootstrap code from the file
 219 .Ar bootcode
 220 into the partitioning scheme's metadata for
 221 .Ar geom .
 222 Not all partitioning schemes have embedded bootstrap code, so the
 223 .Fl b Ar bootcode
 224 option is scheme-specific in nature (see the section entitled
 225 .Sx BOOTSTRAPPING
 226 below).
 227 The
 228 .Ar bootcode
 229 file must match the partitioning scheme's requirements for file content
 230 and size.
 231 .It Fl f Ar flags
 232 Additional operational flags.
 233 See the section entitled
 234 .Sx "OPERATIONAL FLAGS"
 235 below for a discussion
 236 about its use.
 237 .It Fl i Ar index
 238 Specify the target partition for
 239 .Fl p Ar partcode .
 240 .It Fl p Ar partcode
 241 Write the bootstrap code from the file
 242 .Ar partcode
 243 into the
 244 .Ar geom
 245 partition specified by
 246 .Fl i Ar index .
 247 The size of the file must be smaller than the size of the partition.
 248 .El
 249 .\" ==== COMMIT ====
 250 .It Cm commit
 251 Commit any pending changes for geom
 252 .Ar geom .
 253 All actions are committed by default and will not result in
 254 pending changes.
 255 Actions can be modified with the
 256 .Fl f Ar flags
 257 option so that they are not committed, but become pending.
 258 Pending changes are reflected by the geom and the
 259 .Nm
 260 utility, but they are not actually written to disk.
 261 The
 262 .Cm commit
 263 action will write all pending changes to disk.
 264 .\" ==== CREATE ====
 265 .It Cm create
 266 Create a new partitioning scheme on a provider given by
 267 .Ar provider .
 268 The scheme to use must be specified with the
 269 .Fl s Ar scheme
 270 option.
 271 .Pp
 272 The
 273 .Cm create
 274 command accepts these options:
 275 .Bl -tag -width 10n
 276 .It Fl f Ar flags
 277 Additional operational flags.
 278 See the section entitled
 279 .Sx "OPERATIONAL FLAGS"
 280 below for a discussion
 281 about its use.
 282 .It Fl n Ar entries
 283 The number of entries in the partition table.
 284 Every partitioning scheme has a minimum and maximum number of entries.
 285 This option allows tables to be created with a number of entries
 286 that is within the limits.
 287 Some schemes have a maximum equal to the minimum and some schemes have
 288 a maximum large enough to be considered unlimited.
 289 By default, partition tables are created with the minimum number of
 290 entries.
 291 .It Fl s Ar scheme
 292 Specify the partitioning scheme to use.
 293 The kernel must have support for a particular scheme before
 294 that scheme can be used to partition a disk.
 295 .El
 296 .\" ==== DELETE ====
 297 .It Cm delete
 298 Delete a partition from geom
 299 .Ar geom
 300 and further identified by the
 301 .Fl i Ar index
 302 option.
 303 The partition cannot be actively used by the kernel.
 304 .Pp
 305 The
 306 .cm delete
 307 command accepts these options:
 308 .Bl -tag -width 10n
 309 .It Fl f Ar flags
 310 Additional operational flags.
 311 See the section entitled
 312 .Sx "OPERATIONAL FLAGS"
 313 below for a discussion
 314 about its use.
 315 .It Fl i Ar index
 316 Specifies the index of the partition to be deleted.
 317 .El
 318 .\" ==== DESTROY ====
 319 .It Cm destroy
 320 Destroy the partitioning scheme as implemented by geom
 321 .Ar geom .
 322 .Pp
 323 The
 324 .Cm destroy
 325 command accepts these options:
 326 .Bl -tag -width 10n
 327 .It Fl F
 328 Forced destroying of the partition table even if it is not empty.
 329 .It Fl f Ar flags
 330 Additional operational flags.
 331 See the section entitled
 332 .Sx "OPERATIONAL FLAGS"
 333 below for a discussion
 334 about its use.
 335 .El
 336 .\" ==== MODIFY ====
 337 .It Cm modify
 338 Modify a partition from geom
 339 .Ar geom
 340 and further identified by the
 341 .Fl i Ar index
 342 option.
 343 Only the type and/or label of the partition can be modified.
 344 Not all partitioning schemes support labels and it is invalid to
 345 try to change a partition label in such cases.
 346 .Pp
 347 The
 348 .Cm modify
 349 command accepts these options:
 350 .Bl -tag -width 10n
 351 .It Fl f Ar flags
 352 Additional operational flags.
 353 See the section entitled
 354 .Sx "OPERATIONAL FLAGS"
 355 below for a discussion
 356 about its use.
 357 .It Fl i Ar index
 358 Specifies the index of the partition to be modified.
 359 .It Fl l Ar label
 360 Change the partition label to
 361 .Ar label .
 362 .It Fl t Ar type
 363 Change the partition type to
 364 .Ar type .
 365 .El
 366 .\" ==== RECOVER ====
 367 .It Cm recover
 368 Recover a corrupt partition's scheme metadata on the geom
 369 .Ar geom .
 370 See the section entitled
 371 .Sx RECOVERING
 372 below for the additional information.
 373 .Pp
 374 The
 375 .Cm recover
 376 command accepts these options:
 377 .Bl -tag -width 10n
 378 .It Fl f Ar flags
 379 Additional operational flags.
 380 See the section entitled
 381 .Sx "OPERATIONAL FLAGS"
 382 below for a discussion
 383 about its use.
 384 .El
 385 .\" ==== RESIZE ====
 386 .It Cm resize
 387 Resize a partition from geom
 388 .Ar geom
 389 and further identified by the
 390 .Fl i Ar index
 391 option.
 392 If the new size is not specified it is automatically calculated
 393 to be the maximum available from
 394 .Ar geom .
 395 .Pp
 396 The
 397 .Cm resize
 398 command accepts these options:
 399 .Bl -tag -width 12n
 400 .It Fl a Ar alignment
 401 If specified, then
 402 .Nm
 403 utility tries to align partition
 404 .Ar size
 405 to be a multiple of the
 406 .Ar alignment
 407 value.
 408 .It Fl f Ar flags
 409 Additional operational flags.
 410 See the section entitled
 411 .Sx "OPERATIONAL FLAGS"
 412 below for a discussion
 413 about its use.
 414 .It Fl i Ar index
 415 Specifies the index of the partition to be resized.
 416 .It Fl s Ar size
 417 Specifies the new size of the partition, in logical blocks.
 418 A SI unit suffix is allowed.
 419 .El
 420 .\" ==== RESTORE ====
 421 .It Cm restore
 422 Restore the partition table from a backup previously created by the
 423 .Cm backup
 424 action and read from standard input.
 425 Only the partition table is restored.
 426 This action does not affect the content of partitions.
 427 After restoring the partition table and writing bootcode if needed,
 428 user data must be restored from backup.
 429 .Pp
 430 The
 431 .Cm restore
 432 command accepts these options:
 433 .Bl -tag -width 10n
 434 .It Fl F
 435 Destroy partition table on the given
 436 .Ar provider
 437 before doing restore.
 438 .It Fl f Ar flags
 439 Additional operational flags.
 440 See the section entitled
 441 .Sx "OPERATIONAL FLAGS"
 442 below for a discussion
 443 about its use.
 444 .It Fl l
 445 Restore partition labels for partitioning schemes that support them.
 446 .El
 447 .\" ==== SET ====
 448 .It Cm set
 449 Set the named attribute on the partition entry.
 450 See the section entitled
 451 .Sx ATTRIBUTES
 452 below for a list of available attributes.
 453 .Pp
 454 The
 455 .Cm set
 456 command accepts these options:
 457 .Bl -tag -width 10n
 458 .It Fl a Ar attrib
 459 Specifies the attribute to set.
 460 .It Fl f Ar flags
 461 Additional operational flags.
 462 See the section entitled
 463 .Sx "OPERATIONAL FLAGS"
 464 below for a discussion
 465 about its use.
 466 .It Fl i Ar index
 467 Specifies the index of the partition on which the attribute will be set.
 468 .El
 469 .\" ==== SHOW ====
 470 .It Cm show
 471 Show current partition information for the specified geoms, or all
 472 geoms if none are specified.
 473 The default output includes the logical starting block of each
 474 partition, the partition size in blocks, the partition index number,
 475 the partition type, and a human readable partition size.
 476 Block sizes and locations are based on the device's Sectorsize
 477 as shown by
 478 .Cm gpart list .
 479 .Pp
 480 The
 481 .Cm show
 482 command accepts these options:
 483 .Bl -tag -width 10n
 484 .It Fl l
 485 For partitioning schemes that support partition labels, print them
 486 instead of partition type.
 487 .It Fl p
 488 Show provider names instead of partition indexes.
 489 .It Fl r
 490 Show raw partition type instead of symbolic name.
 491 .El
 492 .\" ==== UNDO ====
 493 .It Cm undo
 494 Revert any pending changes for geom
 495 .Ar geom .
 496 This action is the opposite of the
 497 .Cm commit
 498 action and can be used to undo any changes that have not been committed.
 499 .\" ==== UNSET ====
 500 .It Cm unset
 501 Clear the named attribute on the partition entry.
 502 See the section entitled
 503 .Sx ATTRIBUTES
 504 below for a list of available attributes.
 505 .Pp
 506 The
 507 .Cm unset
 508 command accepts these options:
 509 .Bl -tag -width 10n
 510 .It Fl a Ar attrib
 511 Specifies the attribute to clear.
 512 .It Fl f Ar flags
 513 Additional operational flags.
 514 See the section entitled
 515 .Sx "OPERATIONAL FLAGS"
 516 below for a discussion
 517 about its use.
 518 .It Fl i Ar index
 519 Specifies the index of the partition on which the attribute will be cleared.
 520 .El
 521 .It Cm list
 522 See
 523 .Xr geom 8 .
 524 .It Cm status
 525 See
 526 .Xr geom 8 .
 527 .It Cm load
 528 See
 529 .Xr geom 8 .
 530 .It Cm unload
 531 See
 532 .Xr geom 8 .
 533 .El
 534 .Sh PARTITIONING SCHEMES
 535 Several partitioning schemes are supported by the
 536 .Nm
 537 utility:
 538 .Bl -tag -width ".Cm VTOC8"
 539 .It Cm APM
 540 Apple Partition Map, used by PowerPC(R) Macintosh(R) computers.
 541 Requires the
 542 .Cd GEOM_PART_APM
 543 kernel option.
 544 .It Cm BSD
 545 Traditional BSD disklabel, usually used to subdivide MBR partitions.
 546 .Po
 547 This scheme can also be used as the sole partitioning method, without
 548 an MBR.
 549 Partition editing tools from other operating systems often do not
 550 understand the bare disklabel partition layout, so this is sometimes
 551 called
 552 .Dq dangerously dedicated .
 553 .Pc
 554 Requires the
 555 .Cm GEOM_PART_BSD
 556 kernel option.
 557 .It Cm BSD64
 558 64-bit implementation of BSD disklabel used in DragonFlyBSD to subdivide MBR
 559 or GPT partitions.
 560 Requires the
 561 .Cm GEOM_PART_BSD64
 562 kernel option.
 563 .It Cm LDM
 564 The Logical Disk Manager is an implementation of volume manager for
 565 Microsoft Windows NT.
 566 Requires the
 567 .Cd GEOM_PART_LDM
 568 kernel option.
 569 .It Cm GPT
 570 GUID Partition Table is used on Intel-based Macintosh computers and
 571 gradually replacing MBR on most PCs and other systems.
 572 Requires the
 573 .Cm GEOM_PART_GPT
 574 kernel option.
 575 .It Cm MBR
 576 Master Boot Record is used on PCs and removable media.
 577 Requires the
 578 .Cm GEOM_PART_MBR
 579 kernel option.
 580 The
 581 .Cm GEOM_PART_EBR
 582 option adds support for the Extended Boot Record (EBR),
 583 which is used to define a logical partition.
 584 The
 585 .Cm GEOM_PART_EBR_COMPAT
 586 option enables backward compatibility for partition names
 587 in the EBR scheme.
 588 It also prevents any type of actions on such partitions.
 589 .It Cm VTOC8
 590 Sun's SMI Volume Table Of Contents, used by
 591 .Tn SPARC64
 592 and
 593 .Tn UltraSPARC
 594 computers.
 595 Requires the
 596 .Cm GEOM_PART_VTOC8
 597 kernel option.
 598 .El
 599 .Sh PARTITION TYPES
 600 Partition types are identified on disk by particular strings or magic
 601 values.
 602 The
 603 .Nm
 604 utility uses symbolic names for common partition types so the user
 605 does not need to know these values or other details of the partitioning
 606 scheme in question.
 607 The
 608 .Nm
 609 utility also allows the user to specify scheme-specific partition types
 610 for partition types that do not have symbolic names.
 611 Symbolic names currently understood and used by
 612 .Fx
 613 are:
 614 .Bl -tag -width ".Cm dragonfly-disklabel64"
 615 .It Cm apple-boot
 616 The system partition dedicated to storing boot loaders on some Apple
 617 systems.
 618 The scheme-specific types are
 619 .Qq Li "!171"
 620 for MBR,
 621 .Qq Li "!Apple_Bootstrap"
 622 for APM, and
 623 .Qq Li "!426f6f74-0000-11aa-aa11-00306543ecac"
 624 for GPT.
 625 .It Cm bios-boot
 626 The system partition dedicated to second stage of the boot loader program.
 627 Usually it is used by the GRUB 2 loader for GPT partitioning schemes.
 628 The scheme-specific type is
 629 .Qq Li "!21686148-6449-6E6F-744E-656564454649" .
 630 .It Cm efi
 631 The system partition for computers that use the Extensible Firmware
 632 Interface (EFI).
 633 The scheme-specific types are
 634 .Qq Li "!239"
 635 for MBR, and
 636 .Qq Li "!c12a7328-f81f-11d2-ba4b-00a0c93ec93b"
 637 for GPT.
 638 .It Cm freebsd
 639 A
 640 .Fx
 641 partition subdivided into filesystems with a
 642 .Bx
 643 disklabel.
 644 This is a legacy partition type and should not be used for the APM
 645 or GPT schemes.
 646 The scheme-specific types are
 647 .Qq Li "!165"
 648 for MBR,
 649 .Qq Li "!FreeBSD"
 650 for APM, and
 651 .Qq Li "!516e7cb4-6ecf-11d6-8ff8-00022d09712b"
 652 for GPT.
 653 .It Cm freebsd-boot
 654 A
 655 .Fx
 656 partition dedicated to bootstrap code.
 657 The scheme-specific type is
 658 .Qq Li "!83bd6b9d-7f41-11dc-be0b-001560b84f0f"
 659 for GPT.
 660 .It Cm freebsd-swap
 661 A
 662 .Fx
 663 partition dedicated to swap space.
 664 The scheme-specific types are
 665 .Qq Li "!FreeBSD-swap"
 666 for APM,
 667 .Qq Li "!516e7cb5-6ecf-11d6-8ff8-00022d09712b"
 668 for GPT, and tag 0x0901 for VTOC8.
 669 .It Cm freebsd-ufs
 670 A
 671 .Fx
 672 partition that contains a UFS or UFS2 filesystem.
 673 The scheme-specific types are
 674 .Qq Li "!FreeBSD-UFS"
 675 for APM,
 676 .Qq Li "!516e7cb6-6ecf-11d6-8ff8-00022d09712b"
 677 for GPT, and tag 0x0902 for VTOC8.
 678 .It Cm freebsd-vinum
 679 A
 680 .Fx
 681 partition that contains a Vinum volume.
 682 The scheme-specific types are
 683 .Qq Li "!FreeBSD-Vinum"
 684 for APM,
 685 .Qq Li "!516e7cb8-6ecf-11d6-8ff8-00022d09712b"
 686 for GPT, and tag 0x0903 for VTOC8.
 687 .It Cm freebsd-zfs
 688 A
 689 .Fx
 690 partition that contains a ZFS volume.
 691 The scheme-specific types are
 692 .Qq Li "!FreeBSD-ZFS"
 693 for APM,
 694 .Qq Li "!516e7cba-6ecf-11d6-8ff8-00022d09712b"
 695 for GPT, and 0x0904 for VTOC8.
 696 .El
 697 .Pp
 698 Another symbolic names that can be used with
 699 .Cm gpart
 700 utility are:
 701 .Bl -tag -width ".Cm dragonfly-disklabel64"
 702 .It Cm apple-apfs
 703 An Apple macOS partition used for the Apple file system, APFS.
 704 .It Cm apple-core-storage
 705 An Apple Mac OS X partition used by logical volume manager known as
 706 Core Storage.
 707 The scheme-specific type is
 708 .Qq Li "!53746f72-6167-11aa-aa11-00306543ecac"
 709 for GPT.
 710 .It Cm apple-hfs
 711 An Apple Mac OS X partition that contains a HFS or HFS+ filesystem.
 712 The scheme-specific types are
 713 .Qq Li "!175"
 714 for MBR,
 715 .Qq Li "!Apple_HFS"
 716 for APM and
 717 .Qq Li "!48465300-0000-11aa-aa11-00306543ecac"
 718 for GPT.
 719 .It Cm apple-label
 720 An Apple Mac OS X partition dedicated to partition metadata that descibes
 721 disk device.
 722 The scheme-specific type is
 723 .Qq Li "!4c616265-6c00-11aa-aa11-00306543ecac"
 724 for GPT.
 725 .It Cm apple-raid
 726 An Apple Mac OS X partition used in a software RAID configuration.
 727 The scheme-specific type is
 728 .Qq Li "!52414944-0000-11aa-aa11-00306543ecac"
 729 for GPT.
 730 .It Cm apple-raid-offline
 731 An Apple Mac OS X partition used in a software RAID configuration.
 732 The scheme-specific type is
 733 .Qq Li "!52414944-5f4f-11aa-aa11-00306543ecac"
 734 for GPT.
 735 .It Cm apple-tv-recovery
 736 An Apple Mac OS X partition used by Apple TV.
 737 The scheme-specific type is
 738 .Qq Li "!5265636f-7665-11aa-aa11-00306543ecac"
 739 for GPT.
 740 .It Cm apple-ufs
 741 An Apple Mac OS X partition that contains a UFS filesystem.
 742 The scheme-specific types are
 743 .Qq Li "!168"
 744 for MBR,
 745 .Qq Li "!Apple_UNIX_SVR2"
 746 for APM and
 747 .Qq Li "!55465300-0000-11aa-aa11-00306543ecac"
 748 for GPT.
 749 .It Cm dragonfly-label32
 750 A DragonFlyBSD partition subdivided into filesystems with a
 751 .Bx
 752 disklabel.
 753 The scheme-specific type is
 754 .Qq Li "!9d087404-1ca5-11dc-8817-01301bb8a9f5"
 755 for GPT.
 756 .It Cm dragonfly-label64
 757 A DragonFlyBSD partition subdivided into filesystems with a
 758 disklabel64.
 759 The scheme-specific type is
 760 .Qq Li "!3d48ce54-1d16-11dc-8696-01301bb8a9f5"
 761 for GPT.
 762 .It Cm dragonfly-legacy
 763 A legacy partition type used in DragonFlyBSD.
 764 The scheme-specific type is
 765 .Qq Li "!bd215ab2-1d16-11dc-8696-01301bb8a9f5"
 766 for GPT.
 767 .It Cm dragonfly-ccd
 768 A DragonFlyBSD partition used with Concatenated Disk driver.
 769 The scheme-specific type is
 770 .Qq Li "!dbd5211b-1ca5-11dc-8817-01301bb8a9f5"
 771 for GPT.
 772 .It Cm dragonfly-hammer
 773 A DragonFlyBSD partition that contains a Hammer filesystem.
 774 The scheme-specific type is
 775 .Qq Li "!61dc63ac-6e38-11dc-8513-01301bb8a9f5"
 776 for GPT.
 777 .It Cm dragonfly-hammer2
 778 A DragonFlyBSD partition that contains a Hammer2 filesystem.
 779 The scheme-specific type is
 780 .Qq Li "!5cbb9ad1-862d-11dc-a94d-01301bb8a9f5"
 781 for GPT.
 782 .It Cm dragonfly-swap
 783 A DragonFlyBSD partition dedicated to swap space.
 784 The scheme-specific type is
 785 .Qq Li "!9d58fdbd-1ca5-11dc-8817-01301bb8a9f5"
 786 for GPT.
 787 .It Cm dragonfly-ufs
 788 A DragonFlyBSD partition that contains an UFS1 filesystem.
 789 The scheme-specific type is
 790 .Qq Li "!9d94ce7c-1ca5-11dc-8817-01301bb8a9f5"
 791 for GPT.
 792 .It Cm dragonfly-vinum
 793 A DragonFlyBSD partition used with Logical Volume Manager.
 794 The scheme-specific type is
 795 .Qq Li "!9dd4478f-1ca5-11dc-8817-01301bb8a9f5"
 796 for GPT.
 797 .It Cm ebr
 798 A partition subdivided into filesystems with a EBR.
 799 The scheme-specific type is
 800 .Qq Li "!5"
 801 for MBR.
 802 .It Cm fat16
 803 A partition that contains a FAT16 filesystem.
 804 The scheme-specific type is
 805 .Qq Li "!6"
 806 for MBR.
 807 .It Cm fat32
 808 A partition that contains a FAT32 filesystem.
 809 The scheme-specific type is
 810 .Qq Li "!11"
 811 for MBR.
 812 .It Cm fat32lba
 813 A partition that contains a FAT32 (LBA) filesystem.
 814 The scheme-specific type is
 815 .Qq Li "!12"
 816 for MBR.
 817 .It Cm linux-data
 818 A Linux partition that contains some filesystem with data.
 819 The scheme-specific types are
 820 .Qq Li "!131"
 821 for MBR and
 822 .Qq Li "!0fc63daf-8483-4772-8e79-3d69d8477de4"
 823 for GPT.
 824 .It Cm linux-lvm
 825 A Linux partition dedicated to Logical Volume Manager.
 826 The scheme-specific types are
 827 .Qq Li "!142"
 828 for MBR and
 829 .Qq Li "!e6d6d379-f507-44c2-a23c-238f2a3df928"
 830 for GPT.
 831 .It Cm linux-raid
 832 A Linux partition used in a software RAID configuration.
 833 The scheme-specific types are
 834 .Qq Li "!253"
 835 for MBR and
 836 .Qq Li "!a19d880f-05fc-4d3b-a006-743f0f84911e"
 837 for GPT.
 838 .It Cm linux-swap
 839 A Linux partition dedicated to swap space.
 840 The scheme-specific types are
 841 .Qq Li "!130"
 842 for MBR and
 843 .Qq Li "!0657fd6d-a4ab-43c4-84e5-0933c84b4f4f"
 844 for GPT.
 845 .It Cm mbr
 846 A partition that is sub-partitioned by a Master Boot Record (MBR).
 847 This type is known as
 848 .Qq Li "!024dee41-33e7-11d3-9d69-0008c781f39f"
 849 by GPT.
 850 .It Cm ms-basic-data
 851 A basic data partition (BDP) for Microsoft operating systems.
 852 In the GPT this type is the equivalent to partition types
 853 .Cm fat16 , fat32
 854 and
 855 .Cm ntfs
 856 in MBR.
 857 The scheme-specific type is
 858 .Qq Li "!ebd0a0a2-b9e5-4433-87c0-68b6b72699c7"
 859 for GPT.
 860 .It Cm ms-ldm-data
 861 A partition that contains Logical Disk Manager (LDM) volumes.
 862 The scheme-specific types are
 863 .Qq Li "!66"
 864 for MBR,
 865 .Qq Li "!af9b60a0-1431-4f62-bc68-3311714a69ad"
 866 for GPT.
 867 .It Cm ms-ldm-metadata
 868 A partition that contains Logical Disk Manager (LDM) database.
 869 The scheme-specific type is
 870 .Qq Li "!5808c8aa-7e8f-42e0-85d2-e1e90434cfb3"
 871 for GPT.
 872 .It Cm netbsd-ccd
 873 A NetBSD partition used with Concatenated Disk driver.
 874 The scheme-specific type is
 875 .Qq Li "!2db519c4-b10f-11dc-b99b-0019d1879648"
 876 for GPT.
 877 .It Cm netbsd-cgd
 878 An encrypted NetBSD partition.
 879 The scheme-specific type is
 880 .Qq Li "!2db519ec-b10f-11dc-b99b-0019d1879648"
 881 for GPT.
 882 .It Cm netbsd-ffs
 883 A NetBSD partition that contains an UFS filesystem.
 884 The scheme-specific type is
 885 .Qq Li "!49f48d5a-b10e-11dc-b99b-0019d1879648"
 886 for GPT.
 887 .It Cm netbsd-lfs
 888 A NetBSD partition that contains an LFS filesystem.
 889 The scheme-specific type is
 890 .Qq Li "!49f48d82-b10e-11dc-b99b-0019d1879648"
 891 for GPT.
 892 .It Cm netbsd-raid
 893 A NetBSD partition used in a software RAID configuration.
 894 The scheme-specific type is
 895 .Qq Li "!49f48daa-b10e-11dc-b99b-0019d1879648"
 896 for GPT.
 897 .It Cm netbsd-swap
 898 A NetBSD partition dedicated to swap space.
 899 The scheme-specific type is
 900 .Qq Li "!49f48d32-b10e-11dc-b99b-0019d1879648"
 901 for GPT.
 902 .It Cm ntfs
 903 A partition that contains a NTFS or exFAT filesystem.
 904 The scheme-specific type is
 905 .Qq Li "!7"
 906 for MBR.
 907 .It Cm prep-boot
 908 The system partition dedicated to storing boot loaders on some PowerPC systems,
 909 notably those made by IBM.
 910 The scheme-specific types are
 911 .Qq Li "!65"
 912 for MBR and
 913 .Qq Li "!0x9e1a2d38-c612-4316-aa26-8b49521e5a8b"
 914 for GPT.
 915 .It Cm vmware-vmfs
 916 A partition that contains a VMware File System (VMFS).
 917 The scheme-specific types are
 918 .Qq Li "!251"
 919 for MBR and
 920 .Qq Li "!aa31e02a-400f-11db-9590-000c2911d1b8"
 921 for GPT.
 922 .It Cm vmware-vmkdiag
 923 A partition that contains a VMware diagostic filesystem.
 924 The scheme-specific types are
 925 .Qq Li "!252"
 926 for MBR and
 927 .Qq Li "!9d275380-40ad-11db-bf97-000c2911d1b8"
 928 for GPT.
 929 .It Cm vmware-reserved
 930 A VMware reserved partition.
 931 The scheme-specific type is
 932 .Qq Li "!9198effc-31c0-11db-8f-78-000c2911d1b8"
 933 for GPT.
 934 .It Cm vmware-vsanhdr
 935 A partition claimed by VMware VSAN.
 936 The scheme-specific type is
 937 .Qq Li "!381cfccc-7288-11e0-92ee-000c2911d0b2"
 938 for GPT.
 939 .El
 940 .Sh ATTRIBUTES
 941 The scheme-specific attributes for EBR:
 942 .Bl -tag -width ".Cm active"
 943 .It Cm active
 944 .El
 945 .Pp
 946 The scheme-specific attributes for GPT:
 947 .Bl -tag -width ".Cm bootfailed"
 948 .It Cm bootme
 949 When set, the
 950 .Nm gptboot
 951 stage 1 boot loader will try to boot the system from this partition.
 952 Multiple partitions can be marked with the
 953 .Cm bootme
 954 attribute.
 955 See
 956 .Xr gptboot 8
 957 for more details.
 958 .It Cm bootonce
 959 Setting this attribute automatically sets the
 960 .Cm bootme
 961 attribute.
 962 When set, the
 963 .Nm gptboot
 964 stage 1 boot loader will try to boot the system from this partition only once.
 965 Multiple partitions can be marked with the
 966 .Cm bootonce
 967 and
 968 .Cm bootme
 969 attribute pairs.
 970 See
 971 .Xr gptboot 8
 972 for more details.
 973 .It Cm bootfailed
 974 This attribute should not be manually managed.
 975 It is managed by the
 976 .Nm gptboot
 977 stage 1 boot loader and the
 978 .Pa /etc/rc.d/gptboot
 979 start-up script.
 980 See
 981 .Xr gptboot 8
 982 for more details.
 983 .It Cm lenovofix
 984 Setting this attribute overwrites the Protective MBR with a new one where
 985 the 0xee partition is the second, rather than the first record.
 986 This resolves a BIOS compatibility issue with some Lenovo models including the
 987 X220, T420, and T520, allowing them to boot from GPT partitioned disks
 988 without using EFI.
 989 .El
 990 .Pp
 991 The scheme-specific attributes for MBR:
 992 .Bl -tag -width ".Cm active"
 993 .It Cm active
 994 .El
 995 .Sh BOOTSTRAPPING
 996 .Fx
 997 supports several partitioning schemes and each scheme uses different
 998 bootstrap code.
 999 The bootstrap code is located in a specific disk area for each partitioning
1000 scheme, and may vary in size for different schemes.
1001 .Pp
1002 Bootstrap code can be separated into two types.
1003 The first type is embedded in the partitioning scheme's metadata, while the
1004 second type is located on a specific partition.
1005 Embedding bootstrap code should only be done with the
1006 .Cm gpart bootcode
1007 command with the
1008 .Fl b Ar bootcode
1009 option.
1010 The GEOM PART class knows how to safely embed bootstrap code into
1011 specific partitioning scheme metadata without causing any damage.
1012 .Pp
1013 The Master Boot Record (MBR) uses a 512-byte bootstrap code image, embedded
1014 into the partition table's metadata area.
1015 There are two variants of this bootstrap code:
1016 .Pa /boot/mbr
1017 and
1018 .Pa /boot/boot0 .
1019 .Pa /boot/mbr
1020 searches for a partition with the
1021 .Cm active
1022 attribute (see the
1023 .Sx ATTRIBUTES
1024 section) in the partition table.
1025 Then it runs next bootstrap stage.
1026 The
1027 .Pa /boot/boot0
1028 image contains a boot manager with some additional interactive functions
1029 for multi-booting from a user-selected partition.
1030 .Pp
1031 A BSD disklabel is usually created inside an MBR partition (slice)
1032 with type
1033 .Cm freebsd
1034 (see the
1035 .Sx "PARTITION TYPES"
1036 section).
1037 It uses 8 KB size bootstrap code image
1038 .Pa /boot/boot ,
1039 embedded into the partition table's metadata area.
1040 .Pp
1041 Both types of bootstrap code are used to boot from the GUID Partition Table.
1042 First, a protective MBR is embedded into the first disk sector from the
1043 .Pa /boot/pmbr
1044 image.
1045 It searches through the GPT for a
1046 .Cm freebsd-boot
1047 partition (see the
1048 .Sx "PARTITION TYPES"
1049 section) and runs the next bootstrap stage from it.
1050 The
1051 .Cm freebsd-boot
1052 partition should be smaller than 545 KB.
1053 It can be located either before or after other
1054 .Fx
1055 partitions on the disk.
1056 There are two variants of bootstrap code to write to this partition:
1057 .Pa /boot/gptboot
1058 and
1059 .Pa /boot/gptzfsboot .
1060 .Pp
1061 .Pa /boot/gptboot
1062 is used to boot from UFS partitions.
1063 .Cm gptboot
1064 searches through
1065 .Cm freebsd-ufs
1066 partitions in the GPT and selects one to boot based on the
1067 .Cm bootonce
1068 and
1069 .Cm bootme
1070 attributes.
1071 If neither attribute is found,
1072 .Pa /boot/gptboot
1073 boots from the first
1074 .Cm freebsd-ufs
1075 partition.
1076 .Pa /boot/loader
1077 .Pq the third bootstrap stage
1078 is loaded from the first partition that matches these conditions.
1079 See
1080 .Xr gptboot 8
1081 for more information.
1082 .Pp
1083 .Pa /boot/gptzfsboot
1084 is used to boot from ZFS.
1085 It searches through the GPT for
1086 .Cm freebsd-zfs
1087 partitions, trying to detect ZFS pools.
1088 After all pools are detected,
1089 .Pa /boot/zfsloader
1090 is started from the first one found.
1091 .Pp
1092 The VTOC8 scheme does not support embedding bootstrap code.
1093 Instead, the 8 KBytes bootstrap code image
1094 .Pa /boot/boot1
1095 should be written with the
1096 .Cm gpart bootcode
1097 command with the
1098 .Fl p Ar bootcode
1099 option to all sufficiently large VTOC8 partitions.
1100 To do this the
1101 .Fl i Ar index
1102 option could be omitted.
1103 .Pp
1104 The APM scheme also does not support embedding bootstrap code.
1105 Instead, the 800 KBytes bootstrap code image
1106 .Pa /boot/boot1.hfs
1107 should be written with the
1108 .Cm gpart bootcode
1109 command to a partition of type
1110 .Cm apple-boot ,
1111 which should also be 800 KB in size.
1112 .Sh OPERATIONAL FLAGS
1113 Actions other than the
1114 .Cm commit
1115 and
1116 .Cm undo
1117 actions take an optional
1118 .Fl f Ar flags
1119 option.
1120 This option is used to specify action-specific operational flags.
1121 By default, the
1122 .Nm
1123 utility defines the
1124 .Ql C
1125 flag so that the action is immediately
1126 committed.
1127 The user can specify
1128 .Dq Fl f Cm x
1129 to have the action result in a pending change that can later, with
1130 other pending changes, be committed as a single compound change with
1131 the
1132 .Cm commit
1133 action or reverted with the
1134 .Cm undo
1135 action.
1136 .Sh RECOVERING
1137 The GEOM PART class supports recovering of partition tables only for GPT.
1138 The GPT primary metadata is stored at the beginning of the device.
1139 For redundancy, a secondary
1140 .Pq backup
1141 copy of the metadata is stored at the end of the device.
1142 As a result of having two copies, some corruption of metadata is not
1143 fatal to the working of GPT.
1144 When the kernel detects corrupt metadata, it marks this table as corrupt
1145 and reports the problem.
1146 .Cm destroy
1147 and
1148 .Cm recover
1149 are the only operations allowed on corrupt tables.
1150 .Pp
1151 If one GPT header appears to be corrupt but the other copy remains intact,
1152 the kernel will log the following:
1153 .Bd -literal -offset indent
1154 GEOM: provider: the primary GPT table is corrupt or invalid.
1155 GEOM: provider: using the secondary instead -- recovery strongly advised.
1156 .Ed
1157 .Pp
1158 or
1159 .Bd -literal -offset indent
1160 GEOM: provider: the secondary GPT table is corrupt or invalid.
1161 GEOM: provider: using the primary only -- recovery suggested.
1162 .Ed
1163 .Pp
1164 Also
1165 .Nm
1166 commands such as
1167 .Cm show , status
1168 and
1169 .Cm list
1170 will report about corrupt tables.
1171 .Pp
1172 If the size of the device has changed (e.g.,\& volume expansion) the
1173 secondary GPT header will no longer be located in the last sector.
1174 This is not a metadata corruption, but it is dangerous because any
1175 corruption of the primary GPT will lead to loss of the partition table.
1176 This problem is reported by the kernel with the message:
1177 .Bd -literal -offset indent
1178 GEOM: provider: the secondary GPT header is not in the last LBA.
1179 .Ed
1180 .Pp
1181 This situation can be recovered with the
1182 .Cm recover
1183 command.
1184 This command reconstructs the corrupt metadata using known valid
1185 metadata and relocates the secondary GPT to the end of the device.
1186 .Pp
1187 .Em NOTE :
1188 The GEOM PART class can detect the same partition table visible through
1189 different GEOM providers, and some of them will be marked as corrupt.
1190 Be careful when choosing a provider for recovery.
1191 If you choose incorrectly you can destroy the metadata of another GEOM class,
1192 e.g.,\& GEOM MIRROR or GEOM LABEL.
1193 .Sh SYSCTL VARIABLES
1194 The following
1195 .Xr sysctl 8
1196 variables can be used to control the behavior of the
1197 .Nm PART
1198 GEOM class.
1199 The default value is shown next to each variable.
1200 .Bl -tag -width indent
1201 .It Va kern.geom.part.auto_resize: No 1
1202 This variable controls automatic resize behavior of
1203 .Nm
1204 GEOM class.
1205 When this variable is enable and new size of provider is detected, the schema
1206 metadata is resized but all changes are not saved to disk, until
1207 .Cm gpart commit
1208 is run to confirm changes.
1209 This behavior is also reported with diagnostic message:
1210 .Sy "GEOM_PART: (provider) was automatically resized."
1211 .Sy "Use `gpart commit (provider)` to save changes or `gpart undo (provider)`"
1212 .Sy "to revert them."
1213 .It Va kern.geom.part.check_integrity : No 1
1214 This variable controls the behaviour of metadata integrity checks.
1215 When integrity checks are enabled, the
1216 .Nm PART
1217 GEOM class verifies all generic partition parameters obtained from the
1218 disk metadata.
1219 If some inconsistency is detected, the partition table will be
1220 rejected with a diagnostic message:
1221 .Sy "GEOM_PART: Integrity check failed (provider, scheme)" .
1222 .It Va kern.geom.part.ldm.debug : No 0
1223 Debug level of the Logical Disk Manager (LDM) module.
1224 This can be set to a number between 0 and 2 inclusive.
1225 If set to 0 minimal debug information is printed,
1226 and if set to 2 the maximum amount of debug information is printed.
1227 .It Va kern.geom.part.ldm.show_mirrors : No 0
1228 This variable controls how the Logical Disk Manager (LDM) module handles
1229 mirrored volumes.
1230 By default mirrored volumes are shown as partitions with type
1231 .Cm ms-ldm-data
1232 (see the
1233 .Sx "PARTITION TYPES"
1234 section).
1235 If this variable set to 1 each component of the mirrored volume will be
1236 present as independent partition.
1237 .Em NOTE :
1238 This may break a mirrored volume and lead to data damage.
1239 .It Va kern.geom.part.mbr.enforce_chs : No 0
1240 Specify how the Master Boot Record (MBR) module does alignment.
1241 If this variable is set to a non-zero value, the module will automatically
1242 recalculate the user-specified offset and size for alignment with the CHS
1243 geometry.
1244 Otherwise the values will be left unchanged.
1245 .El
1246 .Sh EXIT STATUS
1247 Exit status is 0 on success, and 1 if the command fails.
1248 .Sh EXAMPLES
1249 The examples below assume that the disk's logical block size is 512
1250 bytes, regardless of its physical block size.
1251 .Ss GPT
1252 In this example, we will format
1253 .Pa ada0
1254 with the GPT scheme and create boot, swap and root partitions.
1255 First, we need to create the partition table:
1256 .Bd -literal -offset indent
1257 /sbin/gpart create -s GPT ada0
1258 .Ed
1259 .Pp
1260 Next, we install a protective MBR with the first-stage bootstrap code.
1261 The protective MBR lists a single, bootable partition spanning the
1262 entire disk, thus allowing non-GPT-aware BIOSes to boot from the disk
1263 and preventing tools which do not understand the GPT scheme from
1264 considering the disk to be unformatted.
1265 .Bd -literal -offset indent
1266 /sbin/gpart bootcode -b /boot/pmbr ada0
1267 .Ed
1268 .Pp
1269 We then create a dedicated
1270 .Cm freebsd-boot
1271 partition to hold the second-stage boot loader, which will load the
1272 .Fx
1273 kernel and modules from a UFS or ZFS filesystem.
1274 This partition must be larger than the bootstrap code
1275 .Po
1276 either
1277 .Pa /boot/gptboot
1278 for UFS or
1279 .Pa /boot/gptzfsboot
1280 for ZFS
1281 .Pc ,
1282 but smaller than 545 kB since the first-stage loader will load the
1283 entire partition into memory during boot, regardless of how much data
1284 it actually contains.
1285 We create a 472-block (236 kB) boot partition at offset 40, which is
1286 the size of the partition table (34 blocks or 17 kB) rounded up to the
1287 nearest 4 kB boundary.
1288 .Bd -literal -offset indent
1289 /sbin/gpart add -b 40 -s 472 -t freebsd-boot ada0
1290 /sbin/gpart bootcode -p /boot/gptboot -i 1 ada0
1291 .Ed
1292 .Pp
1293 We now create a 4 GB swap partition at the first available offset,
1294 which is 40 + 472 = 512 blocks (256 kB).
1295 .Bd -literal -offset indent
1296 /sbin/gpart add -s 4G -t freebsd-swap ada0
1297 .Ed
1298 .Pp
1299 Aligning the swap partition and all subsequent partitions on a 256 kB
1300 boundary ensures optimal performance on a wide range of media, from
1301 plain old disks with 512-byte blocks, through modern
1302 .Dq advanced format
1303 disks with 4096-byte physical blocks, to RAID volumes with stripe
1304 sizes of up to 256 kB.
1305 .Pp
1306 Finally, we create and format an 8 GB
1307 .Cm freebsd-ufs
1308 partition for the root filesystem, leaving the rest of the slice free
1309 for additional filesystems:
1310 .Bd -literal -offset indent
1311 /sbin/gpart add -s 8G -t freebsd-ufs ada0
1312 /sbin/newfs -Uj /dev/ada0p3
1313 .Ed
1314 .Ss MBR
1315 In this example, we will format
1316 .Pa ada0
1317 with the MBR scheme and create a single partition which we subdivide
1318 using a traditional
1319 .Bx
1320 disklabel.
1321 .Pp
1322 First, we create the partition table and a single 64 GB partition,
1323 then we mark that partition active (bootable) and install the
1324 first-stage boot loader:
1325 .Bd -literal -offset indent
1326 /sbin/gpart create -s MBR ada0
1327 /sbin/gpart add -t freebsd -s 64G ada0
1328 /sbin/gpart set -a active -i 1 ada0
1329 /sbin/gpart bootcode -b /boot/boot0 ada0
1330 .Ed
1331 .Pp
1332 Next, we create a disklabel in that partition
1333 .Po
1334 .Dq slice
1335 in disklabel terminology
1336 .Pc
1337 with room for up to 20 partitions:
1338 .Bd -literal -offset indent
1339 /sbin/gpart create -s BSD -n 20 ada0s1
1340 .Ed
1341 .Pp
1342 We then create an 8 GB root partition and a 4 GB swap partition:
1343 .Bd -literal -offset indent
1344 /sbin/gpart add -t freebsd-ufs -s 8G ada0s1
1345 /sbin/gpart add -t freebsd-swap -s 4G ada0s1
1346 .Ed
1347 .Pp
1348 Finally, we install the appropriate boot loader for the
1349 .Bx
1350 label:
1351 .Bd -literal -offset indent
1352 /sbin/gpart bootcode -b /boot/boot ada0s1
1353 .Ed
1354 .Ss VTOC8
1355 .Pp
1356 Create a VTOC8 scheme on
1357 .Pa da0 :
1358 .Bd -literal -offset indent
1359 /sbin/gpart create -s VTOC8 da0
1360 .Ed
1361 .Pp
1362 Create a 512MB-sized
1363 .Cm freebsd-ufs
1364 partition to contain a UFS filesystem from which the system can boot.
1365 .Bd -literal -offset indent
1366 /sbin/gpart add -s 512M -t freebsd-ufs da0
1367 .Ed
1368 .Pp
1369 Create a 15GB-sized
1370 .Cm freebsd-ufs
1371 partition to contain a UFS filesystem and aligned on 4KB boundaries:
1372 .Bd -literal -offset indent
1373 /sbin/gpart add -s 15G -t freebsd-ufs -a 4k da0
1374 .Ed
1375 .Pp
1376 After creating all required partitions, embed bootstrap code into them:
1377 .Bd -literal -offset indent
1378 /sbin/gpart bootcode -p /boot/boot1 da0
1379 .Ed
1380 .Ss Deleting Partitions and Destroying the Partitioning Scheme
1381 If a
1382 .Em "Device busy"
1383 error is shown when trying to destroy a partition table, remember that
1384 all of the partitions must be deleted first with the
1385 .Cm delete
1386 action.
1387 In this example,
1388 .Pa da0
1389 has three partitions:
1390 .Bd -literal -offset indent
1391 /sbin/gpart delete -i 3 da0
1392 /sbin/gpart delete -i 2 da0
1393 /sbin/gpart delete -i 1 da0
1394 /sbin/gpart destroy da0
1395 .Ed
1396 .Pp
1397 Rather than deleting each partition and then destroying the partitioning
1398 scheme, the
1399 .Fl F
1400 option can be given with
1401 .Cm destroy
1402 to delete all of the partitions before destroying the partitioning scheme.
1403 This is equivalent to the previous example:
1404 .Bd -literal -offset indent
1405 /sbin/gpart destroy -F da0
1406 .Ed
1407 .Ss Backup and Restore
1408 .Pp
1409 Create a backup of the partition table from
1410 .Pa da0 :
1411 .Bd -literal -offset indent
1412 /sbin/gpart backup da0 > da0.backup
1413 .Ed
1414 .Pp
1415 Restore the partition table from the backup to
1416 .Pa da0 :
1417 .Bd -literal -offset indent
1418 /sbin/gpart restore -l da0 < /mnt/da0.backup
1419 .Ed
1420 .Pp
1421 Clone the partition table from
1422 .Pa ada0
1423 to
1424 .Pa ada1
1425 and
1426 .Pa ada2 :
1427 .Bd -literal -offset indent
1428 /sbin/gpart backup ada0 | /sbin/gpart restore -F ada1 ada2
1429 .Ed
1430 .Sh SEE ALSO
1431 .Xr geom 4 ,
1432 .Xr boot0cfg 8 ,
1433 .Xr geom 8 ,
1434 .Xr gptboot 8
1435 .Sh HISTORY
1436 The
1437 .Nm
1438 utility appeared in
1439 .Fx 7.0 .
1440 .Sh AUTHORS
1441 .An Marcel Moolenaar Aq Mt marcel@FreeBSD.org