HomeDocumentationDownloadDevelopmentAboutDonorsForumLinks

Subversion Repository

Parent Directory Parent Directory | Revision Log Revision Log

Revision 201 - (show annotations)
Sun Oct 4 15:01:40 2009 UTC (3 years, 7 months ago) by cjg
File size: 3860 byte(s) 
importing opt
1 .if n .ds Q \&"
2 .if t .ds Q ``
3 .if n .ds U \&"
4 .if t .ds U ''
5 .TH "NVSETENV" 8
6 .tr \&
7 .nr bi 0
8 .nr ll 0
9 .nr el 0
10 .de DS
11 ..
12 .de DE
13 ..
14 .de Pp
15 .ie \\n(ll>0 \{\
16 .ie \\n(bi=1 \{\
17 .nr bi 0
18 .if \\n(t\\n(ll=0 \{.IP \\(bu\}
19 .if \\n(t\\n(ll=1 \{.IP \\n+(e\\n(el.\}
20 .\}
21 .el .sp
22 .\}
23 .el \{\
24 .ie \\nh=1 \{\
25 .LP
26 .nr h 0
27 .\}
28 .el .PP
29 .\}
30 ..
31 .SH NAME
32
33 .Pp
34 \fBnvsetenv\fP - change/view Open Firmware environment variables
35 .Pp
36 .SH SYNOPSIS
37
38 .Pp
39 \fBnvsetenv
40 \f(CR[\fP\fIvariable\fP \f(CR[\fP\fIvalue\fP\f(CR\fB]]\fP\fP\fP
41 .Pp
42 .SH DESCRIPTION
43
44 .Pp
45 \fBnvsetenv\fP is a program to adjust or view the Open Firmware (OF)
46 boot parameters stored in non-volatile (battery-powered) RAM.
47 \fBnvsetenv\fP will show the current values of all OF's environment
48 variables when no parameters are given.
49 .Pp
50 .SH OPTIONS
51
52 .Pp
53 .nr ll +1
54 .nr t\n(ll 2
55 .if \n(ll>1 .RS
56 .IP "\fIvariable\fP"
57 .nr bi 1
58 .Pp
59 nvsetenv will show current value of an OF's
60 variable, if no value is given
61 .IP "\fIvariable value\fP"
62 .nr bi 1
63 .Pp
64 nvsetenv will set \fIvariable\fP to
65 \fIvalue\fP
66 .if \n(ll>1 .RE
67 .nr ll -1
68 .Pp
69 .SH EXAMPLES
70
71 .Pp
72 This example will set the boot device to the first SCSI disk on the
73 internal SCSI bus, using /vmlinux as boot image, trying to
74 use the third partition as root partition.
75 .DS
76 .sp
77 .ft RR
78 .nf
79 > nvsetenv boot-device "scsi-int/sd@0:0"
80 > nvsetenv boot-file " /vmlinux root=/dev/sda3"
81 .DE
82 .fi
83 .ec
84 .ft P
85 .sp
86 .Pp
87 Alternatives boot devices are:
88 .DS
89 .sp
90 .ft RR
91 .nf
92 scsi/sd@1:0 SCSI disk at ID 1
93 ata/ata-disk@0:0 Internal IDE disk
94 .DE
95 .fi
96 .ec
97 .ft P
98 .sp
99 .Pp
100 You can also boot from a floppy, you need a XCOFF-format kernel image
101 (in this example: vmlinux.coff), copied to a HFS format high-density
102 (1.44Mb) floppy.
103 .DS
104 .sp
105 .ft RR
106 .nf
107 > nvsetenv boot-device "fd:vmlinux.coff"
108 > nvsetenv boot-file " root=/dev/sda3"
109 .DE
110 .fi
111 .ec
112 .ft P
113 .sp
114
115 To return to MacOS, do:
116 .DS
117 .sp
118 .ft RR
119 .nf
120 > nvsetenv boot-device "/AAPL,ROM"
121 .DE
122 .fi
123 .ec
124 .ft P
125 .sp
126 .Pp
127 Valid values for "input-devices" are:
128 .DS
129 .sp
130 .ft RR
131 .nf
132 ttya Modem serial port
133 ttyb Printer serial port
134 kbd Keyboard
135 enet Ethernet interface
136 .DE
137 .fi
138 .ec
139 .ft P
140 .sp
141 .Pp
142 Valid values for "output-devices" are (machine and/or OF dependent):
143 .DS
144 .sp
145 .ft RR
146 .nf
147 screen Screen display (newer machines)
148 /chaos/control Screen display (7500, 7600 and 8500)
149 /bandit/ATY,264GT-B Screen display (6500)
150 .DE
151 .fi
152 .ec
153 .ft P
154 .sp
155 .Pp
156 OF is not designed to wait for your hard disk to spin up
157 (remember MacOS boots from ROM).
158 Use the following setting to have OF retry to boot from your disk
159 until is has spun up:
160 .DS
161 .sp
162 .ft RR
163 .nf
164 > nvsetenv boot-command "begin ['] boot catch 1000 ms cr again"
165 .DE
166 .fi
167 .ec
168 .ft P
169 .sp
170 .Pp
171 You only have to append an "S" to the "boot-file" variable to boot
172 Linux in single user mode.
173 .Pp
174 You can use install your own nvramrc patch using the following command:
175 .DS
176 .sp
177 .ft RR
178 .nf
179 > nvsetenv nvramrc "`cat file.patch`"
180 .DE
181 .fi
182 .ec
183 .ft P
184 .sp
185
186 (please note the backticks!), or:
187 .DS
188 .sp
189 .ft RR
190 .nf
191 > nvsetenv nvramrc "$(cat file.patch)"
192 .DE
193 .fi
194 .ec
195 .ft P
196 .sp
197 .Pp
198 .SH FILES
199
200 .Pp
201 .nr ll +1
202 .nr t\n(ll 2
203 .if \n(ll>1 .RS
204 .IP "\fI/dev/nvram\fP"
205 .nr bi 1
206 .Pp
207 character device with major number 10
208 and minor number 144
209 .IP "\fI/proc/cpuinfo\fP"
210 .nr bi 1
211 .Pp
212 to identify New/Old-World machines
213 .if \n(ll>1 .RE
214 .nr ll -1
215 .Pp
216 .SH SEE ALSO
217
218 .Pp
219 macos(8)
220 .Pp
221 .SH AUTHORS
222
223 .Pp
224 .DS
225 .sp
226 .ft RR
227 .nf
228 Paul Mackerras <paulus@cs.anu.edu.au> (program)
229 .DE
230 .fi
231 .ec
232 .ft P
233 .sp
234
235 .DS
236 .sp
237 .ft RR
238 .nf
239 Richard van Hees <R.M.vanHees@phys.uu.nl> (documentation)
240 .DE
241 .fi
242 .ec
243 .ft P
244 .sp
245
246 .DS
247 .sp
248 .ft RR
249 .nf
250 Klaus Halfmann <halfmann@libra.de> (NewWorld code)
251 .DE
252 .fi
253 .ec
254 .ft P
255 .sp
256 .Pp
  ViewVC Help
Powered by ViewVC 1.1.2