Aren
/
NetBSD
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity
NetBSD/sbin/mbrlabel/mbrlabel.8

95 lines
3.1 KiB
Groff
Raw Normal View History

Moved from mbrlabel.8,v
2000-03-15 14:55:33 +03:00
.\" Copyright (C) 1998 Wolfgang Solfrank.
.\" Copyright (C) 1998 TooLs GmbH.
.\" All rights reserved.
.\"
.\" 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.
.\" 3. All advertising materials mentioning features or use of this software
.\" must display the following acknowledgement:
.\" This product includes software developed by TooLs GmbH.
.\" 4. The name of TooLs GmbH may not be used to endorse or promote products
.\" derived from this software without specific prior written permission.
.\"
.\" THIS SOFTWARE IS PROVIDED BY TOOLS GMBH ``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 TOOLS GMBH 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.
.\"
i got sick of the brain damage that mbrlabel used to do, and had gotten bitten by mbrlabel trashing my incore disklabel to a point where the machine wasn't usable, so I reworked it: * only update the incore (and on-disk) label if `-f' is given. by default, the proposed disklabel will be printed but no changes will occur * add -q, to make the default operation a bit more quiet. * leave existing `used' in-core partition slots alone, and only add entries to the incore label if: - there's not an existing partition of the same size and offset (even of a different type) - there's a free partition slot (`unused', with size == 0) * use DIOCWDINFO instead of DIOCSDINFO, to update the incore as well as the on-disk label * use showpartitions() from ../disklabel/printlabel.c this should make mbrlabel a *lot* more useful.
2000-12-24 16:57:37 +03:00
.\" $NetBSD: mbrlabel.8,v 1.6 2000/12/24 13:57:37 lukem Exp $
Moved from mbrlabel.8,v
2000-03-15 14:55:33 +03:00
.\"
i got sick of the brain damage that mbrlabel used to do, and had gotten bitten by mbrlabel trashing my incore disklabel to a point where the machine wasn't usable, so I reworked it: * only update the incore (and on-disk) label if `-f' is given. by default, the proposed disklabel will be printed but no changes will occur * add -q, to make the default operation a bit more quiet. * leave existing `used' in-core partition slots alone, and only add entries to the incore label if: - there's not an existing partition of the same size and offset (even of a different type) - there's a free partition slot (`unused', with size == 0) * use DIOCWDINFO instead of DIOCSDINFO, to update the incore as well as the on-disk label * use showpartitions() from ../disklabel/printlabel.c this should make mbrlabel a *lot* more useful.
2000-12-24 16:57:37 +03:00
.Dd December 24, 2000
Moved from mbrlabel.8,v
2000-03-15 14:55:33 +03:00
.Dt MBRLABEL 8
.Os
.Sh NAME
.Nm mbrlabel
i got sick of the brain damage that mbrlabel used to do, and had gotten bitten by mbrlabel trashing my incore disklabel to a point where the machine wasn't usable, so I reworked it: * only update the incore (and on-disk) label if `-f' is given. by default, the proposed disklabel will be printed but no changes will occur * add -q, to make the default operation a bit more quiet. * leave existing `used' in-core partition slots alone, and only add entries to the incore label if: - there's not an existing partition of the same size and offset (even of a different type) - there's a free partition slot (`unused', with size == 0) * use DIOCWDINFO instead of DIOCSDINFO, to update the incore as well as the on-disk label * use showpartitions() from ../disklabel/printlabel.c this should make mbrlabel a *lot* more useful.
2000-12-24 16:57:37 +03:00
.Nd generate incore disk label from MBR label(s)
Moved from mbrlabel.8,v
2000-03-15 14:55:33 +03:00
.Sh SYNOPSIS
.Nm
i got sick of the brain damage that mbrlabel used to do, and had gotten bitten by mbrlabel trashing my incore disklabel to a point where the machine wasn't usable, so I reworked it: * only update the incore (and on-disk) label if `-f' is given. by default, the proposed disklabel will be printed but no changes will occur * add -q, to make the default operation a bit more quiet. * leave existing `used' in-core partition slots alone, and only add entries to the incore label if: - there's not an existing partition of the same size and offset (even of a different type) - there's a free partition slot (`unused', with size == 0) * use DIOCWDINFO instead of DIOCSDINFO, to update the incore as well as the on-disk label * use showpartitions() from ../disklabel/printlabel.c this should make mbrlabel a *lot* more useful.
2000-12-24 16:57:37 +03:00
.Op Fl fq
Moved from mbrlabel.8,v
2000-03-15 14:55:33 +03:00
.Ar device
.Sh DESCRIPTION
.Nm
i got sick of the brain damage that mbrlabel used to do, and had gotten bitten by mbrlabel trashing my incore disklabel to a point where the machine wasn't usable, so I reworked it: * only update the incore (and on-disk) label if `-f' is given. by default, the proposed disklabel will be printed but no changes will occur * add -q, to make the default operation a bit more quiet. * leave existing `used' in-core partition slots alone, and only add entries to the incore label if: - there's not an existing partition of the same size and offset (even of a different type) - there's a free partition slot (`unused', with size == 0) * use DIOCWDINFO instead of DIOCSDINFO, to update the incore as well as the on-disk label * use showpartitions() from ../disklabel/printlabel.c this should make mbrlabel a *lot* more useful.
2000-12-24 16:57:37 +03:00
is used to update an incore
.Nx
disk label from the Master Boot Record (MBR) label(s) found
Moved from mbrlabel.8,v
2000-03-15 14:55:33 +03:00
on disks that were previously used on DOS/Windows systems (or
other MBR using systems).
.Pp
.Nm
i got sick of the brain damage that mbrlabel used to do, and had gotten bitten by mbrlabel trashing my incore disklabel to a point where the machine wasn't usable, so I reworked it: * only update the incore (and on-disk) label if `-f' is given. by default, the proposed disklabel will be printed but no changes will occur * add -q, to make the default operation a bit more quiet. * leave existing `used' in-core partition slots alone, and only add entries to the incore label if: - there's not an existing partition of the same size and offset (even of a different type) - there's a free partition slot (`unused', with size == 0) * use DIOCWDINFO instead of DIOCSDINFO, to update the incore as well as the on-disk label * use showpartitions() from ../disklabel/printlabel.c this should make mbrlabel a *lot* more useful.
2000-12-24 16:57:37 +03:00
scans the MBR contained in the very first block of the disk,
then walks through every extended partition found and generating
additional partition entries for the disk from the MBRs found in
those extended partitions.
.Pp
Each MBR partition which does not have an equivalent partition in incore
disk label (equivalent in having the same size and offset) is added to
the first free partition slot in the incore disk label. A free
partition slot is defined as one with an
.Dv fstype
of
.Sq Li unused
and a
.Dv size
of zero
.Pq Sq 0 .
If there are not enough free slots in the incore disk label, a warning
will be issued.
.Pp
Moved from mbrlabel.8,v
2000-03-15 14:55:33 +03:00
The raw partition (typically partition
.Em c ,
but
.Em d
i got sick of the brain damage that mbrlabel used to do, and had gotten bitten by mbrlabel trashing my incore disklabel to a point where the machine wasn't usable, so I reworked it: * only update the incore (and on-disk) label if `-f' is given. by default, the proposed disklabel will be printed but no changes will occur * add -q, to make the default operation a bit more quiet. * leave existing `used' in-core partition slots alone, and only add entries to the incore label if: - there's not an existing partition of the same size and offset (even of a different type) - there's a free partition slot (`unused', with size == 0) * use DIOCWDINFO instead of DIOCSDINFO, to update the incore as well as the on-disk label * use showpartitions() from ../disklabel/printlabel.c this should make mbrlabel a *lot* more useful.
2000-12-24 16:57:37 +03:00
on i386 and some othe platforms) is left alone during this process.
Moved from mbrlabel.8,v
2000-03-15 14:55:33 +03:00
.Pp
i got sick of the brain damage that mbrlabel used to do, and had gotten bitten by mbrlabel trashing my incore disklabel to a point where the machine wasn't usable, so I reworked it: * only update the incore (and on-disk) label if `-f' is given. by default, the proposed disklabel will be printed but no changes will occur * add -q, to make the default operation a bit more quiet. * leave existing `used' in-core partition slots alone, and only add entries to the incore label if: - there's not an existing partition of the same size and offset (even of a different type) - there's a free partition slot (`unused', with size == 0) * use DIOCWDINFO instead of DIOCSDINFO, to update the incore as well as the on-disk label * use showpartitions() from ../disklabel/printlabel.c this should make mbrlabel a *lot* more useful.
2000-12-24 16:57:37 +03:00
If
.Fl f
is given, then the incore disk label is updated.
Otherwise, the proposed changed disk label will be displayed and no
update will occur.
Moved from mbrlabel.8,v
2000-03-15 14:55:33 +03:00
.Pp
i got sick of the brain damage that mbrlabel used to do, and had gotten bitten by mbrlabel trashing my incore disklabel to a point where the machine wasn't usable, so I reworked it: * only update the incore (and on-disk) label if `-f' is given. by default, the proposed disklabel will be printed but no changes will occur * add -q, to make the default operation a bit more quiet. * leave existing `used' in-core partition slots alone, and only add entries to the incore label if: - there's not an existing partition of the same size and offset (even of a different type) - there's a free partition slot (`unused', with size == 0) * use DIOCWDINFO instead of DIOCSDINFO, to update the incore as well as the on-disk label * use showpartitions() from ../disklabel/printlabel.c this should make mbrlabel a *lot* more useful.
2000-12-24 16:57:37 +03:00
If
.Fl q
is given,
.Nm
performs its operation in a quiet fashion.
Moved from mbrlabel.8,v
2000-03-15 14:55:33 +03:00
.Sh SEE ALSO
xref (disklabel.8, fdisk.8, mbrlabel.8) as appropriate
2000-11-14 14:06:19 +03:00
.Xr disklabel 8 ,
.Xr fdisk 8
Moved from mbrlabel.8,v
2000-03-15 14:55:33 +03:00
.Sh HISTORY
The
.Nm
command appeared in
.Nx 1.4 .