OpenBSD FAQ - Keyboard and Display Controls [FAQ Index]

Working on the console

Remapping the keyboard

The kbd(8) utility can be used to change the keyboard encoding. Most keyboard options can be controlled using the wsconsctl(8) utility. For example, to change keymappings with wsconsctl(8), one would execute the following:
# wsconsctl keyboard.encoding=uk
Remap [Caps Lock] to be [Control L], the left control key:
# wsconsctl"keysym Caps_Lock = Control_L"
To make changes permanent, use the wsconsctl.conf(5) file.

Console mouse support

For the alpha, amd64 and i386 platforms, OpenBSD provides wsmoused(8). It can be enabled with the rcctl(8) utility also described in the FAQ on the rc script.

Switching consoles

On most alpha, amd64 and i386 systems, OpenBSD provides six virtual terminals by default: /dev/ttyC0 through /dev/ttyC5. You can switch between them using [CTRL]+[ALT] together with [F1] through [F6]. The virtual terminal ttyC4 is reserved for use by the X Window system.

Consoles on VGA hardware

Note: This section discusses features of the vga(4) driver. They are not supported by all video cards. The instructions below will not work on modern graphics hardware that uses the drm(4) driver.

The scrollback buffer

On a few platforms and hardware combinations, OpenBSD provides a console scrollback buffer. This allows you to see information that has already scrolled past your screen. To move up and down in the buffer, use [SHIFT]+[PGUP] and [SHIFT]+[PGDN]. The number of pages that you can move up and view is 8. Switching consoles will clear the scrollback buffer. Due to space limitations, the install kernels do not have this feature.

Adding more virtual consoles

If you wish to have more than the default number of virtual consoles, use the wsconscfg(8) command to create screens for ttyC6, ttyC7 and above. For example:
# wsconscfg -t 80x25 6       # this will not work on systems using drm(4)
This will create a virtual terminal for ttyC6, accessed by [CTRL]+[ALT]+[F7]. To get a login: prompt on the newly created virtual console, you need to set it to on in ttys(5), and either reboot or send init(8) a HUP signal using kill(1). Add this command to rc.local(8) if you want the extra screen the next time you boot the computer.

Changing console font and resolution

Many VGA video cards on alpha, amd64 and i386 are capable of displaying a higher text resolution of 50 lines instead of the usual 25 lines. The standard 80x25 text screen uses 8x16 pixel fonts. To double the number of lines, we first load an 8x8 pixel font with wsfontload(8). Then we delete and recreate a virtual console with the desired screen resolution using wsconscfg(8). This can be done automatically at boot by adding the following commands to the end of the rc.local(8) script:
wsfontload -h 8 -e ibm /usr/share/misc/pcvtfonts/vt220l.808	# load 8x8 font
wsconscfg -dF 5			# delete screen 5 accessed by [CTRL]+[ALT]+[F6]
wsconscfg -t 80x50 5		# add screen 5 with 50 lines of 80 characters
If you wish to modify other screens, simply repeat the delete and add screen steps for whichever screens you want running at the 80x50 resolution. It is not possible to change the resolution of the primary console device ttyC0 accessed by [CTRL]+[ALT]+[F1]. Avoid changing screen 4 which is used by X as a graphical screen.

Blanking the console after a period of inactivity

If you wish to blank your console after a period of inactivity without using X, modify the following wscons(4) variables: For example:
# wsconsctl display.screen_off=60000
display.screen_off -> 60000
Set them permanently by editing wsconsctl.conf(5). The blanker is activated when either display.kbdact or display.outact is set to on. Note that one of those two must be off.

Configuring a serial console

OpenBSD supports serial console on most platforms, however details vary greatly between platforms. In addition to allowing users to log in, they're also useful for recording console output.

There are two parts to getting a fully functional serial console on an OpenBSD system:

Change /etc/ttys to get a login prompt

Terminal sessions are controlled by the ttys(5) file. Before OpenBSD will give you a login: prompt at a device, it has to be enabled in /etc/ttys. The serial terminal is disabled by default on platforms which typically have a keyboard and screen attached. We'll use the amd64 platform as an example. In this case, you must edit the line that reads:
tty00   "/usr/libexec/getty std.9600"   unknown off
to read something like:
tty00   "/usr/libexec/getty std.9600"   vt220   on secure
Here, tty00 is the serial port we are using as a console and vt220 is the termcap(5) entry that matches your terminal. Other likely options might include vt100, xterm, etc. The on bit enables the login prompt by activating getty(8) for that serial port. The secure bit permits a root login at this console. The 9600 bit is the terminal baud rate.

Note that you can use a serial console for install without doing this step, as the system is running in single user mode, and not using getty for login.

On some platforms and some configurations, you must bring the system up in single user mode to make this change if a serial console is all you have available.

amd64 and i386

To configure the boot process to use the serial port as a console, your boot.conf(5) file should include the line:
set tty com0
This file is put on your boot drive, which could also be your install media. Use the stty option if you need a baud rate other than 9600bps.


These machines are designed to be completely maintainable with a serial console. Simply remove the keyboard from the machine, and the system will run serial.


The MacPPC machines are configured for a serial console through OpenFirmware. Use the commands:
ok setenv output-device scca
ok setenv input-device scca
ok reset-all
Set your serial console to 57600bps, 8N1.

I get input/output error when trying to use my tty devices

You need to use /dev/cuaXX for connections initiated from the OpenBSD system. The /dev/ttyXX devices are intended only for terminal or dial-in usage. Refer to the section on terminal special files in the cua(4) manual for more details.