x86: Adding –B prop=val Kernel Arguments at Boot Time by Editing the GRUB Menu

You can specify certain kernel arguments at boot time, for example, setting the Oracle Solaris system console, by specifying –B prop=val options. The following are the various ways in which you can modify boot parameters on x86 platforms at boot time by adding –B prop=val options to a specified boot entry:

–B acpi-enum=off

Disables the Advanced Configuration and Power Interface (ACPI) enumeration of devices.

–B acpi-user-options=0x2

Disables ACPI entirely.

–B console=force-text

Specifies to use VGA text mode for booting. See Redirecting the Oracle Solaris Console at Boot Time.

–B console=graphics

Specifies that the console use graphics mode for booting, which enables a high-resolution state.

–B console=text

Specifies that the console use text mode for booting, which enables a high-resolution state.

–B screen-#columns=value, screen-#rows=value

Specifies the number of rows and columns of the frame buffer console. The most appropriate font for the selected number of rows or columns is automatically detected by the system. This option is used to optimize the frame buffer console size.

–B console=ttya

Redirects the console to ttya.

–B console=ttya,acpi-enum=off

Redirects the console to ttya and disables the ACPI enumeration of devices.

–B uefirt_disable=1

Disables the use of UEFI runtime services in Oracle Solaris.

For more information, see the boot(1M) man page.

Example 2-10  Configuring Text Mode Boot Parameters for the Oracle Solaris System Console

In text mode, the console output is sent to the frame buffer, and input is received from the keyboard. A variant of text mode, the graphics mode displays an image with an animation until either a key is pressed or console interaction is required by the console login, sulogin, or kmdb command. A new property of text, console=force-text, directs the system to not use a VGA adapter as a bitmap device and sets the adapter to VGA text mode.

Note that setting the console=force-text property for the console will not transition the VGA adapter to text mode on systems with UEFI firmware.

When this property is not present, the console device reverts to the device that is specified by the input-device and output-device property pair. When neither the console property, nor the input-device and output-device property pair are present, the console defaults to the frame buffer and keyboard.

The following example shows how to specify the –B console=force-text property on the kernel command line at boot time:

-B console=force-text

Example 2-11  Enabling a Graphical Display and Configuring Console Text Mode Parameters

By default, the console text mode is 80 columns by 24 rows. To reconfigure this parameter, use the –B option with the screen-#columns=value and screen-#rows=value parameters.

For example, the following parameters can be specified on the kernel command line to enable a graphical display and allocate a console terminal of 100 columns by 60 rows:

-B console=graphics,screen-#columns=100,screen-#rows=60

Redirecting the Oracle Solaris Console at Boot Time

Oracle Solaris 11 supports higher resolution and color depth on x86 based systems than the older Video Graphics Array (VGA) 640-480 16-color console. This support is provided for systems that use UEFI firmware and traditional BIOS firmware with Video Electronics Standards Association (VESA) option read-only memory (ROM). Note that support is limited to when a graphics card or frame buffer is used as a physical or virtual console. There is no impact on the behavior of serial consoles.

To support this feature, two command-line –B option=val parameters are available:

–B console=force-text

Specifies to use VGA text mode for booting.

–B screen-#columns=value, screen-#rows=value

Specifies the number of rows and columns of the frame buffer console. The most appropriate font for the selected number of rows or columns is automatically detected by the system. This option is used to optimize the frame buffer console size.

Oracle Solaris boot entries will attempt a specific set of graphics modes in a particular order. These modes are listed in the set gfxpayload line that follows the $multiboot line in the grub.cfg file. You can alter this line if you desire a mode that is not listed. To make this change persistent, you must copy the entry to the custom.cfg file. Otherwise, the next time the grub.cfg file is autogenerated, the gfxpayload setting is overwritten.

The syntax for the set gfxpayload argument is as follows:

WidthxHeight[xbit-depth]

The “x” is the actual character, for example:

set gfxpayload=1024x768;1280x1024x32

This setting means that GRUB will first attempt to locate the 1024x768 mode, in any bit depth (higher bit depths are preferred), then it will attempt to locate 1280x1024, in a 32-bit depth. The special keyword, text, chooses the text mode. It should be noted that this keyword might not work on UEFI firmware. The keep keyword specifies that the mode that GRUB is using, if a graphical console type is in use, should be maintained and used by Oracle Solaris as its frame buffer console resolution.