xref: /netbsd-src/sbin/svhlabel/svhlabel.8 (revision ed8d5fd9a50253b5d7d067631c7118798db10651)
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: svhlabel.8,v 1.3 2009/05/13 22:49:48 wiz Exp $
31.\"
32.Dd February 26, 2007
33.Dt SVHLABEL 8
34.Os
35.Sh NAME
36.Nm svhlabel
37.Nd update disk label from SGI Volume Header
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 Silicon Graphics Volume Header
47on disks that were previously used on IRIX systems.
48.Pp
49.Nm
50scans the Volume Header contained in the first blocks of the disk
51and generates additional partition entries for the disk from the
52entries found.
53.Pp
54Each Volume Header entry which does not have an equivalent partition
55in the disk label (equivalent in having the same size and offset) is
56added to the first free partition slot in the disk label.
57A free partition slot is defined as one with an
58.Dv fstype
59of
60.Sq Li unused
61and a
62.Dv size
63of zero
64.Pq Sq 0 .
65If there are not enough free slots in the disk label, a warning
66will be issued.
67.Pp
68The raw partition (typically partition
69.Em c ,
70but
71.Em d
72on i386 and some other platforms) is left alone during this process.
73.Pp
74By default, the proposed changed disk label will be displayed and no
75disk label update will occur.
76.Pp
77Available options:
78.Pp
79.Bl -tag -width sX
80.It Fl f
81Force an update, even if there has been no change.
82.It Fl q
83Performs operations in a quiet fashion.
84.It Fl r
85In conjunction with
86.Fl w ,
87also update the on-disk label.
88You probably do not want to do this.
89.It Fl w
90Update the in-core label if it has been changed.
91.El
92.Sh SEE ALSO
93.Xr disklabel 8 ,
94.Xr dkctl 8 ,
95.Xr mount_efs 8 ,
96.Xr sgivol 8
97.Sh HISTORY
98The
99.Nm
100command appeared in
101.Nx 5.0 .
102