Changing the Power-on Banner

The banner configuration variables are:

• oem-banner

• oem-banner?

• oem-logo

• oem-logo?

To view the power-on banner, type:

ok banner 
Sun Ultra 1 SBus (UltraSPARC 167 MHz),Keyboard Present
PROM Rev. 3.0, 64MB memory installed, Serial # 289
Ethernet address 8:0:20:d:e2:7b, Host ID: 80000121
ok

The banner for your system may be different.

The banner consists of two parts: the text field and the logo (over serial ports, only the text field is displayed). You can replace the existing text field with a custom text message using the oem-banner and oem-banner? configuration variables.

To insert a custom text field in the power-on banner, type:

ok setenv oem-banner Hello Mom and Dad
ok setenv oem-banner? true
ok banner
 Hello Mom and Dad
ok

The system displays the banner with your new message, as shown in the preceding screen.

The graphic logo is handled differently. oem-logo is a 512-byte array, containing a total of 4096 bits arranged in a 64 x 64 array. Each bit controls one pixel. The most significant bit (MSB) of the first byte controls the upper-left corner pixel. The next bit controls the pixel to the right of it, and so on.

To create a new logo, first create a Forth array containing the correct data; then copy this array into oem-logo. The array is then installed in oem-logo with $setenv. The example below fills the top half of oem-logo with an ascending pattern.

ok create logoarray d# 512 allot
ok logoarray d# 256 0 do i over i + c! loop drop
ok logoarray d# 256 " oem-logo" $setenv
ok setenv oem-logo? true
ok banner 

To restore the system's original power-on banner, set the oem-logo? and oem-banner? variables to false.

ok setenv oem-logo? false
ok setenv oem-banner? false
ok

Because the oem-logo array is so large, printenv displays approximately the first 8 bytes (in hexadecimal). To display the entire array, use the phrase oem-logo dump. The oem-logo array is not erased by set-defaults, since it might be difficult to restore the data. However, oem-logo? is set to false when set-defaults executes, so the custom logo is no longer displayed.

Some systems do not support the oem-logo feature.