1.\" Copyright (c) 1987, 1988, 1991, 1993 2.\" The Regents of the University of California. All rights reserved. 3.\" 4.\" This code is derived from software contributed to Berkeley by 5.\" Symmetric Computer Systems. 6.\" 7.\" Redistribution and use in source and binary forms, with or without 8.\" modification, are permitted provided that the following conditions 9.\" are met: 10.\" 1. Redistributions of source code must retain the above copyright 11.\" notice, this list of conditions and the following disclaimer. 12.\" 2. Redistributions in binary form must reproduce the above copyright 13.\" notice, this list of conditions and the following disclaimer in the 14.\" documentation and/or other materials provided with the distribution. 15.\" 3. All advertising materials mentioning features or use of this software 16.\" must display the following acknowledgment: 17.\" This product includes software developed by the University of 18.\" California, Berkeley and its contributors. 19.\" 4. Neither the name of the University nor the names of its contributors 20.\" may be used to endorse or promote products derived from this software 21.\" without specific prior written permission. 22.\" 23.\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND 24.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE 25.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE 26.\" ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE 27.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL 28.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS 29.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) 30.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT 31.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY 32.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF 33.\" SUCH DAMAGE. 34.\" 35.\" @(#)disklabel.8 8.2 (Berkeley) 4/19/94 36.\" $FreeBSD: src/sbin/disklabel/disklabel.8,v 1.15.2.22 2003/04/17 17:56:34 trhodes Exp $ 37.\" $DragonFly: src/sbin/disklabel64/disklabel64.8,v 1.13 2008/09/16 20:45:36 thomas Exp $ 38.\" 39.Dd September 28, 2009 40.Dt DISKLABEL64 8 41.Os 42.Sh NAME 43.Nm disklabel64 44.Nd read and write 64 bit disk pack label 45.Sh SYNOPSIS 46.Nm 47.Op Fl r 48.Ar disk 49.Nm 50.Fl w 51.Op Fl r 52.Op Fl n 53.Ar disk Ar disktype Ns / Ns Cm auto 54.Oo Ar packid Oc 55.Nm 56.Fl e 57.Op Fl r 58.Op Fl n 59.Ar disk 60.Nm 61.Fl R 62.Op Fl r 63.Op Fl n 64.Ar disk Ar protofile 65.Nm 66.Op Fl NW 67.Ar disk 68.Pp 69.Nm 70.Fl B 71.Oo 72.Fl b Ar boot1 73.Fl s Ar boot2 74.Oc 75.Ar disk 76.Oo Ar disktype Ns / Ns Cm auto Oc 77.Nm 78.Fl w 79.Fl B 80.Op Fl n 81.Oo 82.Fl b Ar boot1 83.Fl s Ar boot2 84.Oc 85.Ar disk Ar disktype Ns / Ns Cm auto 86.Oo Ar packid Oc 87.Nm 88.Fl R 89.Fl B 90.Op Fl n 91.Oo 92.Fl b Ar boot1 93.Fl s Ar boot2 94.Oc 95.Ar disk Ar protofile 96.Oo Ar disktype Ns / Ns Cm auto Oc 97.Sh DESCRIPTION 98The 99.Nm 100utility 101installs, examines or modifies a 64 bit label on a disk drive or pack. 102When writing 103the label, it can be used to change the drive identification, the disk 104partitions on the drive, or to replace a damaged label. 105There are several forms 106of the command that read (display), install or edit the label on a disk. 107In 108addition, 109.Nm 110can install bootstrap code. 111.Ss Raw or in-core label 112The disk label resides close to or at the beginning of each disk slice. 113For faster access, the kernel maintains a copy in core at all times. 114By 115default, most forms of the 116.Nm 117command access the in-core copy of the label. 118To access the raw (on-disk) 119copy, use the 120.Fl r 121option. 122This option allows a label to be installed on a disk without kernel 123support for a label, such as when labels are first installed on a system; it 124must be used when first installing a label on a disk. 125The specific effect of 126.Fl r 127is described under each command. 128.Ss Disk device name 129All 130.Nm 131forms require a disk device name, which should always be the raw 132device name representing the disk or slice. 133.Dx 134uses the following scheme for slice numbering: 135If the disk doesn't use GPT (typically laid out by 136.Xr gpt 8 ) , 137but e.g.\& MBR (typically laid out by 138.Xr fdisk 8 ) , 139then slice 0, e.g.\& 140.Pa da0s0 , 141represents the entire disk regardless of any DOS partitioning. 142Slice 0 is called the compatibility slice, 143and slice 1 and onward, e.g.\& 144.Pa da0s1 , 145represents a 146.Bx 147slice. 148If the disk does use GPT, then all slices are 149.Bx 150slices, slice 0 isn't special, it is just the first slice on the disk. 151You do not have to include the 152.Pa /dev/ 153path prefix when specifying the device. 154The 155.Nm 156utility will automatically prepend it. 157.Ss Reading the disk label 158To examine the label on a disk drive, use 159.Nm 160without options: 161.Pp 162.Nm 163.Op Fl r 164.Ar disk 165.Pp 166.Ar disk 167represents the raw disk in question, and may be in the form 168.Pa da0s1 169or 170.Pa /dev/da0s1 . 171It will display all of the parameters associated with the drive and its 172partition layout. 173Unless the 174.Fl r 175flag is given, 176the kernel's in-core copy of the label is displayed; 177if the disk has no label, or the partition types on the disk are incorrect, 178the kernel may have constructed or modified the label. 179If the 180.Fl r 181flag is given, 182.Nm 183reads the label from the raw disk and displays it. 184Both versions are usually 185identical except in the case where a label has not yet been initialized or 186is corrupt. 187.Ss Writing a standard label 188To write a standard label, use the form 189.Pp 190.Nm 191.Fl w 192.Op Fl r 193.Op Fl n 194.Ar disk Ar disktype Ns / Ns Cm auto 195.Oo Ar packid Oc 196.Pp 197The required arguments to 198.Nm 199are the drive to be labeled and the drive type as described in the 200.Xr disktab 5 201file. 202The drive parameters and partitions are taken from that file. 203If 204different disks of the same physical type are to have different partitions, it 205will be necessary to have separate disktab entries describing each, or to edit 206the label after installation as described below. 207The optional argument is a 208pack identification string, up to 16 characters long. 209The pack id must be 210quoted if it contains blanks. 211.Pp 212If the 213.Fl n 214flag is given, no data will be written to the device, and instead the 215disklabel that would have been written will be printed to stdout. 216.Pp 217If the 218.Fl r 219flag is given, the disk sectors containing the label and bootstrap 220will be written directly. 221A side-effect of this is that any existing bootstrap code will be overwritten 222and the disk rendered unbootable. 223See the boot options below for a method of 224writing the label and the bootstrap at the same time. 225If 226.Fl r 227is not specified, 228the existing label will be updated via the in-core copy and any bootstrap 229code will be unaffected. 230If the disk does not already have a label, the 231.Fl r 232flag must be used. 233In either case, the kernel's in-core label is replaced. 234.Pp 235For a virgin disk that is not known to 236.Xr disktab 5 , 237.Ar disktype 238can be specified as 239.Cm auto . 240In this case, the driver is requested to produce a virgin label for the 241disk. 242This might or might not be successful, depending on whether the 243driver for the disk is able to get the required data without reading 244anything from the disk at all. 245It will likely succeed for all SCSI 246disks, most IDE disks, and vnode devices. 247Writing a label to the 248disk is the only supported operation, and the 249.Ar disk 250itself must be provided as the canonical name, i.e.\& not as a full 251path name. 252.Pp 253For most harddisks, a label based on percentages for most partitions (and 254one partition with a size of 255.Ql * ) 256will produce a reasonable configuration. 257.Pp 258PC-based systems have special requirements in order for the BIOS to properly 259recognize a 260.Dx 261disklabel. 262Older systems may require what is known as a 263.Dq dangerously dedicated 264disklabel, which creates a fake DOS partition to work around problems older 265BIOSes have with modern disk geometries. 266On newer systems you generally want 267to create a normal DOS partition using 268.Ar fdisk 269and then create a 270.Dx 271disklabel within that slice. 272This is described 273later on in this page. 274.Pp 275Installing a new disklabel does not in of itself allow your system to boot 276a kernel using that label. 277You must also install boot blocks, which is 278described later on in this manual page. 279.Ss Editing an existing disk label 280To edit an existing disk label, use the form 281.Pp 282.Nm 283.Fl e 284.Op Fl r 285.Op Fl n 286.Ar disk 287.Pp 288This command reads the label from the in-core kernel copy, or directly from the 289disk if the 290.Fl r 291flag is also specified. 292The label is written to a file in ASCII and then 293supplied to an editor for changes. 294If no editor is specified in an 295.Ev EDITOR 296environment variable, 297.Xr vi 1 298is used. 299When the editor terminates, the label file is used to rewrite the disk label. 300Existing bootstrap code is unchanged regardless of whether 301.Fl r 302was specified. 303If 304.Fl n 305is specified, no data will be written to the device, and instead the 306disklabel that would have been written will be printed to stdout. 307This is 308useful to see how a partitioning scheme will work out for a specific disk. 309.Ss Restoring a disk label from a file 310To restore a disk label from a file, use the form 311.Pp 312.Nm 313.Fl R 314.Op Fl r 315.Op Fl n 316.Ar disk Ar protofile 317.Pp 318.Nm 319is capable of restoring a disk label that was previously saved in a file 320in ASCII format. 321The prototype file used to create the label should be in the same format 322as that produced when reading or editing a label. 323Comments are delimited by 324.Ql # 325and newline. 326As when writing a new label, any existing bootstrap code will be 327clobbered if 328.Fl r 329is specified and will be unaffected otherwise. 330See the boot options below for a 331method of restoring the label and writing the bootstrap at the same time. 332If 333.Fl n 334is used, no data will be written to the device, and instead the 335disklabel that would have been written will be printed to stdout. 336This is 337useful to see how a partitioning scheme will work out for a specific disk. 338.Ss Enabling and disabling writing to the disk label area 339By default, it is not possible to write to the disk label area at the beginning 340of a disk. 341The disk driver arranges for 342.Xr write 2 343and similar system calls 344to return 345.Er EROFS 346on any attempt to do so. 347If you need 348to write to this area (for example, to obliterate the label), use the form 349.Pp 350.Nm 351.Fl W 352.Ar disk 353.Pp 354To disallow writing to the label area after previously allowing it, 355use the command 356.Pp 357.Nm 358.Fl N 359.Ar disk 360.Ss Installing bootstraps 361The final three forms of 362.Nm 363are used to install bootstrap code, which allows boot from a 364.Xr HAMMER 5 365or 366.Xr UFS 5 367file system. 368If you are creating a 369.Dq dangerously-dedicated 370slice for compatibility with older PC systems, 371you generally want to specify the compatibility slice, such as 372.Pa da0s0 . 373If you are creating a label within an existing DOS slice, 374you should specify 375the slice name such as 376.Pa da0s1 . 377Making a slice bootable can be tricky. 378If you are using a normal DOS 379slice you typically install (or leave) a standard MBR on the base disk and 380then install the 381.Dx 382bootblocks in the slice. 383.Pp 384.Nm 385.Fl B 386.Oo 387.Fl b Ar boot1 388.Fl s Ar boot2 389.Oc 390.Ar disk 391.Oo Ar disktype Ns / Ns Cm auto Oc 392.Pp 393This form installs the bootstrap only. 394It does not change the disk label. 395You should never use this command on the compatibility slice unless you 396intend to create a 397.Dq dangerously-dedicated 398disk, such as 399.Ar da0s0 . 400This command is typically run on a 401.Bx 402slice such as 403.Ar da0s1 . 404.Pp 405.Nm 406.Fl w 407.Fl B 408.Op Fl n 409.Oo 410.Fl b Ar boot1 411.Fl s Ar boot2 412.Oc 413.Ar disk Ar disktype Ns / Ns Cm auto 414.Oo Ar packid Oc 415.Pp 416This form corresponds to the 417.Dq write label 418command described above. 419In addition to writing a new volume label, it also installs the bootstrap. 420If run on the compatibility slice this command will create a 421.Dq dangerously-dedicated 422label. 423This command is normally run on a 424.Bx 425slice rather than the compatibility slice. 426If 427.Fl n 428is used, no data will be written to the device, and instead the 429disklabel that would have been written will be printed to stdout. 430.Pp 431.Nm 432.Fl R 433.Fl B 434.Op Fl n 435.Oo 436.Fl b Ar boot1 437.Fl s Ar boot2 438.Oc 439.Ar disk Ar protofile 440.Oo Ar disktype Ns / Ns Cm auto Oc 441.Pp 442This form corresponds to the 443.Dq restore label 444command described above. 445In addition to restoring the volume label, it also installs the bootstrap. 446If run on the compatibility slice this command will create a 447.Dq dangerously-dedicated 448label. 449This command is normally run on a 450.Bx 451slice rather than the compatibility 452slice. 453.Pp 454The bootstrap commands always access the disk directly, 455so it is not necessary to specify the 456.Fl r 457flag. 458If 459.Fl n 460is used, no data will be written to the device, and instead the 461disklabel that would have been written will be printed to stdout. 462.Pp 463The bootstrap code is comprised of two boot programs. 464Specify the name of the 465boot programs to be installed in one of these ways: 466.Bl -enum 467.It 468Specify the names explicitly with the 469.Fl b 470and 471.Fl s 472flags. 473.Fl b 474indicates the primary boot program and 475.Fl s 476the secondary boot program. 477The boot programs are normally located in 478.Pa /boot . 479.It 480If the 481.Fl b 482and 483.Fl s 484flags are not specified, but 485.Ar disktype 486was specified, the names of the programs are taken from the 487.Dq b0 488and 489.Dq b1 490parameters of the 491.Xr disktab 5 492entry for the disk if the disktab entry exists and includes those parameters. 493.It 494Otherwise, the default boot image names are used: 495.Pa /boot/boot1_64 496and 497.Pa /boot/boot2_64 498for the standard stage1 and stage2 boot images. 499.El 500.Ss Initializing/Formatting a bootable disk from scratch 501To initialize a disk from scratch the following sequence is recommended. 502Please note that this will wipe everything that was previously on the disk, 503including any 504.No non- Ns Dx 505slices. 506.Bl -enum 507.It 508Use 509.Xr gpt 8 510or 511.Xr fdisk 8 512to initialize the hard disk, and create a GPT or MBR slice table, 513referred to as the 514.Dq "partition table" 515in 516.Tn DOS . 517.It 518Use 519.Nm 520or 521.Xr disklabel 8 522to define partitions on 523.Dx 524slices created in the previous step. 525.It 526Finally use 527.Xr newfs_hammer 8 528or 529.Xr newfs 8 530to create file systems on new partitions. 531.El 532.Pp 533A typical partitioning scheme would be to have an 534.Ql a 535partition 536of approximately 512MB to hold the root file system, a 537.Ql b 538partition for 539swap (usually 4GB), a 540.Ql d 541partition for 542.Pa /var 543(usually 2GB), an 544.Ql e 545partition for 546.Pa /var/tmp 547(usually 2GB), an 548.Ql f 549partition for 550.Pa /usr 551(usually around 4GB), 552and finally a 553.Ql g 554partition for 555.Pa /home 556(usually all remaining space). 557If you are tight on space all sizes can be halved. 558Your mileage may vary. 559.Pp 560.Dl "gpt create da0" 561.Dl "gpt add da0" 562.Dl "disklabel64 -B -r -w da0s0 auto" 563.Dl "disklabel64 -e da0s0" 564.Sh FILES 565.Bl -tag -width ".Pa /boot/boot2_64" -compact 566.It Pa /boot/boot1_64 567Default stage1 boot image. 568.It Pa /boot/boot2_64 569Default stage2 boot image. 570.It Pa /etc/disktab 571Disk description file. 572.El 573.Sh SAVED FILE FORMAT 574The 575.Nm 576utility uses an 577.Tn ASCII 578version of the label when examining, editing, or restoring a disk label. 579The format is: 580.Bd -literal -offset 4n 581# /dev/ad4s4: 582# 583# Informational fields calculated from the above 584# All byte equivalent offsets must be aligned 585# 586# boot space: 32768 bytes 587# data space: 121790552 blocks # 118936.09 MB (124713525248 bytes) 588# 589diskid: 5e3ef4db-4e24-11dd-8318-010e0cd0bad1 590label: 591boot2 data base: 0x000000001000 592partitions data base: 0x000000009000 593partitions data stop: 0x001d0981f000 594backup label: 0x001d0981f000 595total size: 0x001d09820000 # 118936.12 MB 596alignment: 4096 597display block size: 1024 # for partition display only 598 59916 partitions: 600# size offset fstype fsuuid 601 a: 524288 0 4.2BSD # 512.000MB 602 b: 4194304 524288 swap # 4096.000MB 603 d: 2097152 4718592 4.2BSD # 2048.000MB 604 e: 2097152 6815744 4.2BSD # 2048.000MB 605 f: 4194304 8912896 4.2BSD # 4096.000MB 606 g: 4194304 13107200 4.2BSD # 4096.000MB 607 h: 94003288 17301504 HAMMER # 91800.086MB 608 i: 5242880 111304792 ccd # 5120.000MB 609 j: 5242880 116547672 vinum # 5120.000MB 610 a-stor_uuid: 4370efdb-4e25-11dd-8318-010e0cd0bad1 611 b-stor_uuid: 4370eff4-4e25-11dd-8318-010e0cd0bad1 612 d-stor_uuid: 4370f00b-4e25-11dd-8318-010e0cd0bad1 613 e-stor_uuid: 4370f024-4e25-11dd-8318-010e0cd0bad1 614 f-stor_uuid: 4370f03a-4e25-11dd-8318-010e0cd0bad1 615 g-stor_uuid: 4370f053-4e25-11dd-8318-010e0cd0bad1 616 h-stor_uuid: 4370f06a-4e25-11dd-8318-010e0cd0bad1 617 i-stor_uuid: 4370f083-4e25-11dd-8318-010e0cd0bad1 618 j-stor_uuid: 4370f099-4e25-11dd-8318-010e0cd0bad1 619.Ed 620.Pp 621Lines starting with a 622.Ql # 623mark are comments. 624The specifications which can be changed are: 625.Bl -inset 626.It Ar label 627is an optional label, set by the 628.Ar packid 629option when writing a label. 630.It Ar "the partition table" 631is the 632.Ux 633partition table, not the 634.Tn DOS 635partition table described in 636.Xr fdisk 8 . 637.El 638.Pp 639The partition table can have up to 16 entries. 640It contains the following information: 641.Bl -tag -width indent 642.It Ar # 643The partition identifier is a single letter in the range 644.Ql a 645to 646.Ql p . 647.It Ar size 648The size of the partition in sectors, 649.Cm K 650(kilobytes - 1024), 651.Cm M 652(megabytes - 1024*1024), 653.Cm G 654(gigabytes - 1024*1024*1024), 655.Cm % 656(percentage of free space 657.Em after 658removing any fixed-size partitions), 659.Cm * 660(all remaining free space 661.Em after 662fixed-size and percentage partitions). 663Lowercase versions of 664.Cm K , M , 665and 666.Cm G 667are allowed. 668Size and type should be specified without any spaces between them. 669.Pp 670Example: 2097152, 1G, 1024M and 1048576K are all the same size 671(assuming 512-byte sectors). 672.It Ar offset 673The offset of the start of the partition from the beginning of the 674drive in sectors, or 675.Cm * 676to have 677.Nm 678calculate the correct offset to use (the end of the previous partition plus 679one. 680.It Ar fstype 681Describes the purpose of the partition. 682The example shows all currently used partition types. 683For 684.Xr UFS 5 685file systems, use type 686.Cm 4.2BSD . 687For 688.Xr HAMMER 5 689file systems, use type 690.Cm HAMMER . 691For 692.Xr ccd 4 693partitions, use type 694.Cm ccd . 695For Vinum drives, use type 696.Cm vinum . 697Other common types are 698.Cm swap 699and 700.Cm unused . 701The 702.Nm 703utility 704also knows about a number of other partition types, 705none of which are in current use. 706(See 707.Dv fstypenames 708in 709.In sys/dtype.h 710for more details). 711.El 712.Pp 713The remainder of the line is a comment and shows the size of 714the partition in MB. 715.Sh EXAMPLES 716.Dl "disklabel64 da0s1" 717.Pp 718Display the in-core label for the first slice of the 719.Pa da0 720disk, as obtained via 721.Pa /dev/da0s1 . 722(If the disk is 723.Dq dangerously-dedicated , 724the compatibility slice name should be specified, such as 725.Pa da0s0 . ) 726.Pp 727.Dl "disklabel64 da0s1 > savedlabel" 728.Pp 729Save the in-core label for 730.Pa da0s1 731into the file 732.Pa savedlabel . 733This file can be used with the 734.Fl R 735option to restore the label at a later date. 736.Pp 737.Dl "disklabel64 -w -r /dev/da0s1 da2212 foo" 738.Pp 739Create a label for 740.Pa da0s1 741based on information for 742.Dq da2212 743found in 744.Pa /etc/disktab . 745Any existing bootstrap code will be clobbered 746and the disk rendered unbootable. 747.Pp 748.Dl "disklabel64 -e -r da0s1" 749.Pp 750Read the on-disk label for 751.Pa da0s1 , 752edit it, and reinstall in-core as well as on-disk. 753Existing bootstrap code is unaffected. 754.Pp 755.Dl "disklabel64 -e -r -n da0s1" 756.Pp 757Read the on-disk label for 758.Pa da0s1 , 759edit it, and display what the new label would be (in sectors). 760It does 761.Em not 762install the new label either in-core or on-disk. 763.Pp 764.Dl "disklabel64 -r -w da0s1 auto" 765.Pp 766Try to auto-detect the required information from 767.Pa da0s1 , 768and write a new label to the disk. 769Use another 770.Nm Fl e 771command to edit the partitioning information. 772.Pp 773.Dl "disklabel64 -R da0s1 savedlabel" 774.Pp 775Restore the on-disk and in-core label for 776.Pa da0s1 777from information in 778.Pa savedlabel . 779Existing bootstrap code is unaffected. 780.Pp 781.Dl "disklabel64 -R -n da0s1 label_layout" 782.Pp 783Display what the label would be for 784.Pa da0s1 785using the partition layout in 786.Pa label_layout . 787This is useful for determining how much space would be allotted for various 788partitions with a labelling scheme using 789.Cm % Ns -based 790or 791.Cm * 792partition sizes. 793.Pp 794.Dl "disklabel64 -B da0s1" 795.Pp 796Install a new bootstrap on 797.Pa da0s1 . 798The boot code comes from 799.Pa /boot/boot1_64 800and possibly 801.Pa /boot/boot2_64 . 802On-disk and in-core labels are unchanged. 803.Pp 804.Dl "disklabel64 -w -B /dev/da0s1 -b newboot1 -s newboot2 da2212" 805.Pp 806Install a new label and bootstrap. 807The label is derived from disktab information for 808.Dq da2212 809and installed both in-core and on-disk. 810The bootstrap code comes from the files 811.Pa newboot1 812and 813.Pa newboot2 . 814.Pp 815.Dl "dd if=/dev/zero of=/dev/da0 bs=512 count=32" 816.Dl "fdisk -BI da0" 817.Dl "dd if=/dev/zero of=/dev/da0s1 bs=512 count=32" 818.Dl "disklabel64 -w -B da0s1 auto" 819.Dl "disklabel64 -e da0s1" 820.Pp 821Completely wipe any prior information on the disk, creating a new bootable 822disk with a DOS partition table containing one 823.Dq whole-disk 824slice. 825Then 826initialize the slice, then edit it to your needs. 827The 828.Pa dd 829commands are optional, but may be necessary for some BIOSes to properly 830recognize the disk. 831.Pp 832.Dl "disklabel64 -W da0s1" 833.Dl "dd if=/dev/zero of=/dev/da0s1 bs=512 count=32" 834.Dl "disklabel -r -w da0s1 auto" 835.Dl "disklabel -N da0s1" 836.Pp 837Completely wipe any prior information on the slice, 838changing label format to 32 bit. 839The wiping is needed as 840.Nm disklabel 841and 842.Nm , 843as a safety measure, 844won't do any operations if label with other format is already installed. 845.Pp 846This is an example disklabel that uses some of the new partition size types 847such as 848.Cm % , M , G , 849and 850.Cm * , 851which could be used as a source file for 852.Pp 853.Dl "disklabel64 -R ad0s1 new_label_file" 854.Bd -literal -offset 4n 855# /dev/ad4s4: 856# 857# Informational fields calculated from the above 858# All byte equivalent offsets must be aligned 859# 860# boot space: 32768 bytes 861# data space: 121790552 blocks # 118936.09 MB (124713525248 bytes) 862# 863diskid: b1db58a3-4e26-11dd-8318-010e0cd0bad1 864label: 865boot2 data base: 0x000000001000 866partitions data base: 0x000000009000 867partitions data stop: 0x001d0981f000 868backup label: 0x001d0981f000 869total size: 0x001d09820000 # 118936.12 MB 870alignment: 4096 871display block size: 1024 # for partition display only 872 87316 partitions: 874# size offset fstype fsuuid 875 a: 512M 0 4.2BSD 876 b: 4G * swap 877 d: 2G * 4.2BSD 878 e: 2048M * 4.2BSD 879 f: 4G * 4.2BSD 880 g: 4G * 4.2BSD 881 h: * * HAMMER 882 i: 5g * ccd 883 j: 5120m * vinum 884.Ed 885.Sh DIAGNOSTICS 886The kernel device drivers will not allow the size of a disk partition 887to be decreased or the offset of a partition to be changed while it is open. 888Some device drivers create a label containing only a single large partition 889if a disk is unlabeled; thus, the label must be written to the 890.Ql a 891partition of the disk while it is open. 892This sometimes requires the desired 893label to be set in two steps, the first one creating at least one other 894partition, and the second setting the label on the new partition while 895shrinking the 896.Ql a 897partition. 898.Sh SEE ALSO 899.Xr dd 1 , 900.Xr uuid 3 , 901.Xr ccd 4 , 902.Xr disklabel64 5 , 903.Xr disktab 5 , 904.Xr boot0cfg 8 , 905.Xr diskinfo 8 , 906.Xr disklabel 8 , 907.Xr fdisk 8 , 908.Xr gpt 8 , 909.Xr newfs 8 , 910.Xr newfs_hammer 8 , 911.Xr vinum 8 912.Sh BUGS 913For the i386 architecture, the primary bootstrap sector contains 914an embedded 915.Em fdisk 916table. 917The 918.Nm 919utility takes care to not clobber it when installing a bootstrap only 920.Pq Fl B , 921or when editing an existing label 922.Pq Fl e , 923but it unconditionally writes the primary bootstrap program onto 924the disk for 925.Fl w 926or 927.Fl R , 928thus replacing the 929.Em fdisk 930table by the dummy one in the bootstrap program. 931This is only of 932concern if the disk is fully dedicated, so that the 933.Bx 934disklabel 935starts at absolute block 0 on the disk. 936.Pp 937The 938.Nm 939utility 940does not perform all possible error checking. 941Warning 942.Em is 943given if partitions 944overlap; if an absolute offset does not match the expected offset; if a 945partition runs past the end of the device; and a number of other errors; but 946no warning is given if space remains unused. 947