NVSETENV(8)NVSETENV(8)NAMEnvsetenv - change/view OF's environment boot-variables
SYNOPSISnvsetenv [variable [value]]
DESCRIPTIONnvsetenv is a program to adjust or view the Open Firmware (OF) boot
parameters stored in non-volatile (battery-powered) RAM on your Macin‐
tosh computer. nvsetenv will show the current values of all OF's envi‐
ronment variables when no parameters are given.
OPTIONS
variable
nvsetenv will show current value of an OF's variable, if no
value is given
variable value
nvsetenv will set variable to value
EXAMPLES
This example will set the boot device to the first SCSI disk on the
internal SCSI bus, using /vmlinux as boot image, trying to use the
third partition as root partition.
> nvsetenv boot-device "scsi-int/sd@0:0"
> nvsetenv boot-file " /vmlinux root=/dev/sda3"
Alternatives boot devices are:
scsi/sd@1:0 SCSI disk at ID 1
ata/ata-disk@0:0 Internal IDE disk
You can also boot from a floppy, you need a XCOFF-format kernel image
(in this example: vmlinux.coff), copied to a HFS format high-density
(1.44Mb) floppy.
> nvsetenv boot-device "fd:vmlinux.coff"
> nvsetenv boot-file " root=/dev/sda3"
To return to MacOS, do:
> nvsetenv boot-device "/AAPL,ROM"
Valid values for "input-devices" are:
ttya Modem serial port
ttyb Printer serial port
kbd Keyboard
enet Ethernet interface
Valid values for "output-devices" are (machine and/or OF dependent):
screen Screen display (newer machines)
/chaos/control Screen display (7500, 7600 and 8500)
/bandit/ATY,264GT-B Screen display (6500)
OF is not designed to wait for your hard disk to spin up (remember Mac‐
OS boots from ROM). Use the following setting to have OF retry to boot
from your disk until is has spun up:
> nvsetenv boot-command "begin ['] boot catch 1000 ms cr again"
You only have to append an "S" to the "boot-file" variable to boot
Linux in single user mode.
FILESnvsetenv needs the following device:
/dev/nvram
character device with major number 1yy and minor number 10
/proc/cpuinfo
to identify New/Old-World machines
BUGS
On NewWorld machines setting an undefined variable is not implemented.
NewWorld machines contain binary values those are not specially
treated.
Also it is not a bug take care when setting special characters (\\)
with a shell.
FILESmacos(8)AUTHORS
Paul Mackerras <paulus@cs.anu.edu.au> (program)
Richard van Hees <R.M.vanHees@fys.ruu.nl> (documentation)
Klaus Halfmann <halfmann@libra.de> (NewWorld code, additional documen‐
tation)
NVSETENV(8)