xref: /netbsd/sbin/mbrlabel/mbrlabel.8 (revision bf9ec67e)
1.\" Copyright (C) 1998 Wolfgang Solfrank.
2.\" Copyright (C) 1998 TooLs GmbH.
3.\" All rights reserved.
4.\"
5.\" Redistribution and use in source and binary forms, with or without
6.\" modification, are permitted provided that the following conditions
7.\" are met:
8.\" 1. Redistributions of source code must retain the above copyright
9.\"    notice, this list of conditions and the following disclaimer.
10.\" 2. Redistributions in binary form must reproduce the above copyright
11.\"    notice, this list of conditions and the following disclaimer in the
12.\"    documentation and/or other materials provided with the distribution.
13.\" 3. All advertising materials mentioning features or use of this software
14.\"    must display the following acknowledgement:
15.\"	This product includes software developed by TooLs GmbH.
16.\" 4. The name of TooLs GmbH may not be used to endorse or promote products
17.\"    derived from this software without specific prior written permission.
18.\"
19.\" THIS SOFTWARE IS PROVIDED BY TOOLS GMBH ``AS IS'' AND ANY EXPRESS OR
20.\" IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
21.\" OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.
22.\" IN NO EVENT SHALL TOOLS GMBH BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
23.\" SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO,
24.\" PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS;
25.\" OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY,
26.\" WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR
27.\" OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF
28.\" ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
29.\"
30.\"	$NetBSD: mbrlabel.8,v 1.13 2002/01/24 23:35:10 fair Exp $
31.\"
32.Dd May 1, 2001
33.Dt MBRLABEL 8
34.Os
35.Sh NAME
36.Nm mbrlabel
37.Nd update disk label from MBR label(s)
38.Sh SYNOPSIS
39.Nm
40.Op Fl fqrw
41.Ar device
42.Sh DESCRIPTION
43.Nm
44is used to update a
45.Nx
46disk label from the Master Boot Record (MBR) label(s) found
47on disks that were previously used on DOS/Windows systems (or
48other MBR using systems).
49.Pp
50.Nm
51scans the MBR contained in the very first block of the disk,
52then walks through every extended partition found and generating
53additional partition entries for the disk from the MBRs found in
54those extended partitions.
55.Pp
56Each MBR partition which does not have an equivalent partition in the
57disk label (equivalent in having the same size and offset) is added to
58the first free partition slot in the disk label.
59A free partition slot is defined as one with an
60.Dv fstype
61of
62.Sq Li unused
63and a
64.Dv size
65of zero
66.Pq Sq 0 .
67If there are not enough free slots in the disk label, a warning
68will be issued.
69.Pp
70The raw partition (typically partition
71.Em c ,
72but
73.Em d
74on i386 and some other platforms) is left alone during this process.
75.Pp
76By default, the proposed changed disk label will be displayed and no
77disk label update will occur.
78.Pp
79Available options:
80.Pp
81.Bl -tag -width indent
82.It Fl f
83Force an update, even if there has been no change.
84.It Fl q
85Performs operations in a quiet fashion.
86.It Fl w
87Update the in-core label if it has been changed.
88.It Fl r
89In conjunction with
90.Fl w ,
91also update the on-disk label.
92.El
93.Sh SEE ALSO
94.Xr disklabel 8 ,
95.Xr fdisk 8 ,
96.Xr mbr 8
97.Sh HISTORY
98The
99.Nm
100command appeared in
101.Nx 1.4 .
102