Displaying and Changing Variable Settings

NVRAM configuration variables can be viewed and changed using the commands listed in Table 3-3.

Table 3-3 Viewing or Changing Configuration Variables

Command	Description
printenv	Display current variables and current default values.   printenv variable shows the current value of the named variable.
setenv variable value	Set variable to the given decimal or text value. (Changes are permanent, but often take effect only after a reset.)
set-default variable	Reset the value of variable to the factory default.
set-defaults	Reset variable values to the factory defaults.
password	Set security-password

The following pages show how these commands can be used.

---

Note -

Solaris provides the eeprom utility for modifying OpenBoot configuration variables.

---

To display a list of the current variable settings on your system, type:

---

ok printenv 

Variable Name	Value	Default Value
oem-logo	2c 31 2c 2d 00 00 00 00 ...
oem-logo?	false	false
oem-banner
oem-banner?	false	false
output-device	ttya	screen
input-device	ttya	keyboard
sbus-probe-list	03	0123
diag-file
diag-device	net	net
boot-file
boot-device	disk	disk net
auto-boot?	false	true
fcode-debug?	true	false
use-nvramrc?	false	false
nvramrc
screen-#columns	80	80
screen-#rows	34	34
security-mode	none	none
security-password
security-#badlogins	0
diag-switch?	true	false
ok

---

In the displayed, formatted list of the current settings, numeric variables are often shown in decimal.

To change a variable setting, type:

---

ok setenv
 variable-name value 

---

variable-name is the name of the variable. value is a numeric value or text string appropriate to the named variable. A numeric value is interpreted as a decimal number, unless preceded by 0x, which is the qualifier for a hexadecimal number.

For example, to set the auto-boot? variable to false, type:

---

ok setenv auto-boot? false
ok 

---

---

Note -

Many variable changes do not affect the operation of the firmware until the next power cycle or system reset at which time the firmware uses the variable's new value.

---

You can reset one or most of the variables to the original defaults using the set-default variable and set-defaults commands.

For example, to reset the auto-boot? variable to its default setting (true), type:

---

ok set-default auto-boot?
ok

---

To reset most variables to their default settings, type:

---

ok set-defaults
ok

---

On SPARC systems, it is possible to reset the NVRAM variables to their default settings by holding down Stop-N while the machine is powering up. When issuing this command, hold down Stop-N immediately after turning on the power to the SPARC system, and keep it pressed for a few seconds or until you see the banner (if the display is available). This is a good technique to force a SPARC compatible machine's NVRAM variables to a known condition.