summaryrefslogtreecommitdiff
path: root/static/netbsd/man4/akbd.4 4.html
blob: 7934bb7a8858473337e80975668ad9a164c18a02 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
<table class="head">
  <tr>
    <td class="head-ltitle">AKBD(4)</td>
    <td class="head-vol">Device Drivers Manual</td>
    <td class="head-rtitle">AKBD(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">akbd</code> &#x2014; <span class="Nd">Apple
    Desktop Bus keyboard driver for wscons</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">akbd* at obio?</code>
  <br/>
  <code class="Cd">wskbd* at akbd? console ?</code></p>
<p class="Pp">
  <br/>
  <code class="Cd">options ALTXBUTTONS</code>
  <br/>
  <code class="Cd">options CAPS_IS_CONTROL</code>
  <br/>
  <code class="Cd">options FORCE_FUNCTION_KEYS</code></p>
</section>
<section class="Sh">
<h1 class="Sh" id="DESCRIPTION"><a class="permalink" href="#DESCRIPTION">DESCRIPTION</a></h1>
<p class="Pp">This driver provides the <a class="Xr">wscons(4)</a> driver with
    support for Apple Desktop Bus keyboards.</p>
<dl class="Bl-tag">
  <dt><code class="Cd">options ALTXBUTTONS</code></dt>
  <dd>To map &#x27E8;Option&#x27E9;+&#x27E8;1&#x27E9;,
      &#x27E8;Option&#x27E9;+&#x27E8;2&#x27E9;,
      &#x27E8;Option&#x27E9;+&#x27E8;3&#x27E9;, to mouse buttons 1, 2, and 3
      respectively.</dd>
  <dt><code class="Cd">options CAPS_IS_CONTROL</code></dt>
  <dd>On macppc systems it is possible to tweak the keyboard driver to treat the
      caps lock key on an ADB keyboard as a control key. This requires special
      remapping because of ADB's strange emulation of a mechanically-locked
    key.</dd>
  <dt id="not"><code class="Cd">options FORCE_FUNCTION_KEYS</code></dt>
  <dd>On macppc PowerBooks, several function keys double as &#x201C;hot
      keys&#x201D; (brightness, volume, eject) when the &#x27E8;Fn&#x27E9;
      modifier is held down. Mac OS&#x00A0;X likes to reprogram the keyboard
      controller to send hot key events when &#x27E8;Fn&#x27E9; is
      <a class="permalink" href="#not"><i class="Em">not</i></a> held down and
      send function key events when it is. With this option you can transform
      the non-keyboard &#x201C;button&#x201D; events back into function key
      events.</dd>
</dl>
<section class="Ss">
<h2 class="Ss" id="Special_Keys"><a class="permalink" href="#Special_Keys">Special
  Keys</a></h2>
<p class="Pp">To work around the limited number of buttons found on most ADB
    mice, the following key sequences trigger mouse button events:</p>
<p class="Pp"></p>
<ul class="Bl-dash Bl-compact">
  <li>&#x27E8;Option&#x27E9;+&#x27E8;LeftArrow&#x27E9; will work as the middle
      mouse button.</li>
  <li>&#x27E8;Option&#x27E9;+&#x27E8;RightArrow&#x27E9; will work as the right
      mouse button.</li>
</ul>
<p class="Pp">On PowerBook (mac68k) models the following key sequences are also
    significant:</p>
<p class="Pp"></p>
<ul class="Bl-dash Bl-compact">
  <li>&#x27E8;Option&#x27E9;+&#x27E8;UpArrow&#x27E9; increase screen
    brightness.</li>
  <li>&#x27E8;Option&#x27E9;+&#x27E8;DownArrow&#x27E9; decrease screen
      brightness.</li>
</ul>
</section>
<section class="Ss">
<h2 class="Ss" id="Supported_Hardware"><a class="permalink" href="#Supported_Hardware">Supported
  Hardware</a></h2>
<p class="Pp"><span class="Ux">NetBSD</span> is known to support the following
    ADB keyboards:</p>
<p class="Pp"></p>
<ul class="Bl-bullet Bd-indent Bl-compact">
  <li>On-board keyboards on PowerBook models</li>
  <li>Apple Standard Keyboard</li>
  <li>Apple Keyboard II</li>
  <li>Apple Extended Keyboard</li>
  <li>Apple Extended Keyboard II</li>
  <li>Apple Adjustable Keyboard</li>
  <li>Most third-party ADB keyboards are supported</li>
</ul>
</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">xmodmap(1)</a>, <a class="Xr">adb(4)</a>,
    <a class="Xr">wscons(4)</a>, <a class="Xr">wskbd(4)</a>,
    <a class="Xr">wsconsctl(8)</a></p>
</section>
<section class="Sh">
<h1 class="Sh" id="BUGS"><a class="permalink" href="#BUGS">BUGS</a></h1>
<p class="Pp">The number pad on extended keyboards does not send out the proper
    key codes for many applications.</p>
<p class="Pp">The LEDs on extended keyboards are not functional under
    <span class="Ux">NetBSD</span>.</p>
<p class="Pp">In X11 with the default key mapping, middle and right mouse button
    events will hold &#x2018;<code class="Li">Meta_L</code>&#x2019; and this
    will clobber the intended mouse button. &#x27E8;Option&#x27E9; should be
    remapped with <a class="Xr">xmodmap(1)</a> to the &#x27E8;Command&#x27E9;
    key:</p>
<div class="Bd Pp Bd-indent Li">
<pre>remove Mod4 = Super_L
remove Mod1 = Alt_L
add Mod1 = Super_L</pre>
</div>
</section>
</div>
<table class="foot">
  <tr>
    <td class="foot-date">January 20, 2025</td>
    <td class="foot-os">NetBSD 10.1</td>
  </tr>
</table>