Annotation of sys/arch/sgi/stand/sgivol/sgivol.8, Revision 1.1.1.1
1.1 nbrk 1: .\" $OpenBSD: sgivol.8,v 1.5 2007/05/31 19:20:05 jmc Exp $
2: .\"
3: .\" Copyright (c) 2005 Theo de Raadt
4: .\" All rights reserved.
5: .\"
6: .\" Redistribution and use in source and binary forms, with or without
7: .\" modification, are permitted provided that the following conditions
8: .\" are met:
9: .\" 1. Redistributions of source code must retain the above copyright
10: .\" notice, this list of conditions and the following disclaimer.
11: .\" 2. Redistributions in binary form must reproduce the above copyright
12: .\" notice, this list of conditions and the following disclaimer in the
13: .\" documentation and/or other materials provided with the distribution.
14: .\"
15: .\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR
16: .\" IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
17: .\" WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
18: .\" ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
19: .\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
20: .\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
21: .\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
22: .\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
23: .\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
24: .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
25: .\" SUCH DAMAGE.
26: .\"
27: .\"
28: .Dd $Mdocdate: May 31 2007 $
29: .Dt SGIVOL 8 sgi
30: .Os
31: .Sh NAME
32: .Nm sgivol
33: .Nd installs a volume header on disk
34: .Sh SYNOPSIS
35: .Nm sgivol
36: .Op Fl fq
37: .Op Fl d Ar vhfilename
38: .Ar disk
39: .Nm sgivol
40: .Op Fl fiq
41: .Op Fl h Ar vhsize
42: .Ar disk
43: .Nm sgivol
44: .Op Fl fq
45: .Op Fl l Ar vhfilename1 Ar vhfilename2
46: .Ar disk
47: .Nm sgivol
48: .Op Fl fq
49: .Op Fl r Ar vhfilename Ar diskfilename
50: .Ar disk
51: .Nm sgivol
52: .Op Fl fq
53: .Op Fl w Ar vhfilename Ar diskfilename
54: .Ar disk
55: .Sh DESCRIPTION
56: .Nm
57: is used to initialize, and then add or remove programs from the
58: SGI disk volume header.
59: .Pp
60: The SGI volume header is a disklabel-like structure located at the
61: start of a disk.
62: It is typically 3135 (512-byte) blocks in size, and can store a
63: variety of files inside it, typically boot programs.
64: .Pp
65: The options are as follows:
66: .Bl -tag -width flag_opt
67: .It Fl d Ar vhfilename
68: Delete the file
69: .Ar vhfilename
70: from the filesystem storage space in the volume header.
71: .It Fl f
72: Force.
73: Do not ask yes/no questions.
74: .It Fl h Ar vhsize
75: Choose an alternate volume header size, in (512-byte) disk blocks.
76: The default is 3135 blocks.
77: .It Fl i
78: Initialize a volume header on the supplied device.
79: .It Fl l Ar vhfilename1 Ar vhfilename2
80: Link the file
81: .Ar vhfilename1
82: to the file
83: .Ar vhfilename2
84: within the filesystem storage space in the volume header.
85: .It Fl q
86: Be quiet about various diagnostic issues.
87: .It Fl r Ar vhfilename Ar diskfilename
88: Locate the file
89: .Ar diskfilename
90: in the storage space of the volume header, and copy it to the
91: standard file
92: .Ar vhfilename .
93: .It Fl w Ar vhfilename Ar diskfilename
94: Copy the standard file
95: .Ar vhfilename
96: to the filesystem storage space in the volume header, placing
97: it there with the name
98: .Ar diskfilename .
99: .It Ar disk
100: The name of the disk containing the partition in which the second-stage
101: boot program resides and the first-stage boot program is to be installed.
102: This can either be specified in short form (e.g.,
103: .Sq sd0
104: or as the explicit device node, such as
105: .Pa /dev/rsd0c ) .
106: .Pp
107: Note that you must be in single-user mode or have your kernel in
108: insecure mode (see the
109: .Xr sysctl 8
110: .Va kern.securelevel
111: variable or
112: .Pa /etc/rc.securelevel )
113: to enable access to the raw partition of a mounted disk.
114: .El
115: .Pp
116: If no special flags are supplied,
117: .Nm
118: will display the current volume header information.
119: .Sh EXAMPLES
120: The typical use is
121: .Bd -literal -offset indent
122: # /usr/mdec/sgivol -f -i sd0
123: # /usr/mdec/sgivol -f -w boot /usr/mdec/boot sd0
124: .Ed
125: .Sh SEE ALSO
126: .Xr disklabel 8 ,
127: .Xr init 8
CVSweb