← Back to branch summary

~ubuntu-branches/ubuntu/karmic/powerpc-utils/karmic

« back to all changes in this revision

Viewing changes to nvsetenv.sgml

  • Committer: Bazaar Package Importer
  • Author(s): Daniel Jacobowitz
  • Date: 2001-07-15 22:15:13 UTC
  • Revision ID: james.westby@ubuntu.com-20010715221513-vprm8indlwtjz39y
Tags: upstream-1.1.3
Import upstream version 1.1.3

Show diffs side-by-side

added added

removed removed

Lines of Context:
nvsetenv.sgml
 
1
<!doctype linuxdoc system>
 
2
 
 
3
<manpage title="NVSETENV" sectnum="8">
 
4
 
 
5
<sect1> NAME<p>
 
6
<bf/nvsetenv/ - change/view OF's environment boot-variables 
 
7
 
 
8
<sect1> SYNOPSIS<p>
 
9
<bf>nvsetenv 
 
10
<tt/[/<em/variable/ <tt/[/<em/value/<tt/<bf/]]//
 
11
</bf>
 
12
 
 
13
<sect1> DESCRIPTION<p>
 
14
<bf/nvsetenv/ is a program to adjust or view the Open Firmware (OF)
 
15
boot parameters stored in non-volatile (battery-powered) RAM on your
 
16
Macintosh computer. 
 
17
<bf/nvsetenv/ will show the current values of all OF's environment
 
18
variables when no parameters are given.
 
19
 
 
20
<sect1> OPTIONS<p>
 
21
<descrip>
 
22
<tag/<em>variable</em>/ nvsetenv will show current value of an OF's
 
23
variable, if no value is given
 
24
<tag/<em>variable value</em>/ nvsetenv will set <em>variable</em> to
 
25
<em>value</em>
 
26
</descrip>
 
27
 
 
28
<sect1> EXAMPLES<p>
 
29
This example will set the boot device to the first SCSI disk on the
 
30
internal SCSI bus, using /vmlinux as boot image, trying to
 
31
use the third partition as root partition.
 
32
<tscreen><verb>
 
33
        > nvsetenv boot-device  "scsi-int/sd@0:0"
 
34
        > nvsetenv boot-file    " /vmlinux root=/dev/sda3"
 
35
</verb></tscreen>
 
36
 
 
37
Alternatives boot devices are: 
 
38
<tscreen><verb>
 
39
        scsi/sd@1:0             SCSI disk at ID 1
 
40
        ata/ata-disk@0:0        Internal IDE disk
 
41
</verb></tscreen>
 
42
 
 
43
You can also boot from a floppy, you need a XCOFF-format kernel image
 
44
(in this example: vmlinux.coff), copied to a HFS format high-density
 
45
(1.44Mb) floppy.
 
46
<tscreen><verb>
 
47
        > nvsetenv boot-device  "fd:vmlinux.coff"
 
48
        > nvsetenv boot-file    " root=/dev/sda3"
 
49
</verb></tscreen>
 
50
To return to MacOS, do:
 
51
<tscreen><verb>
 
52
        > nvsetenv boot-device  "/AAPL,ROM"
 
53
</verb></tscreen>
 
54
 
 
55
Valid values for "input-devices" are:
 
56
<tscreen><verb>
 
57
        ttya                    Modem serial port
 
58
        ttyb                    Printer serial port
 
59
        kbd                     Keyboard
 
60
        enet                    Ethernet interface
 
61
</verb></tscreen>
 
62
 
 
63
Valid values for "output-devices" are (machine and/or OF dependent):
 
64
<tscreen><verb>
 
65
        screen                  Screen display (newer machines)
 
66
        /chaos/control          Screen display (7500, 7600 and 8500)
 
67
        /bandit/ATY,264GT-B     Screen display (6500)
 
68
</verb></tscreen>
 
69
 
 
70
OF is not designed to wait for your hard disk to spin up
 
71
(remember MacOS boots from ROM).
 
72
Use the following setting to have OF retry to boot from your disk 
 
73
until is has spun up:
 
74
<tscreen><verb>
 
75
        > nvsetenv boot-command "begin ['] boot catch 1000 ms cr again"
 
76
</verb></tscreen>
 
77
 
 
78
You only have to append an "S" to the "boot-file" variable to boot
 
79
Linux in single user mode.
 
80
 
 
81
<sect1> FILES<p>
 
82
<bf/nvsetenv/
 
83
needs the following device:
 
84
<descrip>
 
85
<tag><em>/dev/nvram</em></tag> character device with major number 10
 
86
and minor number 144
 
87
</descrip>
 
88
 
 
89
<sect1> SEE ALSO<p>
 
90
macos(8)
 
91
 
 
92
<sect1> AUTHORS<p>
 
93
<verb>Paul Mackerras <paulus@cs.anu.edu.au> (program)</verb>
 
94
<verb>Richard van Hees <R.M.vanHees@phys.uu.nl> (documentation)</verb>
 
95
 
 
96
</manpage>
 
 
b'\\ No newline at end of file'