d/freebsd-dev
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity
d8866befb8
freebsd-dev/sbin/bsdlabel/bsdlabel.8

508 lines
11 KiB
Groff
Raw Normal View History

BSD 4.4 Lite sbin Sources Note: XNSrouted and routed NOT imported here, they shall be imported with usr.sbin.
1994-05-26 06:35:07 +00:00
.\" Copyright (c) 1987, 1988, 1991, 1993
.\" The Regents of the University of California. All rights reserved.
.\"
.\" This code is derived from software contributed to Berkeley by
.\" Symmetric Computer Systems.
.\"
.\" Redistribution and use in source and binary forms, with or without
.\" modification, are permitted provided that the following conditions
.\" are met:
.\" 1. Redistributions of source code must retain the above copyright
.\" notice, this list of conditions and the following disclaimer.
.\" 2. Redistributions in binary form must reproduce the above copyright
.\" notice, this list of conditions and the following disclaimer in the
.\" documentation and/or other materials provided with the distribution.
Renumber copyright clause 4 Renumber cluase 4 to 3, per what everybody else did when BSD granted them permission to remove clause 3. My insistance on keeping the same numbering for legal reasons is too pedantic, so give up on that point. Submitted by: Jan Schaumann <jschauma@stevens.edu> Pull Request: https://github.com/freebsd/freebsd/pull/96
2017-02-28 23:42:47 +00:00
.\" 3. Neither the name of the University nor the names of its contributors
BSD 4.4 Lite sbin Sources Note: XNSrouted and routed NOT imported here, they shall be imported with usr.sbin.
1994-05-26 06:35:07 +00:00
.\" may be used to endorse or promote products derived from this software
.\" without specific prior written permission.
.\"
.\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
.\" ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
.\" SUCH DAMAGE.
.\"
.\" @(#)disklabel.8 8.2 (Berkeley) 4/19/94
$Id$ -> $FreeBSD$
1999-08-28 00:22:10 +00:00
.\" $FreeBSD$
BSD 4.4 Lite sbin Sources Note: XNSrouted and routed NOT imported here, they shall be imported with usr.sbin.
1994-05-26 06:35:07 +00:00
.\"
Add history section for bsdlabel(8) http://minnie.tuhs.org/cgi-bin/utree.pl?file=4.3BSD-Tahoe/usr/man/cat8/disklabel.0 Remove tab after space, highlighted by igor PR: 212436 Approved by: bcr (mentor) MFC after: 5 days Differential Revision: https://reviews.freebsd.org/D8104
2016-10-05 19:56:10 +00:00
.Dd October 5, 2016
First scrub of s/disklabel/bsdlabel/ bsdlabel.5 deliberately exempted, its contents looks less than useful.
2003-04-18 19:44:12 +00:00
.Dt BSDLABEL 8
mdoc(7) police: removed HISTORY info from the .Os call.
2001-07-10 11:04:34 +00:00
.Os
BSD 4.4 Lite sbin Sources Note: XNSrouted and routed NOT imported here, they shall be imported with usr.sbin.
1994-05-26 06:35:07 +00:00
.Sh NAME
First scrub of s/disklabel/bsdlabel/ bsdlabel.5 deliberately exempted, its contents looks less than useful.
2003-04-18 19:44:12 +00:00
.Nm bsdlabel
Fix utility's short description. PR: docs/84467 Submitted by: Gary W. Swearingen MFC after: 3 days
2006-10-12 20:29:20 +00:00
.Nd read and write BSD label
BSD 4.4 Lite sbin Sources Note: XNSrouted and routed NOT imported here, they shall be imported with usr.sbin.
1994-05-26 06:35:07 +00:00
.Sh SYNOPSIS
mdoc(7) police: use the new features of the Nm macro.
2000-11-20 16:52:27 +00:00
.Nm
More axe-work: Hide all the historical fields of the label, unless people ask for them with -A, set them to intelligently chosen defaults otherwise. Distill the manual page to remove inaccuracies, misundertandings and obsolete information. It can probably still be done better but now at least it is not misinforming people.
2003-05-03 09:58:20 +00:00
.Op Fl A
Assorted markup, grammar, and spelling fixes.
2004-05-17 08:35:43 +00:00
.Ar disk | Fl f Ar file
mdoc(7) police: use the new features of the Nm macro.
2000-11-20 16:52:27 +00:00
.Nm
BSD 4.4 Lite sbin Sources Note: XNSrouted and routed NOT imported here, they shall be imported with usr.sbin.
1994-05-26 06:35:07 +00:00
.Fl w
mdoc(7) fixes. Approved by: re (blanket)
2003-05-24 19:53:08 +00:00
.Op Fl \&An
More axe-work: Hide all the historical fields of the label, unless people ask for them with -A, set them to intelligently chosen defaults otherwise. Distill the manual page to remove inaccuracies, misundertandings and obsolete information. It can probably still be done better but now at least it is not misinforming people.
2003-05-03 09:58:20 +00:00
.Op Fl B Op Fl b Ar boot
Teach disklabel(8) about different hardware architectures. This is aimed at creating floppies during cross-releases. For different endianness machines, a tool like bswapfs(8) is necessary to make the generated floppies readable on the target machine. While here, fixed unaligned access on Alphas. Tested on: i386, alpha
2003-03-16 00:11:49 +00:00
.Op Fl m Ar machine
Assorted markup, grammar, and spelling fixes.
2004-05-17 08:35:43 +00:00
.Ar disk | Fl f Ar file
More axe-work: Hide all the historical fields of the label, unless people ask for them with -A, set them to intelligently chosen defaults otherwise. Distill the manual page to remove inaccuracies, misundertandings and obsolete information. It can probably still be done better but now at least it is not misinforming people.
2003-05-03 09:58:20 +00:00
.Op Ar type
mdoc(7) police: use the new features of the Nm macro.
2000-11-20 16:52:27 +00:00
.Nm
BSD 4.4 Lite sbin Sources Note: XNSrouted and routed NOT imported here, they shall be imported with usr.sbin.
1994-05-26 06:35:07 +00:00
.Fl e
mdoc(7) fixes. Approved by: re (blanket)
2003-05-24 19:53:08 +00:00
.Op Fl \&An
More axe-work: Hide all the historical fields of the label, unless people ask for them with -A, set them to intelligently chosen defaults otherwise. Distill the manual page to remove inaccuracies, misundertandings and obsolete information. It can probably still be done better but now at least it is not misinforming people.
2003-05-03 09:58:20 +00:00
.Op Fl B Op Fl b Ar boot
Teach disklabel(8) about different hardware architectures. This is aimed at creating floppies during cross-releases. For different endianness machines, a tool like bswapfs(8) is necessary to make the generated floppies readable on the target machine. While here, fixed unaligned access on Alphas. Tested on: i386, alpha
2003-03-16 00:11:49 +00:00
.Op Fl m Ar machine
Assorted markup, grammar, and spelling fixes.
2004-05-17 08:35:43 +00:00
.Ar disk | Fl f Ar file
mdoc(7) police: use the new features of the Nm macro.
2000-11-20 16:52:27 +00:00
.Nm
BSD 4.4 Lite sbin Sources Note: XNSrouted and routed NOT imported here, they shall be imported with usr.sbin.
1994-05-26 06:35:07 +00:00
.Fl R
mdoc(7) fixes. Approved by: re (blanket)
2003-05-24 19:53:08 +00:00
.Op Fl \&An
More axe-work: Hide all the historical fields of the label, unless people ask for them with -A, set them to intelligently chosen defaults otherwise. Distill the manual page to remove inaccuracies, misundertandings and obsolete information. It can probably still be done better but now at least it is not misinforming people.
2003-05-03 09:58:20 +00:00
.Op Fl B Op Fl b Ar boot
Teach disklabel(8) about different hardware architectures. This is aimed at creating floppies during cross-releases. For different endianness machines, a tool like bswapfs(8) is necessary to make the generated floppies readable on the target machine. While here, fixed unaligned access on Alphas. Tested on: i386, alpha
2003-03-16 00:11:49 +00:00
.Op Fl m Ar machine
Implement a '-f' flag to teach bsdlabel to work on files instead of disk partitions.
2004-03-30 23:15:03 +00:00
.Op Fl f
Assorted markup, grammar, and spelling fixes.
2004-05-17 08:35:43 +00:00
.Ar disk | Fl f Ar file
.Ar protofile
BSD 4.4 Lite sbin Sources Note: XNSrouted and routed NOT imported here, they shall be imported with usr.sbin.
1994-05-26 06:35:07 +00:00
.Sh DESCRIPTION
The .Nm utility
2002-07-06 19:34:18 +00:00
The
.Nm
utility
mdoc(7) fixes. Approved by: re (blanket)
2003-05-24 19:53:08 +00:00
installs, examines or modifies the
.Bx
Implement a '-f' flag to teach bsdlabel to work on files instead of disk partitions.
2004-03-30 23:15:03 +00:00
label on a disk partition, or on a file containing a partition image.
Give this manpage a good overhaul, including the markup. Notable changes: - Removed the "disktype" argument from the -B only synopsis form. This form doesn't touch the disk label, and doesn't use this argument. - Fixed the first example in the EXAMPLES section. Support for compatibility slices has been recently dropped from the GEOM kernels, and a bit later GEOM became standard. - Removed the buggy notion from rev. 1.37 that disklabel(8) may be used to define mount points; it cannot. Improve some DOS partition / FreeBSD slice wording. Among these, ``dangerously-dedicated slice'' was just a nonsense. ;-)
2003-03-15 22:00:45 +00:00
In addition,
Add section number to .Xr. Use of .Nm. Typo. Add rcsid. Remove unused #includes. Use err(3).
1998-06-04 06:49:13 +00:00
.Nm
Make intelligible: Describe the command formats in English. Add references to other programs (boot0cfg, fdisk). Remove some old cruft, including FUD about single-level bootstraps. Add example of output format. Not-objected-to-by: msmith rnordier
1999-07-31 08:11:58 +00:00
can install bootstrap code.
Give this manpage a good overhaul, including the markup. Notable changes: - Removed the "disktype" argument from the -B only synopsis form. This form doesn't touch the disk label, and doesn't use this argument. - Fixed the first example in the EXAMPLES section. Support for compatibility slices has been recently dropped from the GEOM kernels, and a bit later GEOM became standard. - Removed the buggy notion from rev. 1.37 that disklabel(8) may be used to define mount points; it cannot. Improve some DOS partition / FreeBSD slice wording. Among these, ``dangerously-dedicated slice'' was just a nonsense. ;-)
2003-03-15 22:00:45 +00:00
.Ss Disk Device Name
Assorted markup, grammar, and spelling fixes.
2004-05-17 08:35:43 +00:00
When specifying the device (i.e., when the
Implement a '-f' flag to teach bsdlabel to work on files instead of disk partitions.
2004-03-30 23:15:03 +00:00
.Fl f
Assorted markup, grammar, and spelling fixes.
2004-05-17 08:35:43 +00:00
option is not used),
Give this manpage a good overhaul, including the markup. Notable changes: - Removed the "disktype" argument from the -B only synopsis form. This form doesn't touch the disk label, and doesn't use this argument. - Fixed the first example in the EXAMPLES section. Support for compatibility slices has been recently dropped from the GEOM kernels, and a bit later GEOM became standard. - Removed the buggy notion from rev. 1.37 that disklabel(8) may be used to define mount points; it cannot. Improve some DOS partition / FreeBSD slice wording. Among these, ``dangerously-dedicated slice'' was just a nonsense. ;-)
2003-03-15 22:00:45 +00:00
the
Add support for virgin disklabels Submitted by: dillon
2000-10-31 07:07:39 +00:00
.Pa /dev/
Give this manpage a good overhaul, including the markup. Notable changes: - Removed the "disktype" argument from the -B only synopsis form. This form doesn't touch the disk label, and doesn't use this argument. - Fixed the first example in the EXAMPLES section. Support for compatibility slices has been recently dropped from the GEOM kernels, and a bit later GEOM became standard. - Removed the buggy notion from rev. 1.37 that disklabel(8) may be used to define mount points; it cannot. Improve some DOS partition / FreeBSD slice wording. Among these, ``dangerously-dedicated slice'' was just a nonsense. ;-)
2003-03-15 22:00:45 +00:00
path prefix may be omitted;
the
Make intelligible: Describe the command formats in English. Add references to other programs (boot0cfg, fdisk). Remove some old cruft, including FUD about single-level bootstraps. Add example of output format. Not-objected-to-by: msmith rnordier
1999-07-31 08:11:58 +00:00
.Nm
The .Nm utility
2002-07-06 19:34:18 +00:00
utility will automatically prepend it.
mdoc(7) fixes. Approved by: re (blanket)
2003-05-24 19:53:08 +00:00
.Ss General Options
The
More axe-work: Hide all the historical fields of the label, unless people ask for them with -A, set them to intelligently chosen defaults otherwise. Distill the manual page to remove inaccuracies, misundertandings and obsolete information. It can probably still be done better but now at least it is not misinforming people.
2003-05-03 09:58:20 +00:00
.Fl A
mdoc(7) fixes. Approved by: re (blanket)
2003-05-24 19:53:08 +00:00
option enables processing of the historical parts of the
.Bx
label.
More axe-work: Hide all the historical fields of the label, unless people ask for them with -A, set them to intelligently chosen defaults otherwise. Distill the manual page to remove inaccuracies, misundertandings and obsolete information. It can probably still be done better but now at least it is not misinforming people.
2003-05-03 09:58:20 +00:00
If the option is not given, suitable values are set for these fields.
.Pp
The
Implement a '-f' flag to teach bsdlabel to work on files instead of disk partitions.
2004-03-30 23:15:03 +00:00
.Fl f
option tells
.Nm
that the program will operate on a file instead of a disk partition.
.Pp
The
More axe-work: Hide all the historical fields of the label, unless people ask for them with -A, set them to intelligently chosen defaults otherwise. Distill the manual page to remove inaccuracies, misundertandings and obsolete information. It can probably still be done better but now at least it is not misinforming people.
2003-05-03 09:58:20 +00:00
.Fl n
Implement a '-f' flag to teach bsdlabel to work on files instead of disk partitions.
2004-03-30 23:15:03 +00:00
option stops the
More axe-work: Hide all the historical fields of the label, unless people ask for them with -A, set them to intelligently chosen defaults otherwise. Distill the manual page to remove inaccuracies, misundertandings and obsolete information. It can probably still be done better but now at least it is not misinforming people.
2003-05-03 09:58:20 +00:00
.Nm
program right before the disk would have been modified, and displays
the result instead of writing it.
.Pp
The
.Fl m Ar machine
Clarify wording for -m flag. PR: docs/84704
2005-09-17 15:10:39 +00:00
argument forces
More axe-work: Hide all the historical fields of the label, unless people ask for them with -A, set them to intelligently chosen defaults otherwise. Distill the manual page to remove inaccuracies, misundertandings and obsolete information. It can probably still be done better but now at least it is not misinforming people.
2003-05-03 09:58:20 +00:00
.Nm
Clarify wording for -m flag. PR: docs/84704
2005-09-17 15:10:39 +00:00
to use a layout suitable for a different architecture.
Current valid values are
Remove pc98 support completely. I thank all developers and contributors for pc98. Relnotes: yes
2017-01-28 02:22:15 +00:00
.Cm i386
Clarify wording for -m flag. PR: docs/84704
2005-09-17 15:10:39 +00:00
and
Remove pc98 support completely. I thank all developers and contributors for pc98. Relnotes: yes
2017-01-28 02:22:15 +00:00
.Cm amd64 .
Clarify wording for -m flag. PR: docs/84704
2005-09-17 15:10:39 +00:00
If this option is omitted,
.Nm
will use a layout suitable for the current machine.
Give this manpage a good overhaul, including the markup. Notable changes: - Removed the "disktype" argument from the -B only synopsis form. This form doesn't touch the disk label, and doesn't use this argument. - Fixed the first example in the EXAMPLES section. Support for compatibility slices has been recently dropped from the GEOM kernels, and a bit later GEOM became standard. - Removed the buggy notion from rev. 1.37 that disklabel(8) may be used to define mount points; it cannot. Improve some DOS partition / FreeBSD slice wording. Among these, ``dangerously-dedicated slice'' was just a nonsense. ;-)
2003-03-15 22:00:45 +00:00
.Ss Reading the Disk Label
- Fix markup. - Somewhat improve wording. - Change the layout of the EXAMPLES section so that descriptions come before example, as in most other manpages. - Fix a bad example that edits a label using a `c' partition.
2006-12-29 16:28:38 +00:00
To examine the label on a disk drive, use the form
Make intelligible: Describe the command formats in English. Add references to other programs (boot0cfg, fdisk). Remove some old cruft, including FUD about single-level bootstraps. Add example of output format. Not-objected-to-by: msmith rnordier
1999-07-31 08:11:58 +00:00
.Pp
mdoc(7) police: use the new features of the Nm macro.
2000-11-20 16:52:27 +00:00
.Nm
More axe-work: Hide all the historical fields of the label, unless people ask for them with -A, set them to intelligently chosen defaults otherwise. Distill the manual page to remove inaccuracies, misundertandings and obsolete information. It can probably still be done better but now at least it is not misinforming people.
2003-05-03 09:58:20 +00:00
.Op Fl A
.Op Fl m Ar machine
Make intelligible: Describe the command formats in English. Add references to other programs (boot0cfg, fdisk). Remove some old cruft, including FUD about single-level bootstraps. Add example of output format. Not-objected-to-by: msmith rnordier
1999-07-31 08:11:58 +00:00
.Ar disk
.Pp
.Ar disk
More axe-work: Hide all the historical fields of the label, unless people ask for them with -A, set them to intelligently chosen defaults otherwise. Distill the manual page to remove inaccuracies, misundertandings and obsolete information. It can probably still be done better but now at least it is not misinforming people.
2003-05-03 09:58:20 +00:00
represents the disk in question, and may be in the form
Make intelligible: Describe the command formats in English. Add references to other programs (boot0cfg, fdisk). Remove some old cruft, including FUD about single-level bootstraps. Add example of output format. Not-objected-to-by: msmith rnordier
1999-07-31 08:11:58 +00:00
.Pa da0
or
More axe-work: Hide all the historical fields of the label, unless people ask for them with -A, set them to intelligently chosen defaults otherwise. Distill the manual page to remove inaccuracies, misundertandings and obsolete information. It can probably still be done better but now at least it is not misinforming people.
2003-05-03 09:58:20 +00:00
.Pa /dev/da0 .
It will display the partition layout.
Give this manpage a good overhaul, including the markup. Notable changes: - Removed the "disktype" argument from the -B only synopsis form. This form doesn't touch the disk label, and doesn't use this argument. - Fixed the first example in the EXAMPLES section. Support for compatibility slices has been recently dropped from the GEOM kernels, and a bit later GEOM became standard. - Removed the buggy notion from rev. 1.37 that disklabel(8) may be used to define mount points; it cannot. Improve some DOS partition / FreeBSD slice wording. Among these, ``dangerously-dedicated slice'' was just a nonsense. ;-)
2003-03-15 22:00:45 +00:00
.Ss Writing a Standard Label
Make intelligible: Describe the command formats in English. Add references to other programs (boot0cfg, fdisk). Remove some old cruft, including FUD about single-level bootstraps. Add example of output format. Not-objected-to-by: msmith rnordier
1999-07-31 08:11:58 +00:00
To write a standard label, use the form
BSD 4.4 Lite sbin Sources Note: XNSrouted and routed NOT imported here, they shall be imported with usr.sbin.
1994-05-26 06:35:07 +00:00
.Pp
mdoc(7) police: use the new features of the Nm macro.
2000-11-20 16:52:27 +00:00
.Nm
BSD 4.4 Lite sbin Sources Note: XNSrouted and routed NOT imported here, they shall be imported with usr.sbin.
1994-05-26 06:35:07 +00:00
.Fl w
mdoc(7) fixes. Approved by: re (blanket)
2003-05-24 19:53:08 +00:00
.Op Fl \&An
Teach disklabel(8) about different hardware architectures. This is aimed at creating floppies during cross-releases. For different endianness machines, a tool like bswapfs(8) is necessary to make the generated floppies readable on the target machine. While here, fixed unaligned access on Alphas. Tested on: i386, alpha
2003-03-16 00:11:49 +00:00
.Op Fl m Ar machine
More axe-work: Hide all the historical fields of the label, unless people ask for them with -A, set them to intelligently chosen defaults otherwise. Distill the manual page to remove inaccuracies, misundertandings and obsolete information. It can probably still be done better but now at least it is not misinforming people.
2003-05-03 09:58:20 +00:00
.Ar disk
.Op Ar type
Add support for virgin disklabels Submitted by: dillon
2000-10-31 07:07:39 +00:00
.Pp
- Fix markup. - Somewhat improve wording. - Change the layout of the EXAMPLES section so that descriptions come before example, as in most other manpages. - Fix a bad example that edits a label using a `c' partition.
2006-12-29 16:28:38 +00:00
If the drive
.Ar type
is specified, the entry of that name in the
mdoc(7) police: split punctuation characters + misc fixes.
2001-02-01 16:38:02 +00:00
.Xr disktab 5
Remove redundant whitespace. Noticed by: brueffer
2007-12-08 23:41:13 +00:00
file is used; otherwise, or if the type is specified as 'auto', a default
Attempt to describe the ''auto'' type a bit better in the default section (if nothing had been specified, or if the auto type had been specified, a default layout is used). PR: docs/116047 Submitted by: Ian Smith <smithi at nimnet dot asn dot au> Minor modifications by me.
2007-12-08 19:57:22 +00:00
layout is used.
Give this manpage a good overhaul, including the markup. Notable changes: - Removed the "disktype" argument from the -B only synopsis form. This form doesn't touch the disk label, and doesn't use this argument. - Fixed the first example in the EXAMPLES section. Support for compatibility slices has been recently dropped from the GEOM kernels, and a bit later GEOM became standard. - Removed the buggy notion from rev. 1.37 that disklabel(8) may be used to define mount points; it cannot. Improve some DOS partition / FreeBSD slice wording. Among these, ``dangerously-dedicated slice'' was just a nonsense. ;-)
2003-03-15 22:00:45 +00:00
.Ss Editing an Existing Disk Label
Make intelligible: Describe the command formats in English. Add references to other programs (boot0cfg, fdisk). Remove some old cruft, including FUD about single-level bootstraps. Add example of output format. Not-objected-to-by: msmith rnordier
1999-07-31 08:11:58 +00:00
To edit an existing disk label, use the form
.Pp
mdoc(7) police: use the new features of the Nm macro.
2000-11-20 16:52:27 +00:00
.Nm
BSD 4.4 Lite sbin Sources Note: XNSrouted and routed NOT imported here, they shall be imported with usr.sbin.
1994-05-26 06:35:07 +00:00
.Fl e
mdoc(7) fixes. Approved by: re (blanket)
2003-05-24 19:53:08 +00:00
.Op Fl \&An
Teach disklabel(8) about different hardware architectures. This is aimed at creating floppies during cross-releases. For different endianness machines, a tool like bswapfs(8) is necessary to make the generated floppies readable on the target machine. While here, fixed unaligned access on Alphas. Tested on: i386, alpha
2003-03-16 00:11:49 +00:00
.Op Fl m Ar machine
Make intelligible: Describe the command formats in English. Add references to other programs (boot0cfg, fdisk). Remove some old cruft, including FUD about single-level bootstraps. Add example of output format. Not-objected-to-by: msmith rnordier
1999-07-31 08:11:58 +00:00
.Ar disk
.Pp
mdoc(7) fixes. Approved by: re (blanket)
2003-05-24 19:53:08 +00:00
This command opens the disk label in the default editor, and when the editor
exits, the label is validated and if OK written to disk.
Give this manpage a good overhaul, including the markup. Notable changes: - Removed the "disktype" argument from the -B only synopsis form. This form doesn't touch the disk label, and doesn't use this argument. - Fixed the first example in the EXAMPLES section. Support for compatibility slices has been recently dropped from the GEOM kernels, and a bit later GEOM became standard. - Removed the buggy notion from rev. 1.37 that disklabel(8) may be used to define mount points; it cannot. Improve some DOS partition / FreeBSD slice wording. Among these, ``dangerously-dedicated slice'' was just a nonsense. ;-)
2003-03-15 22:00:45 +00:00
.Ss Restoring a Disk Label From a File
Make intelligible: Describe the command formats in English. Add references to other programs (boot0cfg, fdisk). Remove some old cruft, including FUD about single-level bootstraps. Add example of output format. Not-objected-to-by: msmith rnordier
1999-07-31 08:11:58 +00:00
To restore a disk label from a file, use the form
BSD 4.4 Lite sbin Sources Note: XNSrouted and routed NOT imported here, they shall be imported with usr.sbin.
1994-05-26 06:35:07 +00:00
.Pp
mdoc(7) police: use the new features of the Nm macro.
2000-11-20 16:52:27 +00:00
.Nm
BSD 4.4 Lite sbin Sources Note: XNSrouted and routed NOT imported here, they shall be imported with usr.sbin.
1994-05-26 06:35:07 +00:00
.Fl R
mdoc(7) fixes. Approved by: re (blanket)
2003-05-24 19:53:08 +00:00
.Op Fl \&An
Teach disklabel(8) about different hardware architectures. This is aimed at creating floppies during cross-releases. For different endianness machines, a tool like bswapfs(8) is necessary to make the generated floppies readable on the target machine. While here, fixed unaligned access on Alphas. Tested on: i386, alpha
2003-03-16 00:11:49 +00:00
.Op Fl m Ar machine
Give this manpage a good overhaul, including the markup. Notable changes: - Removed the "disktype" argument from the -B only synopsis form. This form doesn't touch the disk label, and doesn't use this argument. - Fixed the first example in the EXAMPLES section. Support for compatibility slices has been recently dropped from the GEOM kernels, and a bit later GEOM became standard. - Removed the buggy notion from rev. 1.37 that disklabel(8) may be used to define mount points; it cannot. Improve some DOS partition / FreeBSD slice wording. Among these, ``dangerously-dedicated slice'' was just a nonsense. ;-)
2003-03-15 22:00:45 +00:00
.Ar disk protofile
Make intelligible: Describe the command formats in English. Add references to other programs (boot0cfg, fdisk). Remove some old cruft, including FUD about single-level bootstraps. Add example of output format. Not-objected-to-by: msmith rnordier
1999-07-31 08:11:58 +00:00
.Pp
- Fix markup. - Somewhat improve wording. - Change the layout of the EXAMPLES section so that descriptions come before example, as in most other manpages. - Fix a bad example that edits a label using a `c' partition.
2006-12-29 16:28:38 +00:00
The
Add section number to .Xr. Use of .Nm. Typo. Add rcsid. Remove unused #includes. Use err(3).
1998-06-04 06:49:13 +00:00
.Nm
- Fix markup. - Somewhat improve wording. - Change the layout of the EXAMPLES section so that descriptions come before example, as in most other manpages. - Fix a bad example that edits a label using a `c' partition.
2006-12-29 16:28:38 +00:00
utility
Give this manpage a good overhaul, including the markup. Notable changes: - Removed the "disktype" argument from the -B only synopsis form. This form doesn't touch the disk label, and doesn't use this argument. - Fixed the first example in the EXAMPLES section. Support for compatibility slices has been recently dropped from the GEOM kernels, and a bit later GEOM became standard. - Removed the buggy notion from rev. 1.37 that disklabel(8) may be used to define mount points; it cannot. Improve some DOS partition / FreeBSD slice wording. Among these, ``dangerously-dedicated slice'' was just a nonsense. ;-)
2003-03-15 22:00:45 +00:00
is capable of restoring a disk label that was previously saved in a file in
.Tn ASCII
format.
Make intelligible: Describe the command formats in English. Add references to other programs (boot0cfg, fdisk). Remove some old cruft, including FUD about single-level bootstraps. Add example of output format. Not-objected-to-by: msmith rnordier
1999-07-31 08:11:58 +00:00
The prototype file used to create the label should be in the same format as that
Give this manpage a good overhaul, including the markup. Notable changes: - Removed the "disktype" argument from the -B only synopsis form. This form doesn't touch the disk label, and doesn't use this argument. - Fixed the first example in the EXAMPLES section. Support for compatibility slices has been recently dropped from the GEOM kernels, and a bit later GEOM became standard. - Removed the buggy notion from rev. 1.37 that disklabel(8) may be used to define mount points; it cannot. Improve some DOS partition / FreeBSD slice wording. Among these, ``dangerously-dedicated slice'' was just a nonsense. ;-)
2003-03-15 22:00:45 +00:00
produced when reading or editing a label.
Comments are delimited by
.Ql #
and newline.
.Ss Installing Bootstraps
Teach disklabel(8) about different hardware architectures. This is aimed at creating floppies during cross-releases. For different endianness machines, a tool like bswapfs(8) is necessary to make the generated floppies readable on the target machine. While here, fixed unaligned access on Alphas. Tested on: i386, alpha
2003-03-16 00:11:49 +00:00
If the
More axe-work: Hide all the historical fields of the label, unless people ask for them with -A, set them to intelligently chosen defaults otherwise. Distill the manual page to remove inaccuracies, misundertandings and obsolete information. It can probably still be done better but now at least it is not misinforming people.
2003-05-03 09:58:20 +00:00
.Fl B
- Fix markup. - Somewhat improve wording. - Change the layout of the EXAMPLES section so that descriptions come before example, as in most other manpages. - Fix a bad example that edits a label using a `c' partition.
2006-12-29 16:28:38 +00:00
option is specified, bootstrap code will be read from the file
Deal with vestiges of d_boot[01].
2003-02-23 01:48:42 +00:00
.Pa /boot/boot
More axe-work: Hide all the historical fields of the label, unless people ask for them with -A, set them to intelligently chosen defaults otherwise. Distill the manual page to remove inaccuracies, misundertandings and obsolete information. It can probably still be done better but now at least it is not misinforming people.
2003-05-03 09:58:20 +00:00
and written to the disk.
The
.Fl b Ar boot
- Fix markup. - Somewhat improve wording. - Change the layout of the EXAMPLES section so that descriptions come before example, as in most other manpages. - Fix a bad example that edits a label using a `c' partition.
2006-12-29 16:28:38 +00:00
option allows a different file to be used.
BSD 4.4 Lite sbin Sources Note: XNSrouted and routed NOT imported here, they shall be imported with usr.sbin.
1994-05-26 06:35:07 +00:00
.Sh FILES
Deal with vestiges of d_boot[01].
2003-02-23 01:48:42 +00:00
.Bl -tag -width ".Pa /etc/disktab" -compact
.It Pa /boot/boot
Default boot image.
BSD 4.4 Lite sbin Sources Note: XNSrouted and routed NOT imported here, they shall be imported with usr.sbin.
1994-05-26 06:35:07 +00:00
.It Pa /etc/disktab
Deal with vestiges of d_boot[01].
2003-02-23 01:48:42 +00:00
Disk description file.
BSD 4.4 Lite sbin Sources Note: XNSrouted and routed NOT imported here, they shall be imported with usr.sbin.
1994-05-26 06:35:07 +00:00
.El
Make intelligible: Describe the command formats in English. Add references to other programs (boot0cfg, fdisk). Remove some old cruft, including FUD about single-level bootstraps. Add example of output format. Not-objected-to-by: msmith rnordier
1999-07-31 08:11:58 +00:00
.Sh SAVED FILE FORMAT
The .Nm utility
2002-07-06 19:34:18 +00:00
The
Make intelligible: Describe the command formats in English. Add references to other programs (boot0cfg, fdisk). Remove some old cruft, including FUD about single-level bootstraps. Add example of output format. Not-objected-to-by: msmith rnordier
1999-07-31 08:11:58 +00:00
.Nm
The .Nm utility
2002-07-06 19:34:18 +00:00
utility
Give this manpage a good overhaul, including the markup. Notable changes: - Removed the "disktype" argument from the -B only synopsis form. This form doesn't touch the disk label, and doesn't use this argument. - Fixed the first example in the EXAMPLES section. Support for compatibility slices has been recently dropped from the GEOM kernels, and a bit later GEOM became standard. - Removed the buggy notion from rev. 1.37 that disklabel(8) may be used to define mount points; it cannot. Improve some DOS partition / FreeBSD slice wording. Among these, ``dangerously-dedicated slice'' was just a nonsense. ;-)
2003-03-15 22:00:45 +00:00
uses an
.Tn ASCII
version of the label when examining, editing, or restoring a disk
label.
The format is:
Make intelligible: Describe the command formats in English. Add references to other programs (boot0cfg, fdisk). Remove some old cruft, including FUD about single-level bootstraps. Add example of output format. Not-objected-to-by: msmith rnordier
1999-07-31 08:11:58 +00:00
.Bd -literal -offset 4n
More axe-work: Hide all the historical fields of the label, unless people ask for them with -A, set them to intelligently chosen defaults otherwise. Distill the manual page to remove inaccuracies, misundertandings and obsolete information. It can probably still be done better but now at least it is not misinforming people.
2003-05-03 09:58:20 +00:00
8 partitions:
# size offset fstype [fsize bsize bps/cpg]
- Don't mention (wrong) defaults for FFS file system parameters, replace them with references to newfs(8) which documents them. - Remove mentions of LFS support for which was retired in 1998. - Regenerate an example output. PR: docs/84913 MFC after: 3 days
2006-10-13 15:44:29 +00:00
a: 81920 16 4.2BSD 2048 16384 5128
b: 1091994 81936 swap
More axe-work: Hide all the historical fields of the label, unless people ask for them with -A, set them to intelligently chosen defaults otherwise. Distill the manual page to remove inaccuracies, misundertandings and obsolete information. It can probably still be done better but now at least it is not misinforming people.
2003-05-03 09:58:20 +00:00
c: 1173930 0 unused 0 0 # "raw" part, don't edit
.Ed
.Pp
If the
.Fl A
option is specified, the format is:
.Bd -literal -offset 4n
/dev/r<FOO> => /dev/<FOO>
2000-04-26 11:24:44 +00:00
# /dev/da1c:
Make intelligible: Describe the command formats in English. Add references to other programs (boot0cfg, fdisk). Remove some old cruft, including FUD about single-level bootstraps. Add example of output format. Not-objected-to-by: msmith rnordier
1999-07-31 08:11:58 +00:00
type: SCSI
/dev/r<FOO> => /dev/<FOO>
2000-04-26 11:24:44 +00:00
disk: da0s1
Remove whitespace at EOL.
2001-07-15 07:53:42 +00:00
label:
Make intelligible: Describe the command formats in English. Add references to other programs (boot0cfg, fdisk). Remove some old cruft, including FUD about single-level bootstraps. Add example of output format. Not-objected-to-by: msmith rnordier
1999-07-31 08:11:58 +00:00
flags:
bytes/sector: 512
sectors/track: 51
tracks/cylinder: 19
sectors/cylinder: 969
cylinders: 1211
sectors/unit: 1173930
rpm: 3600
interleave: 1
trackskew: 0
cylinderskew: 0
headswitch: 0 # milliseconds
track-to-track seek: 0 # milliseconds
Remove whitespace at EOL.
2001-07-15 07:53:42 +00:00
drivedata: 0
Make intelligible: Describe the command formats in English. Add references to other programs (boot0cfg, fdisk). Remove some old cruft, including FUD about single-level bootstraps. Add example of output format. Not-objected-to-by: msmith rnordier
1999-07-31 08:11:58 +00:00
8 partitions:
# size offset fstype [fsize bsize bps/cpg]
Fix evil examples - first partition should start at offset 16. MFC after: 3 days
2006-03-04 12:09:50 +00:00
a: 81920 16 4.2BSD 1024 8192 16
b: 160000 81936 swap
More axe-work: Hide all the historical fields of the label, unless people ask for them with -A, set them to intelligently chosen defaults otherwise. Distill the manual page to remove inaccuracies, misundertandings and obsolete information. It can probably still be done better but now at least it is not misinforming people.
2003-05-03 09:58:20 +00:00
c: 1173930 0 unused 0 0 # "raw" part, don't edit
Make intelligible: Describe the command formats in English. Add references to other programs (boot0cfg, fdisk). Remove some old cruft, including FUD about single-level bootstraps. Add example of output format. Not-objected-to-by: msmith rnordier
1999-07-31 08:11:58 +00:00
.Ed
.Pp
Give this manpage a good overhaul, including the markup. Notable changes: - Removed the "disktype" argument from the -B only synopsis form. This form doesn't touch the disk label, and doesn't use this argument. - Fixed the first example in the EXAMPLES section. Support for compatibility slices has been recently dropped from the GEOM kernels, and a bit later GEOM became standard. - Removed the buggy notion from rev. 1.37 that disklabel(8) may be used to define mount points; it cannot. Improve some DOS partition / FreeBSD slice wording. Among these, ``dangerously-dedicated slice'' was just a nonsense. ;-)
2003-03-15 22:00:45 +00:00
Lines starting with a
.Ql #
mark are comments.
Make intelligible: Describe the command formats in English. Add references to other programs (boot0cfg, fdisk). Remove some old cruft, including FUD about single-level bootstraps. Add example of output format. Not-objected-to-by: msmith rnordier
1999-07-31 08:11:58 +00:00
.Pp
Give this manpage a good overhaul, including the markup. Notable changes: - Removed the "disktype" argument from the -B only synopsis form. This form doesn't touch the disk label, and doesn't use this argument. - Fixed the first example in the EXAMPLES section. Support for compatibility slices has been recently dropped from the GEOM kernels, and a bit later GEOM became standard. - Removed the buggy notion from rev. 1.37 that disklabel(8) may be used to define mount points; it cannot. Improve some DOS partition / FreeBSD slice wording. Among these, ``dangerously-dedicated slice'' was just a nonsense. ;-)
2003-03-15 22:00:45 +00:00
The partition table can have up to 8 entries.
It contains the following information:
.Bl -tag -width indent
.It Ar #
Make intelligible: Describe the command formats in English. Add references to other programs (boot0cfg, fdisk). Remove some old cruft, including FUD about single-level bootstraps. Add example of output format. Not-objected-to-by: msmith rnordier
1999-07-31 08:11:58 +00:00
The partition identifier is a single letter in the range
Give this manpage a good overhaul, including the markup. Notable changes: - Removed the "disktype" argument from the -B only synopsis form. This form doesn't touch the disk label, and doesn't use this argument. - Fixed the first example in the EXAMPLES section. Support for compatibility slices has been recently dropped from the GEOM kernels, and a bit later GEOM became standard. - Removed the buggy notion from rev. 1.37 that disklabel(8) may be used to define mount points; it cannot. Improve some DOS partition / FreeBSD slice wording. Among these, ``dangerously-dedicated slice'' was just a nonsense. ;-)
2003-03-15 22:00:45 +00:00
.Ql a
Make intelligible: Describe the command formats in English. Add references to other programs (boot0cfg, fdisk). Remove some old cruft, including FUD about single-level bootstraps. Add example of output format. Not-objected-to-by: msmith rnordier
1999-07-31 08:11:58 +00:00
to
Give this manpage a good overhaul, including the markup. Notable changes: - Removed the "disktype" argument from the -B only synopsis form. This form doesn't touch the disk label, and doesn't use this argument. - Fixed the first example in the EXAMPLES section. Support for compatibility slices has been recently dropped from the GEOM kernels, and a bit later GEOM became standard. - Removed the buggy notion from rev. 1.37 that disklabel(8) may be used to define mount points; it cannot. Improve some DOS partition / FreeBSD slice wording. Among these, ``dangerously-dedicated slice'' was just a nonsense. ;-)
2003-03-15 22:00:45 +00:00
.Ql h .
Make intelligible: Describe the command formats in English. Add references to other programs (boot0cfg, fdisk). Remove some old cruft, including FUD about single-level bootstraps. Add example of output format. Not-objected-to-by: msmith rnordier
1999-07-31 08:11:58 +00:00
By convention, partition
Give this manpage a good overhaul, including the markup. Notable changes: - Removed the "disktype" argument from the -B only synopsis form. This form doesn't touch the disk label, and doesn't use this argument. - Fixed the first example in the EXAMPLES section. Support for compatibility slices has been recently dropped from the GEOM kernels, and a bit later GEOM became standard. - Removed the buggy notion from rev. 1.37 that disklabel(8) may be used to define mount points; it cannot. Improve some DOS partition / FreeBSD slice wording. Among these, ``dangerously-dedicated slice'' was just a nonsense. ;-)
2003-03-15 22:00:45 +00:00
.Ql c
Make intelligible: Describe the command formats in English. Add references to other programs (boot0cfg, fdisk). Remove some old cruft, including FUD about single-level bootstraps. Add example of output format. Not-objected-to-by: msmith rnordier
1999-07-31 08:11:58 +00:00
is reserved to describe the entire disk.
Give this manpage a good overhaul, including the markup. Notable changes: - Removed the "disktype" argument from the -B only synopsis form. This form doesn't touch the disk label, and doesn't use this argument. - Fixed the first example in the EXAMPLES section. Support for compatibility slices has been recently dropped from the GEOM kernels, and a bit later GEOM became standard. - Removed the buggy notion from rev. 1.37 that disklabel(8) may be used to define mount points; it cannot. Improve some DOS partition / FreeBSD slice wording. Among these, ``dangerously-dedicated slice'' was just a nonsense. ;-)
2003-03-15 22:00:45 +00:00
.It Ar size
The size of the partition in sectors,
mdoc(7) police: misc formatting fixes. (This page still needs a lot of work.)
2001-03-05 15:33:54 +00:00
.Cm K
Allow for easier configuration when using disklabel. A sample being: # size offset fstype [fsize bsize bps/cpg] a: 400M 0 4.2BSD 4096 16384 75 # (Cyl. 0 - 812*) b: 1G * swap c: * * unused e: 204800 * 4.2BSD f: 5g * 4.2BSD g: * * 4.2BSD These patches are the original work of Randell Jesup, and I believe Matt Dillon, with additional work by Warner Losh. Please let me know if I've left someone out. Incorporated into this is the fix for PR bin/22727. This patchset still has style issues and a possible problem on large disks. However, it was a agreed to get these committed before performing major surgery on them. PR: bin/22727 Submitted by: Randell Jesup <rjesup@wgate.com>
2001-02-25 16:47:44 +00:00
(kilobytes - 1024),
mdoc(7) police: misc formatting fixes. (This page still needs a lot of work.)
2001-03-05 15:33:54 +00:00
.Cm M
Allow for easier configuration when using disklabel. A sample being: # size offset fstype [fsize bsize bps/cpg] a: 400M 0 4.2BSD 4096 16384 75 # (Cyl. 0 - 812*) b: 1G * swap c: * * unused e: 204800 * 4.2BSD f: 5g * 4.2BSD g: * * 4.2BSD These patches are the original work of Randell Jesup, and I believe Matt Dillon, with additional work by Warner Losh. Please let me know if I've left someone out. Incorporated into this is the fix for PR bin/22727. This patchset still has style issues and a possible problem on large disks. However, it was a agreed to get these committed before performing major surgery on them. PR: bin/22727 Submitted by: Randell Jesup <rjesup@wgate.com>
2001-02-25 16:47:44 +00:00
(megabytes - 1024*1024),
mdoc(7) police: misc formatting fixes. (This page still needs a lot of work.)
2001-03-05 15:33:54 +00:00
.Cm G
Allow for easier configuration when using disklabel. A sample being: # size offset fstype [fsize bsize bps/cpg] a: 400M 0 4.2BSD 4096 16384 75 # (Cyl. 0 - 812*) b: 1G * swap c: * * unused e: 204800 * 4.2BSD f: 5g * 4.2BSD g: * * 4.2BSD These patches are the original work of Randell Jesup, and I believe Matt Dillon, with additional work by Warner Losh. Please let me know if I've left someone out. Incorporated into this is the fix for PR bin/22727. This patchset still has style issues and a possible problem on large disks. However, it was a agreed to get these committed before performing major surgery on them. PR: bin/22727 Submitted by: Randell Jesup <rjesup@wgate.com>
2001-02-25 16:47:44 +00:00
(gigabytes - 1024*1024*1024),
mdoc(7) police: misc formatting fixes. (This page still needs a lot of work.)
2001-03-05 15:33:54 +00:00
.Cm %
Give this manpage a good overhaul, including the markup. Notable changes: - Removed the "disktype" argument from the -B only synopsis form. This form doesn't touch the disk label, and doesn't use this argument. - Fixed the first example in the EXAMPLES section. Support for compatibility slices has been recently dropped from the GEOM kernels, and a bit later GEOM became standard. - Removed the buggy notion from rev. 1.37 that disklabel(8) may be used to define mount points; it cannot. Improve some DOS partition / FreeBSD slice wording. Among these, ``dangerously-dedicated slice'' was just a nonsense. ;-)
2003-03-15 22:00:45 +00:00
(percentage of free space
.Em after
removing any fixed-size partitions other than partition
.Ql c ) ,
mdoc(7) police: misc formatting fixes. (This page still needs a lot of work.)
2001-03-05 15:33:54 +00:00
or
.Cm *
Give this manpage a good overhaul, including the markup. Notable changes: - Removed the "disktype" argument from the -B only synopsis form. This form doesn't touch the disk label, and doesn't use this argument. - Fixed the first example in the EXAMPLES section. Support for compatibility slices has been recently dropped from the GEOM kernels, and a bit later GEOM became standard. - Removed the buggy notion from rev. 1.37 that disklabel(8) may be used to define mount points; it cannot. Improve some DOS partition / FreeBSD slice wording. Among these, ``dangerously-dedicated slice'' was just a nonsense. ;-)
2003-03-15 22:00:45 +00:00
(all remaining free space
.Em after
fixed-size and percentage partitions).
For partition
.Ql c ,
mdoc(7) police: misc formatting fixes. (This page still needs a lot of work.)
2001-03-05 15:33:54 +00:00
a size of
.Cm *
Give this manpage a good overhaul, including the markup. Notable changes: - Removed the "disktype" argument from the -B only synopsis form. This form doesn't touch the disk label, and doesn't use this argument. - Fixed the first example in the EXAMPLES section. Support for compatibility slices has been recently dropped from the GEOM kernels, and a bit later GEOM became standard. - Removed the buggy notion from rev. 1.37 that disklabel(8) may be used to define mount points; it cannot. Improve some DOS partition / FreeBSD slice wording. Among these, ``dangerously-dedicated slice'' was just a nonsense. ;-)
2003-03-15 22:00:45 +00:00
indicates the entire disk.
- Fix markup. - Somewhat improve wording. - Change the layout of the EXAMPLES section so that descriptions come before example, as in most other manpages. - Fix a bad example that edits a label using a `c' partition.
2006-12-29 16:28:38 +00:00
Lowercase versions of suffixes
mdoc(7) police: misc formatting fixes. (This page still needs a lot of work.)
2001-03-05 15:33:54 +00:00
.Cm K , M ,
and
.Cm G
Allow for easier configuration when using disklabel. A sample being: # size offset fstype [fsize bsize bps/cpg] a: 400M 0 4.2BSD 4096 16384 75 # (Cyl. 0 - 812*) b: 1G * swap c: * * unused e: 204800 * 4.2BSD f: 5g * 4.2BSD g: * * 4.2BSD These patches are the original work of Randell Jesup, and I believe Matt Dillon, with additional work by Warner Losh. Please let me know if I've left someone out. Incorporated into this is the fix for PR bin/22727. This patchset still has style issues and a possible problem on large disks. However, it was a agreed to get these committed before performing major surgery on them. PR: bin/22727 Submitted by: Randell Jesup <rjesup@wgate.com>
2001-02-25 16:47:44 +00:00
are allowed.
- Fix markup. - Somewhat improve wording. - Change the layout of the EXAMPLES section so that descriptions come before example, as in most other manpages. - Fix a bad example that edits a label using a `c' partition.
2006-12-29 16:28:38 +00:00
Size and suffix should be specified without any spaces between them.
Allow for easier configuration when using disklabel. A sample being: # size offset fstype [fsize bsize bps/cpg] a: 400M 0 4.2BSD 4096 16384 75 # (Cyl. 0 - 812*) b: 1G * swap c: * * unused e: 204800 * 4.2BSD f: 5g * 4.2BSD g: * * 4.2BSD These patches are the original work of Randell Jesup, and I believe Matt Dillon, with additional work by Warner Losh. Please let me know if I've left someone out. Incorporated into this is the fix for PR bin/22727. This patchset still has style issues and a possible problem on large disks. However, it was a agreed to get these committed before performing major surgery on them. PR: bin/22727 Submitted by: Randell Jesup <rjesup@wgate.com>
2001-02-25 16:47:44 +00:00
.Pp
Give this manpage a good overhaul, including the markup. Notable changes: - Removed the "disktype" argument from the -B only synopsis form. This form doesn't touch the disk label, and doesn't use this argument. - Fixed the first example in the EXAMPLES section. Support for compatibility slices has been recently dropped from the GEOM kernels, and a bit later GEOM became standard. - Removed the buggy notion from rev. 1.37 that disklabel(8) may be used to define mount points; it cannot. Improve some DOS partition / FreeBSD slice wording. Among these, ``dangerously-dedicated slice'' was just a nonsense. ;-)
2003-03-15 22:00:45 +00:00
Example: 2097152, 1G, 1024M and 1048576K are all the same size
Allow for easier configuration when using disklabel. A sample being: # size offset fstype [fsize bsize bps/cpg] a: 400M 0 4.2BSD 4096 16384 75 # (Cyl. 0 - 812*) b: 1G * swap c: * * unused e: 204800 * 4.2BSD f: 5g * 4.2BSD g: * * 4.2BSD These patches are the original work of Randell Jesup, and I believe Matt Dillon, with additional work by Warner Losh. Please let me know if I've left someone out. Incorporated into this is the fix for PR bin/22727. This patchset still has style issues and a possible problem on large disks. However, it was a agreed to get these committed before performing major surgery on them. PR: bin/22727 Submitted by: Randell Jesup <rjesup@wgate.com>
2001-02-25 16:47:44 +00:00
(assuming 512-byte sectors).
Give this manpage a good overhaul, including the markup. Notable changes: - Removed the "disktype" argument from the -B only synopsis form. This form doesn't touch the disk label, and doesn't use this argument. - Fixed the first example in the EXAMPLES section. Support for compatibility slices has been recently dropped from the GEOM kernels, and a bit later GEOM became standard. - Removed the buggy notion from rev. 1.37 that disklabel(8) may be used to define mount points; it cannot. Improve some DOS partition / FreeBSD slice wording. Among these, ``dangerously-dedicated slice'' was just a nonsense. ;-)
2003-03-15 22:00:45 +00:00
.It Ar offset
The offset of the start of the partition from the beginning of the
mdoc(7) police: misc formatting fixes. (This page still needs a lot of work.)
2001-03-05 15:33:54 +00:00
drive in sectors, or
.Cm *
to have
Allow for easier configuration when using disklabel. A sample being: # size offset fstype [fsize bsize bps/cpg] a: 400M 0 4.2BSD 4096 16384 75 # (Cyl. 0 - 812*) b: 1G * swap c: * * unused e: 204800 * 4.2BSD f: 5g * 4.2BSD g: * * 4.2BSD These patches are the original work of Randell Jesup, and I believe Matt Dillon, with additional work by Warner Losh. Please let me know if I've left someone out. Incorporated into this is the fix for PR bin/22727. This patchset still has style issues and a possible problem on large disks. However, it was a agreed to get these committed before performing major surgery on them. PR: bin/22727 Submitted by: Randell Jesup <rjesup@wgate.com>
2001-02-25 16:47:44 +00:00
.Nm
calculate the correct offset to use (the end of the previous partition plus
one, ignoring partition
- Fix markup. - Somewhat improve wording. - Change the layout of the EXAMPLES section so that descriptions come before example, as in most other manpages. - Fix a bad example that edits a label using a `c' partition.
2006-12-29 16:28:38 +00:00
.Ql c ) .
Allow for easier configuration when using disklabel. A sample being: # size offset fstype [fsize bsize bps/cpg] a: 400M 0 4.2BSD 4096 16384 75 # (Cyl. 0 - 812*) b: 1G * swap c: * * unused e: 204800 * 4.2BSD f: 5g * 4.2BSD g: * * 4.2BSD These patches are the original work of Randell Jesup, and I believe Matt Dillon, with additional work by Warner Losh. Please let me know if I've left someone out. Incorporated into this is the fix for PR bin/22727. This patchset still has style issues and a possible problem on large disks. However, it was a agreed to get these committed before performing major surgery on them. PR: bin/22727 Submitted by: Randell Jesup <rjesup@wgate.com>
2001-02-25 16:47:44 +00:00
For partition
Give this manpage a good overhaul, including the markup. Notable changes: - Removed the "disktype" argument from the -B only synopsis form. This form doesn't touch the disk label, and doesn't use this argument. - Fixed the first example in the EXAMPLES section. Support for compatibility slices has been recently dropped from the GEOM kernels, and a bit later GEOM became standard. - Removed the buggy notion from rev. 1.37 that disklabel(8) may be used to define mount points; it cannot. Improve some DOS partition / FreeBSD slice wording. Among these, ``dangerously-dedicated slice'' was just a nonsense. ;-)
2003-03-15 22:00:45 +00:00
.Ql c ,
mdoc(7) police: misc formatting fixes. (This page still needs a lot of work.)
2001-03-05 15:33:54 +00:00
.Cm *
will be interpreted as an offset of 0.
Explain why the first partition should start at offset 16. Requested by: hrs
2006-03-08 14:17:26 +00:00
The first partition should start at offset 16, because the first 16 sectors are
reserved for metadata.
Give this manpage a good overhaul, including the markup. Notable changes: - Removed the "disktype" argument from the -B only synopsis form. This form doesn't touch the disk label, and doesn't use this argument. - Fixed the first example in the EXAMPLES section. Support for compatibility slices has been recently dropped from the GEOM kernels, and a bit later GEOM became standard. - Removed the buggy notion from rev. 1.37 that disklabel(8) may be used to define mount points; it cannot. Improve some DOS partition / FreeBSD slice wording. Among these, ``dangerously-dedicated slice'' was just a nonsense. ;-)
2003-03-15 22:00:45 +00:00
.It Ar fstype
Describes the purpose of the partition.
- Fix markup. - Somewhat improve wording. - Change the layout of the EXAMPLES section so that descriptions come before example, as in most other manpages. - Fix a bad example that edits a label using a `c' partition.
2006-12-29 16:28:38 +00:00
The above example shows all currently used partition types.
Give this manpage a good overhaul, including the markup. Notable changes: - Removed the "disktype" argument from the -B only synopsis form. This form doesn't touch the disk label, and doesn't use this argument. - Fixed the first example in the EXAMPLES section. Support for compatibility slices has been recently dropped from the GEOM kernels, and a bit later GEOM became standard. - Removed the buggy notion from rev. 1.37 that disklabel(8) may be used to define mount points; it cannot. Improve some DOS partition / FreeBSD slice wording. Among these, ``dangerously-dedicated slice'' was just a nonsense. ;-)
2003-03-15 22:00:45 +00:00
For
.Tn UFS
file systems and
.Xr ccd 4
partitions, use type
mdoc(7) police: misc formatting fixes. (This page still needs a lot of work.)
2001-03-05 15:33:54 +00:00
.Cm 4.2BSD .
Clarify the currently used partition types. Add cross-references to ccd(4) and vinum(8).
2001-05-14 23:26:40 +00:00
For Vinum drives, use type
.Cm vinum .
Allow for easier configuration when using disklabel. A sample being: # size offset fstype [fsize bsize bps/cpg] a: 400M 0 4.2BSD 4096 16384 75 # (Cyl. 0 - 812*) b: 1G * swap c: * * unused e: 204800 * 4.2BSD f: 5g * 4.2BSD g: * * 4.2BSD These patches are the original work of Randell Jesup, and I believe Matt Dillon, with additional work by Warner Losh. Please let me know if I've left someone out. Incorporated into this is the fix for PR bin/22727. This patchset still has style issues and a possible problem on large disks. However, it was a agreed to get these committed before performing major surgery on them. PR: bin/22727 Submitted by: Randell Jesup <rjesup@wgate.com>
2001-02-25 16:47:44 +00:00
Other common types are
Give this manpage a good overhaul, including the markup. Notable changes: - Removed the "disktype" argument from the -B only synopsis form. This form doesn't touch the disk label, and doesn't use this argument. - Fixed the first example in the EXAMPLES section. Support for compatibility slices has been recently dropped from the GEOM kernels, and a bit later GEOM became standard. - Removed the buggy notion from rev. 1.37 that disklabel(8) may be used to define mount points; it cannot. Improve some DOS partition / FreeBSD slice wording. Among these, ``dangerously-dedicated slice'' was just a nonsense. ;-)
2003-03-15 22:00:45 +00:00
.Cm swap
Allow for easier configuration when using disklabel. A sample being: # size offset fstype [fsize bsize bps/cpg] a: 400M 0 4.2BSD 4096 16384 75 # (Cyl. 0 - 812*) b: 1G * swap c: * * unused e: 204800 * 4.2BSD f: 5g * 4.2BSD g: * * 4.2BSD These patches are the original work of Randell Jesup, and I believe Matt Dillon, with additional work by Warner Losh. Please let me know if I've left someone out. Incorporated into this is the fix for PR bin/22727. This patchset still has style issues and a possible problem on large disks. However, it was a agreed to get these committed before performing major surgery on them. PR: bin/22727 Submitted by: Randell Jesup <rjesup@wgate.com>
2001-02-25 16:47:44 +00:00
and
Give this manpage a good overhaul, including the markup. Notable changes: - Removed the "disktype" argument from the -B only synopsis form. This form doesn't touch the disk label, and doesn't use this argument. - Fixed the first example in the EXAMPLES section. Support for compatibility slices has been recently dropped from the GEOM kernels, and a bit later GEOM became standard. - Removed the buggy notion from rev. 1.37 that disklabel(8) may be used to define mount points; it cannot. Improve some DOS partition / FreeBSD slice wording. Among these, ``dangerously-dedicated slice'' was just a nonsense. ;-)
2003-03-15 22:00:45 +00:00
.Cm unused .
mdoc(7) police: fix markup in revision 1.27.
2001-05-15 16:03:59 +00:00
By convention, partition
Give this manpage a good overhaul, including the markup. Notable changes: - Removed the "disktype" argument from the -B only synopsis form. This form doesn't touch the disk label, and doesn't use this argument. - Fixed the first example in the EXAMPLES section. Support for compatibility slices has been recently dropped from the GEOM kernels, and a bit later GEOM became standard. - Removed the buggy notion from rev. 1.37 that disklabel(8) may be used to define mount points; it cannot. Improve some DOS partition / FreeBSD slice wording. Among these, ``dangerously-dedicated slice'' was just a nonsense. ;-)
2003-03-15 22:00:45 +00:00
.Ql c
mdoc(7) police: fix markup in revision 1.27.
2001-05-15 16:03:59 +00:00
represents the entire slice and should be of type
Clarify the currently used partition types. Add cross-references to ccd(4) and vinum(8).
2001-05-14 23:26:40 +00:00
.Cm unused ,
though
.Nm
does not enforce this convention.
The .Nm utility
2002-07-06 19:34:18 +00:00
The
Clarify the currently used partition types. Add cross-references to ccd(4) and vinum(8).
2001-05-14 23:26:40 +00:00
.Nm
The .Nm utility
2002-07-06 19:34:18 +00:00
utility
Give this manpage a good overhaul, including the markup. Notable changes: - Removed the "disktype" argument from the -B only synopsis form. This form doesn't touch the disk label, and doesn't use this argument. - Fixed the first example in the EXAMPLES section. Support for compatibility slices has been recently dropped from the GEOM kernels, and a bit later GEOM became standard. - Removed the buggy notion from rev. 1.37 that disklabel(8) may be used to define mount points; it cannot. Improve some DOS partition / FreeBSD slice wording. Among these, ``dangerously-dedicated slice'' was just a nonsense. ;-)
2003-03-15 22:00:45 +00:00
also knows about a number of other partition types,
none of which are in current use.
(See the definitions starting with
mdoc(7) police: fix markup in revision 1.27.
2001-05-15 16:03:59 +00:00
.Dv FS_UNUSED
in
mdoc(7): Use the new feature of the .In macro.
2003-09-08 19:57:22 +00:00
.In sys/disklabel.h
Give this manpage a good overhaul, including the markup. Notable changes: - Removed the "disktype" argument from the -B only synopsis form. This form doesn't touch the disk label, and doesn't use this argument. - Fixed the first example in the EXAMPLES section. Support for compatibility slices has been recently dropped from the GEOM kernels, and a bit later GEOM became standard. - Removed the buggy notion from rev. 1.37 that disklabel(8) may be used to define mount points; it cannot. Improve some DOS partition / FreeBSD slice wording. Among these, ``dangerously-dedicated slice'' was just a nonsense. ;-)
2003-03-15 22:00:45 +00:00
for more details.)
.It Ar fsize
Allow for easier configuration when using disklabel. A sample being: # size offset fstype [fsize bsize bps/cpg] a: 400M 0 4.2BSD 4096 16384 75 # (Cyl. 0 - 812*) b: 1G * swap c: * * unused e: 204800 * 4.2BSD f: 5g * 4.2BSD g: * * 4.2BSD These patches are the original work of Randell Jesup, and I believe Matt Dillon, with additional work by Warner Losh. Please let me know if I've left someone out. Incorporated into this is the fix for PR bin/22727. This patchset still has style issues and a possible problem on large disks. However, it was a agreed to get these committed before performing major surgery on them. PR: bin/22727 Submitted by: Randell Jesup <rjesup@wgate.com>
2001-02-25 16:47:44 +00:00
For
mdoc(7) police: misc formatting fixes. (This page still needs a lot of work.)
2001-03-05 15:33:54 +00:00
.Cm 4.2BSD
- Don't mention (wrong) defaults for FFS file system parameters, replace them with references to newfs(8) which documents them. - Remove mentions of LFS support for which was retired in 1998. - Regenerate an example output. PR: docs/84913 MFC after: 3 days
2006-10-13 15:44:29 +00:00
file systems only, the fragment size; see
.Xr newfs 8 .
Give this manpage a good overhaul, including the markup. Notable changes: - Removed the "disktype" argument from the -B only synopsis form. This form doesn't touch the disk label, and doesn't use this argument. - Fixed the first example in the EXAMPLES section. Support for compatibility slices has been recently dropped from the GEOM kernels, and a bit later GEOM became standard. - Removed the buggy notion from rev. 1.37 that disklabel(8) may be used to define mount points; it cannot. Improve some DOS partition / FreeBSD slice wording. Among these, ``dangerously-dedicated slice'' was just a nonsense. ;-)
2003-03-15 22:00:45 +00:00
.It Ar bsize
Allow for easier configuration when using disklabel. A sample being: # size offset fstype [fsize bsize bps/cpg] a: 400M 0 4.2BSD 4096 16384 75 # (Cyl. 0 - 812*) b: 1G * swap c: * * unused e: 204800 * 4.2BSD f: 5g * 4.2BSD g: * * 4.2BSD These patches are the original work of Randell Jesup, and I believe Matt Dillon, with additional work by Warner Losh. Please let me know if I've left someone out. Incorporated into this is the fix for PR bin/22727. This patchset still has style issues and a possible problem on large disks. However, it was a agreed to get these committed before performing major surgery on them. PR: bin/22727 Submitted by: Randell Jesup <rjesup@wgate.com>
2001-02-25 16:47:44 +00:00
For
mdoc(7) police: misc formatting fixes. (This page still needs a lot of work.)
2001-03-05 15:33:54 +00:00
.Cm 4.2BSD
- Don't mention (wrong) defaults for FFS file system parameters, replace them with references to newfs(8) which documents them. - Remove mentions of LFS support for which was retired in 1998. - Regenerate an example output. PR: docs/84913 MFC after: 3 days
2006-10-13 15:44:29 +00:00
file systems only, the block size; see
.Xr newfs 8 .
Give this manpage a good overhaul, including the markup. Notable changes: - Removed the "disktype" argument from the -B only synopsis form. This form doesn't touch the disk label, and doesn't use this argument. - Fixed the first example in the EXAMPLES section. Support for compatibility slices has been recently dropped from the GEOM kernels, and a bit later GEOM became standard. - Removed the buggy notion from rev. 1.37 that disklabel(8) may be used to define mount points; it cannot. Improve some DOS partition / FreeBSD slice wording. Among these, ``dangerously-dedicated slice'' was just a nonsense. ;-)
2003-03-15 22:00:45 +00:00
.It Ar bps/cpg
Allow for easier configuration when using disklabel. A sample being: # size offset fstype [fsize bsize bps/cpg] a: 400M 0 4.2BSD 4096 16384 75 # (Cyl. 0 - 812*) b: 1G * swap c: * * unused e: 204800 * 4.2BSD f: 5g * 4.2BSD g: * * 4.2BSD These patches are the original work of Randell Jesup, and I believe Matt Dillon, with additional work by Warner Losh. Please let me know if I've left someone out. Incorporated into this is the fix for PR bin/22727. This patchset still has style issues and a possible problem on large disks. However, it was a agreed to get these committed before performing major surgery on them. PR: bin/22727 Submitted by: Randell Jesup <rjesup@wgate.com>
2001-02-25 16:47:44 +00:00
For
mdoc(7) police: misc formatting fixes. (This page still needs a lot of work.)
2001-03-05 15:33:54 +00:00
.Cm 4.2BSD
- Don't mention (wrong) defaults for FFS file system parameters, replace them with references to newfs(8) which documents them. - Remove mentions of LFS support for which was retired in 1998. - Regenerate an example output. PR: docs/84913 MFC after: 3 days
2006-10-13 15:44:29 +00:00
file systems, the number of cylinders in a cylinder group; see
.Xr newfs 8 .
Make intelligible: Describe the command formats in English. Add references to other programs (boot0cfg, fdisk). Remove some old cruft, including FUD about single-level bootstraps. Add example of output format. Not-objected-to-by: msmith rnordier
1999-07-31 08:11:58 +00:00
.El
BSD 4.4 Lite sbin Sources Note: XNSrouted and routed NOT imported here, they shall be imported with usr.sbin.
1994-05-26 06:35:07 +00:00
.Sh EXAMPLES
More axe-work: Hide all the historical fields of the label, unless people ask for them with -A, set them to intelligently chosen defaults otherwise. Distill the manual page to remove inaccuracies, misundertandings and obsolete information. It can probably still be done better but now at least it is not misinforming people.
2003-05-03 09:58:20 +00:00
Display the label for the first slice of the
Give this manpage a good overhaul, including the markup. Notable changes: - Removed the "disktype" argument from the -B only synopsis form. This form doesn't touch the disk label, and doesn't use this argument. - Fixed the first example in the EXAMPLES section. Support for compatibility slices has been recently dropped from the GEOM kernels, and a bit later GEOM became standard. - Removed the buggy notion from rev. 1.37 that disklabel(8) may be used to define mount points; it cannot. Improve some DOS partition / FreeBSD slice wording. Among these, ``dangerously-dedicated slice'' was just a nonsense. ;-)
2003-03-15 22:00:45 +00:00
.Pa da0
disk, as obtained via
- Fix markup. - Somewhat improve wording. - Change the layout of the EXAMPLES section so that descriptions come before example, as in most other manpages. - Fix a bad example that edits a label using a `c' partition.
2006-12-29 16:28:38 +00:00
.Pa /dev/da0s1 :
BSD 4.4 Lite sbin Sources Note: XNSrouted and routed NOT imported here, they shall be imported with usr.sbin.
1994-05-26 06:35:07 +00:00
.Pp
- Fix markup. - Somewhat improve wording. - Change the layout of the EXAMPLES section so that descriptions come before example, as in most other manpages. - Fix a bad example that edits a label using a `c' partition.
2006-12-29 16:28:38 +00:00
.Dl "bsdlabel da0s1"
Make intelligible: Describe the command formats in English. Add references to other programs (boot0cfg, fdisk). Remove some old cruft, including FUD about single-level bootstraps. Add example of output format. Not-objected-to-by: msmith rnordier
1999-07-31 08:11:58 +00:00
.Pp
Remove whitespace at EOL.
2001-07-15 07:53:42 +00:00
Save the in-core label for
Add support for virgin disklabels Submitted by: dillon
2000-10-31 07:07:39 +00:00
.Pa da0s1
Make intelligible: Describe the command formats in English. Add references to other programs (boot0cfg, fdisk). Remove some old cruft, including FUD about single-level bootstraps. Add example of output format. Not-objected-to-by: msmith rnordier
1999-07-31 08:11:58 +00:00
into the file
.Pa savedlabel .
This file can be used with the
.Fl R
- Fix markup. - Somewhat improve wording. - Change the layout of the EXAMPLES section so that descriptions come before example, as in most other manpages. - Fix a bad example that edits a label using a `c' partition.
2006-12-29 16:28:38 +00:00
option to restore the label at a later date:
Make intelligible: Describe the command formats in English. Add references to other programs (boot0cfg, fdisk). Remove some old cruft, including FUD about single-level bootstraps. Add example of output format. Not-objected-to-by: msmith rnordier
1999-07-31 08:11:58 +00:00
.Pp
- Fix markup. - Somewhat improve wording. - Change the layout of the EXAMPLES section so that descriptions come before example, as in most other manpages. - Fix a bad example that edits a label using a `c' partition.
2006-12-29 16:28:38 +00:00
.Dl "bsdlabel da0s1 > savedlabel"
BSD 4.4 Lite sbin Sources Note: XNSrouted and routed NOT imported here, they shall be imported with usr.sbin.
1994-05-26 06:35:07 +00:00
.Pp
Remove whitespace at EOL.
2001-07-15 07:53:42 +00:00
Create a label for
- Fix markup. - Somewhat improve wording. - Change the layout of the EXAMPLES section so that descriptions come before example, as in most other manpages. - Fix a bad example that edits a label using a `c' partition.
2006-12-29 16:28:38 +00:00
.Pa da0s1 :
BSD 4.4 Lite sbin Sources Note: XNSrouted and routed NOT imported here, they shall be imported with usr.sbin.
1994-05-26 06:35:07 +00:00
.Pp
- Fix markup. - Somewhat improve wording. - Change the layout of the EXAMPLES section so that descriptions come before example, as in most other manpages. - Fix a bad example that edits a label using a `c' partition.
2006-12-29 16:28:38 +00:00
.Dl "bsdlabel -w /dev/da0s1"
BSD 4.4 Lite sbin Sources Note: XNSrouted and routed NOT imported here, they shall be imported with usr.sbin.
1994-05-26 06:35:07 +00:00
.Pp
More axe-work: Hide all the historical fields of the label, unless people ask for them with -A, set them to intelligently chosen defaults otherwise. Distill the manual page to remove inaccuracies, misundertandings and obsolete information. It can probably still be done better but now at least it is not misinforming people.
2003-05-03 09:58:20 +00:00
Read the label for
Add support for virgin disklabels Submitted by: dillon
2000-10-31 07:07:39 +00:00
.Pa da0s1 ,
- Fix markup. - Somewhat improve wording. - Change the layout of the EXAMPLES section so that descriptions come before example, as in most other manpages. - Fix a bad example that edits a label using a `c' partition.
2006-12-29 16:28:38 +00:00
edit it, and install the result:
BSD 4.4 Lite sbin Sources Note: XNSrouted and routed NOT imported here, they shall be imported with usr.sbin.
1994-05-26 06:35:07 +00:00
.Pp
- Fix markup. - Somewhat improve wording. - Change the layout of the EXAMPLES section so that descriptions come before example, as in most other manpages. - Fix a bad example that edits a label using a `c' partition.
2006-12-29 16:28:38 +00:00
.Dl "bsdlabel -e da0s1"
Allow for easier configuration when using disklabel. A sample being: # size offset fstype [fsize bsize bps/cpg] a: 400M 0 4.2BSD 4096 16384 75 # (Cyl. 0 - 812*) b: 1G * swap c: * * unused e: 204800 * 4.2BSD f: 5g * 4.2BSD g: * * 4.2BSD These patches are the original work of Randell Jesup, and I believe Matt Dillon, with additional work by Warner Losh. Please let me know if I've left someone out. Incorporated into this is the fix for PR bin/22727. This patchset still has style issues and a possible problem on large disks. However, it was a agreed to get these committed before performing major surgery on them. PR: bin/22727 Submitted by: Randell Jesup <rjesup@wgate.com>
2001-02-25 16:47:44 +00:00
.Pp
Remove whitespace at EOL.
2001-07-15 07:53:42 +00:00
Read the on-disk label for
Allow for easier configuration when using disklabel. A sample being: # size offset fstype [fsize bsize bps/cpg] a: 400M 0 4.2BSD 4096 16384 75 # (Cyl. 0 - 812*) b: 1G * swap c: * * unused e: 204800 * 4.2BSD f: 5g * 4.2BSD g: * * 4.2BSD These patches are the original work of Randell Jesup, and I believe Matt Dillon, with additional work by Warner Losh. Please let me know if I've left someone out. Incorporated into this is the fix for PR bin/22727. This patchset still has style issues and a possible problem on large disks. However, it was a agreed to get these committed before performing major surgery on them. PR: bin/22727 Submitted by: Randell Jesup <rjesup@wgate.com>
2001-02-25 16:47:44 +00:00
.Pa da0s1 ,
Give this manpage a good overhaul, including the markup. Notable changes: - Removed the "disktype" argument from the -B only synopsis form. This form doesn't touch the disk label, and doesn't use this argument. - Fixed the first example in the EXAMPLES section. Support for compatibility slices has been recently dropped from the GEOM kernels, and a bit later GEOM became standard. - Removed the buggy notion from rev. 1.37 that disklabel(8) may be used to define mount points; it cannot. Improve some DOS partition / FreeBSD slice wording. Among these, ``dangerously-dedicated slice'' was just a nonsense. ;-)
2003-03-15 22:00:45 +00:00
edit it, and display what the new label would be (in sectors).
It does
.Em not
- Fix markup. - Somewhat improve wording. - Change the layout of the EXAMPLES section so that descriptions come before example, as in most other manpages. - Fix a bad example that edits a label using a `c' partition.
2006-12-29 16:28:38 +00:00
install the new label either in-core or on-disk:
Allow for easier configuration when using disklabel. A sample being: # size offset fstype [fsize bsize bps/cpg] a: 400M 0 4.2BSD 4096 16384 75 # (Cyl. 0 - 812*) b: 1G * swap c: * * unused e: 204800 * 4.2BSD f: 5g * 4.2BSD g: * * 4.2BSD These patches are the original work of Randell Jesup, and I believe Matt Dillon, with additional work by Warner Losh. Please let me know if I've left someone out. Incorporated into this is the fix for PR bin/22727. This patchset still has style issues and a possible problem on large disks. However, it was a agreed to get these committed before performing major surgery on them. PR: bin/22727 Submitted by: Randell Jesup <rjesup@wgate.com>
2001-02-25 16:47:44 +00:00
.Pp
- Fix markup. - Somewhat improve wording. - Change the layout of the EXAMPLES section so that descriptions come before example, as in most other manpages. - Fix a bad example that edits a label using a `c' partition.
2006-12-29 16:28:38 +00:00
.Dl "bsdlabel -e -n da0s1"
Finally implement the "auto" disktype. It attempts to get all the required information from the driver, and produce a virgin disklabel for it. The latter might be further edited with `disklabel -e' to satisfy the user's need. The magic sequence is: disklabel -r -w sdX auto disklabel -e sdX
1996-01-22 01:01:15 +00:00
.Pp
More axe-work: Hide all the historical fields of the label, unless people ask for them with -A, set them to intelligently chosen defaults otherwise. Distill the manual page to remove inaccuracies, misundertandings and obsolete information. It can probably still be done better but now at least it is not misinforming people.
2003-05-03 09:58:20 +00:00
Write a default label on
.Pa da0s1 .
Give this manpage a good overhaul, including the markup. Notable changes: - Removed the "disktype" argument from the -B only synopsis form. This form doesn't touch the disk label, and doesn't use this argument. - Fixed the first example in the EXAMPLES section. Support for compatibility slices has been recently dropped from the GEOM kernels, and a bit later GEOM became standard. - Removed the buggy notion from rev. 1.37 that disklabel(8) may be used to define mount points; it cannot. Improve some DOS partition / FreeBSD slice wording. Among these, ``dangerously-dedicated slice'' was just a nonsense. ;-)
2003-03-15 22:00:45 +00:00
Use another
.Nm Fl e
command to edit the
- Fix markup. - Somewhat improve wording. - Change the layout of the EXAMPLES section so that descriptions come before example, as in most other manpages. - Fix a bad example that edits a label using a `c' partition.
2006-12-29 16:28:38 +00:00
partitioning and file system information:
Finally implement the "auto" disktype. It attempts to get all the required information from the driver, and produce a virgin disklabel for it. The latter might be further edited with `disklabel -e' to satisfy the user's need. The magic sequence is: disklabel -r -w sdX auto disklabel -e sdX
1996-01-22 01:01:15 +00:00
.Pp
- Fix markup. - Somewhat improve wording. - Change the layout of the EXAMPLES section so that descriptions come before example, as in most other manpages. - Fix a bad example that edits a label using a `c' partition.
2006-12-29 16:28:38 +00:00
.Dl "bsdlabel -w da0s1"
BSD 4.4 Lite sbin Sources Note: XNSrouted and routed NOT imported here, they shall be imported with usr.sbin.
1994-05-26 06:35:07 +00:00
.Pp
Remove whitespace at EOL.
2001-07-15 07:53:42 +00:00
Restore the on-disk and in-core label for
Add support for virgin disklabels Submitted by: dillon
2000-10-31 07:07:39 +00:00
.Pa da0s1
Make intelligible: Describe the command formats in English. Add references to other programs (boot0cfg, fdisk). Remove some old cruft, including FUD about single-level bootstraps. Add example of output format. Not-objected-to-by: msmith rnordier
1999-07-31 08:11:58 +00:00
from information in
- Fix markup. - Somewhat improve wording. - Change the layout of the EXAMPLES section so that descriptions come before example, as in most other manpages. - Fix a bad example that edits a label using a `c' partition.
2006-12-29 16:28:38 +00:00
.Pa savedlabel :
BSD 4.4 Lite sbin Sources Note: XNSrouted and routed NOT imported here, they shall be imported with usr.sbin.
1994-05-26 06:35:07 +00:00
.Pp
- Fix markup. - Somewhat improve wording. - Change the layout of the EXAMPLES section so that descriptions come before example, as in most other manpages. - Fix a bad example that edits a label using a `c' partition.
2006-12-29 16:28:38 +00:00
.Dl "bsdlabel -R da0s1 savedlabel"
Allow for easier configuration when using disklabel. A sample being: # size offset fstype [fsize bsize bps/cpg] a: 400M 0 4.2BSD 4096 16384 75 # (Cyl. 0 - 812*) b: 1G * swap c: * * unused e: 204800 * 4.2BSD f: 5g * 4.2BSD g: * * 4.2BSD These patches are the original work of Randell Jesup, and I believe Matt Dillon, with additional work by Warner Losh. Please let me know if I've left someone out. Incorporated into this is the fix for PR bin/22727. This patchset still has style issues and a possible problem on large disks. However, it was a agreed to get these committed before performing major surgery on them. PR: bin/22727 Submitted by: Randell Jesup <rjesup@wgate.com>
2001-02-25 16:47:44 +00:00
.Pp
Remove whitespace at EOL.
2001-07-15 07:53:42 +00:00
Display what the label would be for
Allow for easier configuration when using disklabel. A sample being: # size offset fstype [fsize bsize bps/cpg] a: 400M 0 4.2BSD 4096 16384 75 # (Cyl. 0 - 812*) b: 1G * swap c: * * unused e: 204800 * 4.2BSD f: 5g * 4.2BSD g: * * 4.2BSD These patches are the original work of Randell Jesup, and I believe Matt Dillon, with additional work by Warner Losh. Please let me know if I've left someone out. Incorporated into this is the fix for PR bin/22727. This patchset still has style issues and a possible problem on large disks. However, it was a agreed to get these committed before performing major surgery on them. PR: bin/22727 Submitted by: Randell Jesup <rjesup@wgate.com>
2001-02-25 16:47:44 +00:00
.Pa da0s1
using the partition layout in
.Pa label_layout .
The disk labels generated by bsdlabel can no address more than 0xffffffff sectors. Document this limit and avoid installing bogus labels on disks with more sectors. Allowing the installation of labels addressing as much of the disk as possiable may be a useful addition in some situations, but this was easy to implement and should reduce confusion. PR: bin/71408
2004-09-09 07:46:53 +00:00
This is useful for determining how much space would be allotted for various
partitions with a labeling scheme using
mdoc(7) police: misc formatting fixes. (This page still needs a lot of work.)
2001-03-05 15:33:54 +00:00
.Cm % Ns -based
or
.Cm *
- Fix markup. - Somewhat improve wording. - Change the layout of the EXAMPLES section so that descriptions come before example, as in most other manpages. - Fix a bad example that edits a label using a `c' partition.
2006-12-29 16:28:38 +00:00
partition sizes:
Allow for easier configuration when using disklabel. A sample being: # size offset fstype [fsize bsize bps/cpg] a: 400M 0 4.2BSD 4096 16384 75 # (Cyl. 0 - 812*) b: 1G * swap c: * * unused e: 204800 * 4.2BSD f: 5g * 4.2BSD g: * * 4.2BSD These patches are the original work of Randell Jesup, and I believe Matt Dillon, with additional work by Warner Losh. Please let me know if I've left someone out. Incorporated into this is the fix for PR bin/22727. This patchset still has style issues and a possible problem on large disks. However, it was a agreed to get these committed before performing major surgery on them. PR: bin/22727 Submitted by: Randell Jesup <rjesup@wgate.com>
2001-02-25 16:47:44 +00:00
.Pp
- Fix markup. - Somewhat improve wording. - Change the layout of the EXAMPLES section so that descriptions come before example, as in most other manpages. - Fix a bad example that edits a label using a `c' partition.
2006-12-29 16:28:38 +00:00
.Dl "bsdlabel -R -n da0s1 label_layout"
BSD 4.4 Lite sbin Sources Note: XNSrouted and routed NOT imported here, they shall be imported with usr.sbin.
1994-05-26 06:35:07 +00:00
.Pp
Remove whitespace at EOL.
2001-07-15 07:53:42 +00:00
Install a new bootstrap on
Add support for virgin disklabels Submitted by: dillon
2000-10-31 07:07:39 +00:00
.Pa da0s1 .
BSD 4.4 Lite sbin Sources Note: XNSrouted and routed NOT imported here, they shall be imported with usr.sbin.
1994-05-26 06:35:07 +00:00
The boot code comes from
- Fix markup. - Somewhat improve wording. - Change the layout of the EXAMPLES section so that descriptions come before example, as in most other manpages. - Fix a bad example that edits a label using a `c' partition.
2006-12-29 16:28:38 +00:00
.Pa /boot/boot :
BSD 4.4 Lite sbin Sources Note: XNSrouted and routed NOT imported here, they shall be imported with usr.sbin.
1994-05-26 06:35:07 +00:00
.Pp
- Fix markup. - Somewhat improve wording. - Change the layout of the EXAMPLES section so that descriptions come before example, as in most other manpages. - Fix a bad example that edits a label using a `c' partition.
2006-12-29 16:28:38 +00:00
.Dl "bsdlabel -B da0s1"
BSD 4.4 Lite sbin Sources Note: XNSrouted and routed NOT imported here, they shall be imported with usr.sbin.
1994-05-26 06:35:07 +00:00
.Pp
Install a new label and bootstrap.
Give this manpage a good overhaul, including the markup. Notable changes: - Removed the "disktype" argument from the -B only synopsis form. This form doesn't touch the disk label, and doesn't use this argument. - Fixed the first example in the EXAMPLES section. Support for compatibility slices has been recently dropped from the GEOM kernels, and a bit later GEOM became standard. - Removed the buggy notion from rev. 1.37 that disklabel(8) may be used to define mount points; it cannot. Improve some DOS partition / FreeBSD slice wording. Among these, ``dangerously-dedicated slice'' was just a nonsense. ;-)
2003-03-15 22:00:45 +00:00
The bootstrap code comes from the file
.Pa newboot
- Fix markup. - Somewhat improve wording. - Change the layout of the EXAMPLES section so that descriptions come before example, as in most other manpages. - Fix a bad example that edits a label using a `c' partition.
2006-12-29 16:28:38 +00:00
in the current working directory:
.Pp
.Dl "bsdlabel -w -B -b newboot /dev/da0s1"
Add support for virgin disklabels Submitted by: dillon
2000-10-31 07:07:39 +00:00
.Pp
Completely wipe any prior information on the disk, creating a new bootable
Give this manpage a good overhaul, including the markup. Notable changes: - Removed the "disktype" argument from the -B only synopsis form. This form doesn't touch the disk label, and doesn't use this argument. - Fixed the first example in the EXAMPLES section. Support for compatibility slices has been recently dropped from the GEOM kernels, and a bit later GEOM became standard. - Removed the buggy notion from rev. 1.37 that disklabel(8) may be used to define mount points; it cannot. Improve some DOS partition / FreeBSD slice wording. Among these, ``dangerously-dedicated slice'' was just a nonsense. ;-)
2003-03-15 22:00:45 +00:00
disk with a
.Tn DOS
partition table containing one slice, covering the whole disk.
Initialize the label on this slice,
then edit it.
The
.Xr dd 1
commands are optional, but may be necessary for some
.Tn BIOS Ns es
to properly
- Fix markup. - Somewhat improve wording. - Change the layout of the EXAMPLES section so that descriptions come before example, as in most other manpages. - Fix a bad example that edits a label using a `c' partition.
2006-12-29 16:28:38 +00:00
recognize the disk:
.Bd -literal -offset indent
dd if=/dev/zero of=/dev/da0 bs=512 count=32
It's 2015, and some people are still trying to use fdisk and then go asking what debug flags to set for GEOM to make it work. Advice them to use gpart(8) instead. Something similar should probably done with disklabel, but I need to rewrite the disklabel examples first. Reviewed by: wblock@ MFC after: 1 month Sponsored by: The FreeBSD Foundation Differential Revision: https://reviews.freebsd.org/D3315
2015-09-02 14:08:43 +00:00
gpart create -s MBR da0
gpart add -t freebsd da0
gpart set -a active -i 1 da0
gpart bootcode -b /boot/mbr da0
- Fix markup. - Somewhat improve wording. - Change the layout of the EXAMPLES section so that descriptions come before example, as in most other manpages. - Fix a bad example that edits a label using a `c' partition.
2006-12-29 16:28:38 +00:00
dd if=/dev/zero of=/dev/da0s1 bs=512 count=32
bsdlabel -w -B da0s1
bsdlabel -e da0s1
.Ed
Allow for easier configuration when using disklabel. A sample being: # size offset fstype [fsize bsize bps/cpg] a: 400M 0 4.2BSD 4096 16384 75 # (Cyl. 0 - 812*) b: 1G * swap c: * * unused e: 204800 * 4.2BSD f: 5g * 4.2BSD g: * * 4.2BSD These patches are the original work of Randell Jesup, and I believe Matt Dillon, with additional work by Warner Losh. Please let me know if I've left someone out. Incorporated into this is the fix for PR bin/22727. This patchset still has style issues and a possible problem on large disks. However, it was a agreed to get these committed before performing major surgery on them. PR: bin/22727 Submitted by: Randell Jesup <rjesup@wgate.com>
2001-02-25 16:47:44 +00:00
.Pp
Give this manpage a good overhaul, including the markup. Notable changes: - Removed the "disktype" argument from the -B only synopsis form. This form doesn't touch the disk label, and doesn't use this argument. - Fixed the first example in the EXAMPLES section. Support for compatibility slices has been recently dropped from the GEOM kernels, and a bit later GEOM became standard. - Removed the buggy notion from rev. 1.37 that disklabel(8) may be used to define mount points; it cannot. Improve some DOS partition / FreeBSD slice wording. Among these, ``dangerously-dedicated slice'' was just a nonsense. ;-)
2003-03-15 22:00:45 +00:00
This is an example disk label that uses some of the new partition size types
mdoc(7) police: misc formatting fixes. (This page still needs a lot of work.)
2001-03-05 15:33:54 +00:00
such as
.Cm % , M , G ,
and
.Cm * ,
which could be used as a source file for
Sweep man pages replacing ad -> ada. Approved by: re (blackend) MFC after: 1 week X-MFC note: stable/9 only
2013-10-01 18:41:53 +00:00
.Dq Li "bsdlabel -R ada0s1 new_label_file" :
Allow for easier configuration when using disklabel. A sample being: # size offset fstype [fsize bsize bps/cpg] a: 400M 0 4.2BSD 4096 16384 75 # (Cyl. 0 - 812*) b: 1G * swap c: * * unused e: 204800 * 4.2BSD f: 5g * 4.2BSD g: * * 4.2BSD These patches are the original work of Randell Jesup, and I believe Matt Dillon, with additional work by Warner Losh. Please let me know if I've left someone out. Incorporated into this is the fix for PR bin/22727. This patchset still has style issues and a possible problem on large disks. However, it was a agreed to get these committed before performing major surgery on them. PR: bin/22727 Submitted by: Randell Jesup <rjesup@wgate.com>
2001-02-25 16:47:44 +00:00
.Bd -literal -offset 4n
Sweep man pages replacing ad -> ada. Approved by: re (blackend) MFC after: 1 week X-MFC note: stable/9 only
2013-10-01 18:41:53 +00:00
# /dev/ada0s1:
Allow for easier configuration when using disklabel. A sample being: # size offset fstype [fsize bsize bps/cpg] a: 400M 0 4.2BSD 4096 16384 75 # (Cyl. 0 - 812*) b: 1G * swap c: * * unused e: 204800 * 4.2BSD f: 5g * 4.2BSD g: * * 4.2BSD These patches are the original work of Randell Jesup, and I believe Matt Dillon, with additional work by Warner Losh. Please let me know if I've left someone out. Incorporated into this is the fix for PR bin/22727. This patchset still has style issues and a possible problem on large disks. However, it was a agreed to get these committed before performing major surgery on them. PR: bin/22727 Submitted by: Randell Jesup <rjesup@wgate.com>
2001-02-25 16:47:44 +00:00
8 partitions:
# size offset fstype [fsize bsize bps/cpg]
Add history section for bsdlabel(8) http://minnie.tuhs.org/cgi-bin/utree.pl?file=4.3BSD-Tahoe/usr/man/cat8/disklabel.0 Remove tab after space, highlighted by igor PR: 212436 Approved by: bcr (mentor) MFC after: 5 days Differential Revision: https://reviews.freebsd.org/D8104
2016-10-05 19:56:10 +00:00
a: 400M 16 4.2BSD 4096 16384 75 # (Cyl. 0 - 812*)
Remove whitespace at EOL.
2001-07-15 07:53:42 +00:00
b: 1G * swap
c: * * unused
e: 204800 * 4.2BSD
f: 5g * 4.2BSD
g: * * 4.2BSD
Allow for easier configuration when using disklabel. A sample being: # size offset fstype [fsize bsize bps/cpg] a: 400M 0 4.2BSD 4096 16384 75 # (Cyl. 0 - 812*) b: 1G * swap c: * * unused e: 204800 * 4.2BSD f: 5g * 4.2BSD g: * * 4.2BSD These patches are the original work of Randell Jesup, and I believe Matt Dillon, with additional work by Warner Losh. Please let me know if I've left someone out. Incorporated into this is the fix for PR bin/22727. This patchset still has style issues and a possible problem on large disks. However, it was a agreed to get these committed before performing major surgery on them. PR: bin/22727 Submitted by: Randell Jesup <rjesup@wgate.com>
2001-02-25 16:47:44 +00:00
.Ed
The disk labels generated by bsdlabel can no address more than 0xffffffff sectors. Document this limit and avoid installing bogus labels on disks with more sectors. Allowing the installation of labels addressing as much of the disk as possiable may be a useful addition in some situations, but this was easy to implement and should reduce confusion. PR: bin/71408
2004-09-09 07:46:53 +00:00
.Sh DIAGNOSTICS
The kernel device drivers will not allow the size of a disk partition
to be decreased or the offset of a partition to be changed while it is open.
.Sh COMPATIBILITY
Due to the use of an
Globally replace u_int*_t from (non-contributed) man pages. The reasoning behind this, is that if we are consistent in our documentation about the uint*_t stuff, people will be less tempted to write new code that uses the non-standard types. I am not going to bump the man page dates, as these changes can be considered style nits. The meaning of the man pages is unaffected. MFC after: 1 month
2012-02-12 18:29:56 +00:00
.Vt uint32_t
The disk labels generated by bsdlabel can no address more than 0xffffffff sectors. Document this limit and avoid installing bogus labels on disks with more sectors. Allowing the installation of labels addressing as much of the disk as possiable may be a useful addition in some situations, but this was easy to implement and should reduce confusion. PR: bin/71408
2004-09-09 07:46:53 +00:00
to store the number of sectors,
Scheduled mdoc(7) sweep.
2005-01-10 16:17:34 +00:00
.Bx
labels are restricted to a maximum of 2^32-1 sectors.
The disk labels generated by bsdlabel can no address more than 0xffffffff sectors. Document this limit and avoid installing bogus labels on disks with more sectors. Allowing the installation of labels addressing as much of the disk as possiable may be a useful addition in some situations, but this was easy to implement and should reduce confusion. PR: bin/71408
2004-09-09 07:46:53 +00:00
This usually means 2TB of disk space.
Larger disks should be partitioned using another method such as
o One more s/gpt/gpart/.
2008-11-05 09:28:30 +00:00
.Xr gpart 8 .
The disk labels generated by bsdlabel can no address more than 0xffffffff sectors. Document this limit and avoid installing bogus labels on disks with more sectors. Allowing the installation of labels addressing as much of the disk as possiable may be a useful addition in some situations, but this was easy to implement and should reduce confusion. PR: bin/71408
2004-09-09 07:46:53 +00:00
.Pp
Scheduled mdoc(7) sweep.
2005-01-10 16:17:34 +00:00
The various
.Bx Ns s
all use slightly different versions of
.Bx
labels and
The disk labels generated by bsdlabel can no address more than 0xffffffff sectors. Document this limit and avoid installing bogus labels on disks with more sectors. Allowing the installation of labels addressing as much of the disk as possiable may be a useful addition in some situations, but this was easy to implement and should reduce confusion. PR: bin/71408
2004-09-09 07:46:53 +00:00
are not generally compatible.
BSD 4.4 Lite sbin Sources Note: XNSrouted and routed NOT imported here, they shall be imported with usr.sbin.
1994-05-26 06:35:07 +00:00
.Sh SEE ALSO
Clarify the currently used partition types. Add cross-references to ccd(4) and vinum(8).
2001-05-14 23:26:40 +00:00
.Xr ccd 4 ,
mdoc(7) fixes. Approved by: re (blanket)
2003-05-24 19:53:08 +00:00
.Xr geom 4 ,
Give this manpage a good overhaul, including the markup. Notable changes: - Removed the "disktype" argument from the -B only synopsis form. This form doesn't touch the disk label, and doesn't use this argument. - Fixed the first example in the EXAMPLES section. Support for compatibility slices has been recently dropped from the GEOM kernels, and a bit later GEOM became standard. - Removed the buggy notion from rev. 1.37 that disklabel(8) may be used to define mount points; it cannot. Improve some DOS partition / FreeBSD slice wording. Among these, ``dangerously-dedicated slice'' was just a nonsense. ;-)
2003-03-15 22:00:45 +00:00
.Xr md 4 ,
Make intelligible: Describe the command formats in English. Add references to other programs (boot0cfg, fdisk). Remove some old cruft, including FUD about single-level bootstraps. Add example of output format. Not-objected-to-by: msmith rnordier
1999-07-31 08:11:58 +00:00
.Xr disktab 5 ,
Various man page cleanup: - Sort xrefs - FreeBSD.ORG -> FreeBSD.org - Properly xref RFCs. - Be consistent with section names as outlined in mdoc(7). - Other misc mdoc cleanup. PR: doc/13144 Submitted by: Alexey M. Zelkin <phantom@cris.net>
1999-08-15 08:06:12 +00:00
.Xr boot0cfg 8 ,
o Replace Xr to gpt(8) which is gone by gpart(8).
2008-11-05 09:27:13 +00:00
.Xr gpart 8 ,
- Don't mention (wrong) defaults for FFS file system parameters, replace them with references to newfs(8) which documents them. - Remove mentions of LFS support for which was retired in 1998. - Regenerate an example output. PR: docs/84913 MFC after: 3 days
2006-10-13 15:44:29 +00:00
.Xr newfs 8
Add history section for bsdlabel(8) http://minnie.tuhs.org/cgi-bin/utree.pl?file=4.3BSD-Tahoe/usr/man/cat8/disklabel.0 Remove tab after space, highlighted by igor PR: 212436 Approved by: bcr (mentor) MFC after: 5 days Differential Revision: https://reviews.freebsd.org/D8104
2016-10-05 19:56:10 +00:00
.Sh HISTORY
The
.Nm disklabel
utility appeared in
.Bx 4.3 Tahoe .
Reference in New Issue Copy Permalink