ofw_console(4)

ofw_console4

Open firmware console

Usage

cpu AIM options OFWCONS_POLL_HZ=N

options KDB options DDB options ALT_BREAK_TO_DEBUGGER

Overview

The ofw_console driver provides a simple text console, using the Open Firmware services for input and output. It will use the Open Firmware console devices set via the input-device and output-device variables.

This driver is deprecated and only provided as a fallback console mechanism if the real console hardware can not be driven by FreeBSD.

In case the ofw_console console appears to work too slowly, its responsiveness probably can be improved by including options OFWCONS_POLL_HZ=N. When omitted, OFWCONS_POLL_HZ defaults to 4. For example, on Sun Ultra 2 a value of 20 or higher works best. Too high values, on the other hand, can cause ofw_console to unnecessarily consume CPU.

Files

/dev/console
/dev/keyboard

terminal input device in case the console input device is the keyboard

/dev/screen

terminal output device in case the console output device is the screen

/dev/tty[a-z]

terminal device in case both the console input and output device is tty[a-z]

Caveats

Since the Open Firmware will handle BREAK (or Stop-A) sequences before ofw_console, the preferred way to enter ddb(4) when using ofw_console is to include options ALT_BREAK_TO_DEBUGGER in a ddb-enabled kernel, and enter the alternate BREAK sequence (RETURN TILDE CTRL-b).

Releases

Unchanged in 9 releases since FreeBSD 14.0-RELEASE.

  1. 14.0–16.0

History

The ofw_console driver first appeared in FreeBSD 5.0.

Authors

The ofw_console driver was written by Benno Rice ⟨[email protected]⟩.

Bugs

The ofw_console driver also not attach to the hardware resources it actually talks to.

From base 16.0-CURRENT-20261027-61c70dc16a79 in FreeBSD 16.0-CURRENT (2026-10-27). Parsed by carta from the page's mdoc source.