<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" "http://www.w3.org/TR/html4/strict.dtd"> <html> <head> <meta http-equiv="Content-Type" content="text/html; charset=utf-8"> <meta name="resource-type" content="document"> <link rel="stylesheet" href="../style.css" type="text/css" media="all"> <title> WSCONS.CONF(5)</title> </head> <body> <div class="mandoc"> <table summary="Document Header" class="head" width="100%"> <col width="30%"> <col width="30%"> <col width="30%"> <tbody> <tr> <td class="head-ltitle"> WSCONS.CONF(5)</td> <td class="head-vol" align="center"> File Formats Manual</td> <td class="head-rtitle" align="right"> WSCONS.CONF(5)</td> </tr> </tbody> </table> <div class="section"> <h1 id="x4e414d45">NAME</h1> <b class="name">wscons.conf</b> — <span class="desc">workstation console config file</span></div> <div class="section"> <h1 id="x53594e4f50534953">SYNOPSIS</h1><table class="synopsis"> <col style="width: 11.00ex;"> <col> <tbody> <tr> <td> wscons.conf</td> <td> </td> </tr> </tbody> </table> </div> <div class="section"> <h1 id="x4445534352495054494f4e">DESCRIPTION</h1> The <b class="name">wscons.conf</b> file defines parameters regarding to the workstation console (wscons). The file consists of lines starting with a keyword, and one or more arguments. Empty lines and lines starting with a hash (“#”) are ignored.<p> This configuration file is used by the <i class="file">/etc/rc.d/wscons</i> script which parses <i class="file">/etc/wscons.conf</i> and runs <a class="link-man" href="../html8/wsconscfg.html">wsconscfg(8)</a>, <a class="link-man" href="../html8/wsconsctl.html">wsconsctl(8)</a>, and/or <a class="link-man" href="../html8/wsfontload.html">wsfontload(8)</a> as configured. See <a class="link-man" href="../html5/rc.conf.html">rc.conf(5)</a> for details on enabling the rc.d script.<p> The following keywords and arguments are recognized:<dl style="margin-top: 0.00em;margin-bottom: 0.00em;" class="list list-tag"> <dt class="list-tag" style="margin-top: 1.00em;"> <span class="symb">font</span> <i class="arg">name</i> <i class="arg">width</i> <i class="arg">height</i> <i class="arg">enc</i> <i class="arg">file</i></dt> <dd class="list-tag" style="margin-left: 8.00ex;"> Used to load a font via <a class="link-man" href="../html8/wsfontload.html">wsfontload(8)</a>. <i class="arg">name</i> gives a font name that can be used later, <i class="arg">width</i> can be used to specify the width of a font character in pixel, <i class="arg">height</i> is the same, just for the font characters' height. <i class="arg">enc</i> is used to declare the font's encoding, see the description on <a class="link-man" href="../html8/wsfontload.html">wsfontload(8)</a>'s <b class="flag">-e</b> option for more detail. <i class="arg">file</i> gives the absolute path to the font file. See <a class="link-man" href="../html8/wsfontload.html">wsfontload(8)</a> for more information.</dd> <dt class="list-tag" style="margin-top: 1.00em;"> <span class="symb">screen</span> <i class="arg">idx</i> <i class="arg">scr</i> <i class="arg">emul</i></dt> <dd class="list-tag" style="margin-left: 8.00ex;"> Add and configure virtual console number <i class="arg">idx</i> using a screen type of <i class="arg">scr</i> (e.g. 80x25) and a <i class="arg">emul</i> terminal emulation (e.g. vt100). See <a class="link-man" href="../html8/wsconscfg.html">wsconscfg(8)</a> for further parameter description.</dd> <dt class="list-tag" style="margin-top: 1.00em;"> <span class="symb">keyboard</span> <i class="arg">kbd</i></dt> <dd class="list-tag" style="margin-left: 8.00ex;"> Attach and configure keyboard <i class="arg">kbd</i> using “<code class="lit">wsconscfg -k</code>”. If <i class="arg">kbd</i> is ‘<code class="lit">-</code>' or ‘<code class="lit">auto</code>', the first free keyboard will be used. See <a class="link-man" href="../html8/wsconscfg.html">wsconscfg(8)</a> for more information.</dd> <dt class="list-tag" style="margin-top: 1.00em;"> <span class="symb">encoding</span> <i class="arg">enc</i></dt> <dd class="list-tag" style="margin-left: 8.00ex;"> Set the keyboard map to the given language code <i class="arg">enc</i>, using “<code class="lit">wsconsctl -w encoding=enc</code>”. The map must be supported by the keyboard driver in use and must be compiled into the kernel. See the keyboard driver's manpage (e.g., <a class="link-man" href="../html4/pckbd.html">pckbd(4)</a>, <a class="link-man" href="../html4/ukbd.html">ukbd(4)</a>) for details.</dd> <dt class="list-tag" style="margin-top: 1.00em;"> <span class="symb">mapfile</span> <i class="arg">file</i></dt> <dd class="list-tag" style="margin-left: 8.00ex;"> Parses the contents of <i class="arg">file</i>, which contains a keyboard map per line, and calls “<code class="lit">wsconsctl -w map+=</code>” for each line. See <a class="link-man" href="../html8/wsconsctl.html">wsconsctl(8)</a> for details.</dd> <dt class="list-tag" style="margin-top: 1.00em;"> <span class="symb">mux</span> <i class="arg">idx</i></dt> <dd class="list-tag" style="margin-left: 8.00ex;"> Used to attach and configure keyboard/mouse multiplexors, using “<code class="lit">wsconscfg -m idx</code>”. See <a class="link-man" href="../html8/wsconscfg.html">wsconscfg(8)</a> for more information.</dd> <dt class="list-tag" style="margin-top: 1.00em;"> <span class="symb">setvar</span> <i class="arg">dev</i> <i class="arg">var</i> <i class="arg">val</i></dt> <dd class="list-tag" style="margin-left: 8.00ex;"> Set arbitrary wscons variable <i class="arg">var</i> to value <i class="arg">val</i> for specified control device <i class="arg">dev</i>. Can be used for direct modification of <a class="link-man" href="../html4/wscons.html">wscons(4)</a> variables, when no other keywords are suitable. See <a class="link-man" href="../html8/wsconsctl.html">wsconsctl(8)</a> for more information.</dd> </dl> <p> Command arguments can be specified as “-” which makes default values come into effect as described in the documentation of the utilities.</div> <div class="section"> <h1 id="x46494c4553">FILES</h1><dl style="margin-top: 0.00em;margin-bottom: 0.00em;" class="list list-tag"> <dt class="list-tag" style="margin-top: 0.00em;"> <i class="file">/etc/wscons.conf</i></dt> <dd class="list-tag" style="margin-left: 16.00ex;"> </dd> </dl> </div> <div class="section"> <h1 id="x53454520414c534f">SEE ALSO</h1> <a class="link-man" href="../html4/wscons.html">wscons(4)</a>, <a class="link-man" href="../html8/wsconscfg.html">wsconscfg(8)</a>, <a class="link-man" href="../html8/wsconsctl.html">wsconsctl(8)</a>, <a class="link-man" href="../html8/wsfontload.html">wsfontload(8)</a></div> <table summary="Document Footer" class="foot" width="100%"> <col width="50%"> <col width="50%"> <tbody> <tr> <td class="foot-date"> November 22, 2008</td> <td class="foot-os" align="right"> NetBSD 6.0</td> </tr> </tbody> </table> </div> </body> </html>