wsdisplay - generic display device support in wscons
wsdisplay* at vga? console ?
(VGA textmode display on ISA or PCI)
wsdisplay* at pcdisplay? console ?
(generic PC (ISA) display)
wsdisplay* at vgafb? console ?
(VGA graphics display on PCI, as found on macppc and sparc64
wsdisplay* at tga? console ?
(DEC TGA display, alpha only)
wsdisplay* at sti? console ?
(HP CRX and Visualize series framebuffers)
wsdisplay* at agten? console ?
wsdisplay* at bwtwo? console ?
wsdisplay* at cgtwo? console ?
wsdisplay* at cgthree? console ?
wsdisplay* at cgfour? console ?
wsdisplay* at cgsix? console ?
wsdisplay* at cgeight? console ?
wsdisplay* at cgtwelve? console ?
wsdisplay* at cgfourteen? console ?
wsdisplay* at mgx? console ?
wsdisplay* at pninek? console ?
wsdisplay* at pnozz? console ?
wsdisplay* at rfx? console ?
wsdisplay* at tcx? console ?
wsdisplay* at tvtwo? console ?
wsdisplay* at vigra? console ?
wsdisplay* at zx? console ?
(sparc and/or sparc64 framebuffers)
wsdisplay* at creator? console ?
wsdisplay0 at smg? console ?
(VAXstation small monochrome display)
The wsdisplay driver is an abstraction layer for display devices within
the wscons(4) framework. It attaches to the hardware specific display
device driver and makes it available as text terminal or
A display device can have the ability to display characters
on it (without
help of an X server), either directly by hardware or
drawing pixel data into the display memory. Such displays
``emulating'', the wsdisplay driver will connect a terminal
module and provide a tty-like software interface. In contrary, non-emulating
displays can only be used by special programs like X
The console locator in the configuration line refers to the
as output part of the operating system console. A device
containing a positive value here will only match if the device is in use
as system console. (The console device selection in early
is not influenced.) This way, the console device can be
connected to a
known wsdisplay device instance. (Naturally, only ``emulating'' display
devices are usable as console.)
The logical unit of an independent contents displayed on a
referred to as ``virtual terminal'') is called a
If the underlying device driver supports it, multiple
screens can be used
on one display. (As of this writing, only the vga(4) and
the VAX ``smg''
display drivers provide this ability.) Screens have different minor device
numbers and separate tty instances. One screen possesses the
``focus'', this means it is displayed on the display and its
will get the keyboard input. (In some cases, if no screen
is set up or
if a screen was just deleted, it is possible that no focus
is present at
all.) The focus can be switched by either special keyboard
CTL-ALT-Fn) or an ioctl command issued by a user program. Screens
are set up or deleted through the /dev/ttyCcfg control device (preferably
using the wsconscfg(8) utility). Alternatively, the compile-time option
WSDISPLAY_DEFAULTSCREENS=N will set up N screens of the display driver's
default type and using the system's default terminal emulator at autoconfiguration
In addition and with help from backend drivers the following
+o Loading, deleting and listing the loaded fonts.
+o Browsing backwards in the screen output, the size of the
saved text is defined by the particular hardware driver.
+o Blanking the screen by timing out on inactivity in the
the input focus. Awakening activities consist of:
+o pressing any keys on the keyboard;
+o moving or clicking the mouse;
+o any output to the screen.
Blanking the screen is usually done by disabling the
signal on video output, but may also include blanking
sync in which case most monitors go into power saving
wsconsctl(8) for controlling variables.
Consult the back-end drivers' documentation for which features are supported
for each particular hardware type.
/dev/tty[C-F]* terminal devices (per
/dev/tty[C-F]cfg control device (per
agten(4), bwtwo(4), cgeight(4), cgfour(4), cgfourteen(4),
cgthree(4), cgtwelve(4), cgtwo(4), creator(4), intro(4),
pcdisplay(4), pninek(4), pnozz(4), rfx(4), sti(4), tcx(4),
tty(4), tvtwo(4), vga(4), vgafb(4), vigra(4), wscons(4),
wsconscfg(8), wsconsctl(8), wsfontload(8)
The wsdisplay code currently limits the number of screens on
The terms ``wscons'' and ``wsdisplay'' are not cleanly distinguished in
the code and in manual pages.
``non-emulating'' display devices are not tested.
OpenBSD 3.6 February 29, 2004
[ Back ]