xref: /netbsd-src/sbin/mbrlabel/mbrlabel.8 (revision 8b0f9554ff8762542c4defc4f70e1eb76fb508fa)
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.16 2006/01/12 20:37:23 wiz Exp $
31.\"
32.Dd December 27, 2005
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.Op Fl s Ar sector
42.Ar device
43.Sh DESCRIPTION
44.Nm
45is used to update a
46.Nx
47disk label from the Master Boot Record (MBR) label(s) found
48on disks that were previously used on DOS/Windows systems (or
49other MBR using systems).
50.Pp
51.Nm
52scans the MBR contained in the very first block of the disk (or the
53block specified through the
54.Fl s
55flag), then walks through every extended partition found and generates
56additional partition entries for the disk from the MBRs found in
57those extended partitions.
58.Pp
59Each MBR partition which does not have an equivalent partition in the
60disk label (equivalent in having the same size and offset) is added to
61the first free partition slot in the disk label.
62A free partition slot is defined as one with an
63.Dv fstype
64of
65.Sq Li unused
66and a
67.Dv size
68of zero
69.Pq Sq 0 .
70If there are not enough free slots in the disk label, a warning
71will be issued.
72.Pp
73The raw partition (typically partition
74.Em c ,
75but
76.Em d
77on i386 and some other platforms) is left alone during this process.
78.Pp
79By default, the proposed changed disk label will be displayed and no
80disk label update will occur.
81.Pp
82Available options:
83.Pp
84.Bl -tag -width sXsectorX
85.It Fl f
86Force an update, even if there has been no change.
87.It Fl q
88Performs operations in a quiet fashion.
89.It Fl w
90Update the in-core label if it has been changed.
91.It Fl r
92In conjunction with
93.Fl w ,
94also update the on-disk label.
95.It Fl s Ar sector
96Specifies the logical sector number that has to be read from the disk
97in order to find the MBR.
98Useful if the disk has remapping drivers on it and the MBR is located
99in a non-standard place.
100Defaults to 0.
101.El
102.Sh SEE ALSO
103.Xr disklabel 8 ,
104.Xr dkctl 8 ,
105.Xr fdisk 8 ,
106.Xr mbr 8
107.Sh HISTORY
108The
109.Nm
110command appeared in
111.Nx 1.4 .
112