summaryrefslogtreecommitdiff
path: root/static/netbsd/man4/wscons.4 4.html
diff options
context:
space:
mode:
Diffstat (limited to 'static/netbsd/man4/wscons.4 4.html')
-rw-r--r--static/netbsd/man4/wscons.4 4.html260
1 files changed, 0 insertions, 260 deletions
diff --git a/static/netbsd/man4/wscons.4 4.html b/static/netbsd/man4/wscons.4 4.html
deleted file mode 100644
index c58e94bd..00000000
--- a/static/netbsd/man4/wscons.4 4.html
+++ /dev/null
@@ -1,260 +0,0 @@
-<table class="head">
- <tr>
- <td class="head-ltitle">WSCONS(4)</td>
- <td class="head-vol">Device Drivers Manual</td>
- <td class="head-rtitle">WSCONS(4)</td>
- </tr>
-</table>
-<div class="manual-text">
-<section class="Sh">
-<h1 class="Sh" id="NAME"><a class="permalink" href="#NAME">NAME</a></h1>
-<p class="Pp"><code class="Nm">wscons</code> &#x2014;
- <span class="Nd">workstation console access</span></p>
-</section>
-<section class="Sh">
-<h1 class="Sh" id="SYNOPSIS"><a class="permalink" href="#SYNOPSIS">SYNOPSIS</a></h1>
-<p class="Pp"><code class="Cd">wsdisplay* at ...</code>
- <br/>
- <code class="Cd">wskbd* at ... mux N</code>
- <br/>
- <code class="Cd">wsmouse* at ... mux N</code></p>
-<p class="Pp">
- <br/>
- <code class="Cd">pseudo-device wsmux</code></p>
-<p class="Pp">
- <br/>
- <code class="Cd">options WSEMUL_SUN</code>
- <br/>
- <code class="Cd">options WSEMUL_VT100</code>
- <br/>
- <code class="Cd">options WSEMUL_NO_DUMB</code>
- <br/>
- <code class="Cd">options WSEMUL_DEFAULT=&quot;xxx&quot;</code></p>
-<p class="Pp">
- <br/>
- <code class="Cd">options WS_DEFAULT_FG=WSCOL_XXX</code>
- <br/>
- <code class="Cd">options WS_DEFAULT_BG=WSCOL_XXX</code>
- <br/>
- <code class="Cd">options
- WS_DEFAULT_COLATTR=&quot;(WSATTR_XXX&#x00A0;|&#x00A0;WSATTR_YYY)&quot;</code>
- <br/>
- <code class="Cd">options
- WS_DEFAULT_MONOATTR=&quot;(WSATTR_XXX&#x00A0;|&#x00A0;WSATTR_YYY)&quot;</code>
- <br/>
- <code class="Cd">options WS_KERNEL_FG=WSCOL_XXX</code>
- <br/>
- <code class="Cd">options WS_KERNEL_BG=WSCOL_XXX</code>
- <br/>
- <code class="Cd">options
- WS_KERNEL_COLATTR=&quot;(WSATTR_XXX&#x00A0;|&#x00A0;WSATTR_YYY)&quot;</code>
- <br/>
- <code class="Cd">options
- WS_KERNEL_MONOATTR=&quot;(WSATTR_XXX&#x00A0;|&#x00A0;WSATTR_YYY)&quot;</code></p>
-<p class="Pp">
- <br/>
- <code class="Cd">options WSDISPLAY_COMPAT_PCVT</code>
- <br/>
- <code class="Cd">options WSDISPLAY_COMPAT_SYSCONS</code>
- <br/>
- <code class="Cd">options WSDISPLAY_COMPAT_USL</code>
- <br/>
- <code class="Cd">options WSCOMPAT_USL_SYNCTIMEOUT=nnn</code>
- <br/>
- <code class="Cd">options WSDISPLAY_COMPAT_RAWKBD</code></p>
-<p class="Pp">
- <br/>
- <code class="Cd">options WSKBD_EVENT_AUTOREPEAT</code>
- <br/>
- <code class="Cd">options WSKBD_USONLY</code></p>
-</section>
-<section class="Sh">
-<h1 class="Sh" id="DESCRIPTION"><a class="permalink" href="#DESCRIPTION">DESCRIPTION</a></h1>
-<p class="Pp">The <code class="Nm">wscons</code> driver provides support for
- machine independent access to the console.</p>
-<p class="Pp"><code class="Nm">wscons</code> is made of a number of cooperating
- modules, in particular</p>
-<ul class="Bl-bullet">
- <li>hardware support for display adapters, keyboards and mice, see
- <a class="Xr">wsdisplay(4)</a>, <a class="Xr">wskbd(4)</a>, and
- <a class="Xr">wsmouse(4)</a></li>
- <li>input event multiplexor, see <a class="Xr">wsmux(4)</a></li>
- <li>terminal emulation modules (see below), and</li>
- <li>compatibility options to support control operations and other low-level
- behaviour of existing terminal drivers (see below)</li>
-</ul>
-<section class="Ss">
-<h2 class="Ss" id="Terminal_emulations"><a class="permalink" href="#Terminal_emulations">Terminal
- emulations</a></h2>
-<p class="Pp"><code class="Nm">wscons</code> does not define its own set of
- terminal control sequences and special keyboard codes in terms of
- <a class="Xr">terminfo(5)</a>. Instead a &#x201C;terminal emulation&#x201D;
- is assigned to each virtual screen when the screen is created. (See
- <a class="Xr">wsconscfg(8)</a>.) Different terminal emulations can be active
- at the same time on one display. The following choices are available:</p>
-<dl class="Bl-tag">
- <dt>dumb</dt>
- <dd>This minimal terminal support is available unless the kernel option
- <code class="Cd">options WSEMUL_NO_DUMB</code> was specified at build
- time. No control sequences are supported besides the ASCII control
- characters. The cursor is not addressable. Only ASCII keyboard codes will
- be delivered, cursor and functions keys do not work.</dd>
- <dt>sun</dt>
- <dd>The &#x201C;sun&#x201D; console emulation is available if
- <code class="Cd">options WSEMUL_SUN</code> was specified at kernel build
- time. It supports the control sequences of SUN machine consoles and
- delivers its keyboard codes for function and keypad keys in use. This
- emulation is sufficient for full-screen applications.</dd>
- <dt>vt100</dt>
- <dd>is available with the kernel compile option <code class="Cd">options
- WSEMUL_VT100</code>. It provides the most commonly used functions of DEC
- VT100 terminals with some extensions introduced by the DEC VT220 and DEC
- VT320 models. The features of the original VT100 which are not or not
- completely implemented are:
- <ul class="Bl-bullet">
- <li>VT52 support, 132-column-mode, smooth scroll, light background,
- keyboard autorepeat control, external printer support, keyboard
- locking, newline/linefeed switching: Escape sequences related to these
- features are ignored or answered with standard replies. (DECANM,
- DECCOLM, DECSCLM, DECSCNM, DECARM, DECPFF, DECPEX, KAM, LNM)</li>
- <li>Function keys are not reprogrammable and fonts can not be downloaded.
- DECUDK and DECDLD sequences will be ignored.</li>
- <li>Neither C1 control set characters will be recognized nor will 8-bit
- keyboard codes be delivered.</li>
- <li>The &#x201C;DEC supplemental graphic&#x201D; font is approximated by
- the ISO-latin-1 font, though there are subtle differences.</li>
- <li>The actual rendering quality depends on the underlying graphics
- hardware driver. Characters might be missing in the available fonts
- and be substituted by more or less fitting replacements.
- <p class="Pp">Depending on the keyboard used, not all function keys
- might be available.</p>
- </li>
- </ul>
- <p class="Pp">In addition to the plain VT100 functions are supported:</p>
- <ul class="Bl-bullet">
- <li>ANSI colors.</li>
- <li>Some VT220-like presentation state settings and -reports (DECRSPS),
- especially tabulator settings.</li>
- </ul>
- <p class="Pp">In most applications, <code class="Nm">wscons</code> will work
- sufficiently as a VT220 emulator.</p>
- </dd>
-</dl>
-<p class="Pp">The <code class="Dv">WSEMUL_DEFAULT</code> kernel option is used
- to select one of the described terminal options as the default choice. The
- default takes effect at kernel startup, i.e. for the operating system
- console or additional screens allocated through the
- <code class="Dv">WSDISPLAY_DEFAULTSCREENS</code> option (see
- <a class="Xr">wsdisplay(4)</a>), or if no emulation type was passed to the
- <a class="Xr">wsconscfg(8)</a> utility.</p>
-</section>
-<section class="Ss">
-<h2 class="Ss" id="Compatibility_options"><a class="permalink" href="#Compatibility_options">Compatibility
- options</a></h2>
-<p class="Pp">These options allow X servers and other programs using low-level
- console driver functions usually written specifically for other console
- drivers to run on <span class="Ux">NetBSD</span> systems. The options are in
- particular:</p>
-<dl class="Bl-tag">
- <dt><code class="Cd">WSDISPLAY_COMPAT_USL</code></dt>
- <dd>Support the protocol for switches between multiple virtual screens on one
- display as used by most PC-UNIX variants. This is used by the
- <span class="Ux">NetBSD</span> <a class="Xr">wsconscfg(8)</a>
- utility.</dd>
- <dt><code class="Cd">WSDISPLAY_COMPAT_RAWKBD</code></dt>
- <dd>Allows to get raw XT keyboard scancodes from PC keyboards as needed by
- i386 X servers.</dd>
- <dt><code class="Cd">WSDISPLAY_COMPAT_PCVT</code></dt>
- <dd>Emulates enough of the <span class="Ux">NetBSD</span>/i386
- &#x201C;pcvt&#x201D; driver to make X servers work.</dd>
- <dt><code class="Cd">WSDISPLAY_COMPAT_SYSCONS</code></dt>
- <dd>Emulates enough of the <span class="Ux">FreeBSD</span>
- &#x201C;syscons&#x201D; driver to make X servers work. Useful with
- <span class="Ux">FreeBSD</span> binary emulation.</dd>
-</dl>
-<p class="Pp">Linux/i386 X servers usually run successfully if the first two
- options are enabled together with the <span class="Ux">NetBSD</span> Linux
- binary emulation.</p>
-<p class="Pp">(To have programs looking for device special files of other
- console drivers find the <code class="Nm">wscons</code> driver entry points,
- symlinks are a helpful measure.)</p>
-</section>
-<section class="Ss">
-<h2 class="Ss" id="Other_options"><a class="permalink" href="#Other_options">Other
- options</a></h2>
-<dl class="Bl-tag Bl-compact">
- <dt><code class="Cd">options WS_DEFAULT_FG=WSCOL_XXX</code></dt>
- <dd style="width: auto;">&#x00A0;</dd>
- <dt><code class="Cd">options WS_DEFAULT_BG=WSCOL_XXX</code></dt>
- <dd style="width: auto;">&#x00A0;</dd>
- <dt><code class="Cd">options
- WS_DEFAULT_COLATTR=&quot;(WSATTR_XXX&#x00A0;|&#x00A0;WSATTR_YYY)&quot;</code></dt>
- <dd style="width: auto;">&#x00A0;</dd>
- <dt><code class="Cd">options
- WS_DEFAULT_MONOATTR=&quot;(WSATTR_XXX&#x00A0;|&#x00A0;WSATTR_YYY)&quot;</code></dt>
- <dd>Make default console output appear in specific colors and attributes.
- <code class="Dv">WS_DEFAULT_FG</code> and
- <code class="Dv">WS_DEFAULT_BG</code> set the foreground and background
- used on color displays. <code class="Dv">WS_DEFAULT_COLATTR</code> and
- <code class="Dv">WS_DEFAULT_MONOATTR</code> are additional attribute flags
- used on color or monochrome displays, respectively. Whether the attributes
- are supported or not depends on the actually used graphics adapter. These
- options are ignored by the &#x201C;dumb&#x201D; terminal emulation.
- <p class="Pp">See <span class="Pa">src/sys/dev/wscons/wsdisplayvar.h</span>
- for available <code class="Dv">WSCOL_XXX</code> and
- <code class="Dv">WSATTR_XXX</code> values.</p>
- <p class="Pp"></p>
- </dd>
- <dt><code class="Cd">options WS_KERNEL_FG=WSCOL_XXX</code></dt>
- <dd style="width: auto;">&#x00A0;</dd>
- <dt><code class="Cd">options WS_KERNEL_BG=WSCOL_XXX</code></dt>
- <dd style="width: auto;">&#x00A0;</dd>
- <dt><code class="Cd">options
- WS_KERNEL_COLATTR=&quot;(WSATTR_XXX&#x00A0;|&#x00A0;WSATTR_YYY)&quot;</code></dt>
- <dd style="width: auto;">&#x00A0;</dd>
- <dt><code class="Cd">options
- WS_KERNEL_MONOATTR=&quot;(WSATTR_XXX&#x00A0;|&#x00A0;WSATTR_YYY)&quot;</code></dt>
- <dd>Make console output originating from the kernel appear differently than
- output from user level programs (via <span class="Pa">/dev/console</span>
- or the specific tty device like <span class="Pa">/dev/ttyE0</span>). Their
- meaning is the same as their <code class="Dv">WS_DEFAULT_*</code>
- counterparts.
- <p class="Pp"></p>
- </dd>
- <dt><code class="Cd">options WSCOMPAT_USL_SYNCTIMEOUT=nnn</code></dt>
- <dd>The virtual screen switching protocol enabled by
- <code class="Dv">WSDISPLAY_COMPAT_USL</code> uses a somewhat complex
- handshake protocol to pass control to user programs such as X servers
- controlling a virtual screen. In order to prevent a non-responsive
- application from locking the whole console system, a screen switch will be
- rolled back after a 5 second timeout if the application does not respond.
- This option can be used to specify in seconds a different timeout value.
- <p class="Pp"></p>
- </dd>
- <dt><code class="Cd">options WSKBD_EVENT_AUTOREPEAT</code></dt>
- <dd>If set, this option enables auto repeat even in event mode. The auto
- repeat will generate key down events while the key is pressed.
- <p class="Pp"></p>
- </dd>
- <dt><code class="Cd">options WSKBD_USONLY</code></dt>
- <dd>In order to strip down the space usage of wscons, all keymaps except the
- US english one can be removed from the kernel with this option, which
- results in a space gain of about 10kB.</dd>
-</dl>
-</section>
-</section>
-<section class="Sh">
-<h1 class="Sh" id="SEE_ALSO"><a class="permalink" href="#SEE_ALSO">SEE
- ALSO</a></h1>
-<p class="Pp"><a class="Xr">wsdisplay(4)</a>, <a class="Xr">wskbd(4)</a>,
- <a class="Xr">wsmouse(4)</a>, <a class="Xr">wsmux(4)</a>,
- <a class="Xr">wsconscfg(8)</a>, <a class="Xr">wsconsctl(8)</a>,
- <a class="Xr">wsfontload(8)</a>, <a class="Xr">wscons(9)</a></p>
-</section>
-</div>
-<table class="foot">
- <tr>
- <td class="foot-date">June 5, 2012</td>
- <td class="foot-os">NetBSD 10.1</td>
- </tr>
-</table>