<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 3.2 Final//EN">
<HTML>
<HEAD>
<META HTTP-EQUIV="Content-Type" CONTENT="text/html; charset=iso-8859-1">
<TITLE>OS Support for Mice </TITLE>
</HEAD>
<BODY BGCOLOR="#efefef" TEXT="black" LINK="blue" VLINK="#551A8B" ALINK="red">

<A HREF="mouse.html"><EM>Mouse Support in XFree86</EM></A>
 <b>:</b> <EM>OS Support for Mice </EM><BR>
<b>Previous:</b> <A HREF="mouse2.html"><EM>Supported Hardware </EM></A><BR>
<b>Next:</b> <A HREF="mouse4.html"><EM>Configuring Your Mouse </EM></A>


<HR NOSHADE>
  <H2><A NAME="3"></A>3. OS Support for Mice </H2>


<H3><A NAME="4"></A>3.1. Summary of Supported Mouse Protocol Types </H3>
<p>
<pre>
                                Protocol Types
                serial     PnP     BusMouse    PS/2   Extended PS/2
OS platforms   protocols  serial   protocol  protocol  protocols
                          "Auto"  "BusMouse"  "PS/2"   "xxxPS/2"
--------------------------------------------------------------------
BSD/OS            Ok        ?         ?         ?         ?
FreeBSD           Ok        Ok        Ok        Ok        SP*1
FreeBSD(98)       Ok        ?         Ok        NA        NA
Interactive Unix  Ok        NA        ?*1       ?*1       NA
Linux             Ok        Ok        Ok        Ok        Ok
Linux/98          Ok        ?         Ok        NA        NA
LynxOS            Ok        NA        Ok        Ok        NA
NetBSD            Ok        Ok        Ok        SP*1      SP*1
NetBSD/pc98       Ok        ?         Ok        NA        NA
OpenBSD           Ok        Ok        Ok        Ok*1      OK*1
OS/2              SP*2      SP*2      SP*2      SP*2      SP*2
SCO               Ok        ?         SP*1      SP*1      NA
Solaris 2.x       Ok        NA*1      ?*1       Ok        NA
SVR4              Ok        NA*1      SP*1      SP*1      NA
PANIX             Ok        ?         SP*1      SP*1      NA

Ok: support is available,  NA: not available, ?: untested or unknown.
SP: support is available in a different form

*1 Refer to the following sections for details.
*2 XFree86/OS2 will support any type of mouse that the OS supports, 
   whether it is serial, bus mouse, or PnP type. 
</pre>
</p>

<H3><A NAME="5"></A>3.2. BSD/OS </H3>
<p>No testing has been done with BSD/OS.</p>

<H3><A NAME="6"></A>3.3. FreeBSD </H3>
<p>FreeBSD supports the <code>"SysMouse"</code> protocol which must be 
specified when the <code>moused</code> daemon is running in versions 2.2.1 
or later.</p>
<p>FreeBSD versions 2.2.5 or earlier do not support extended PS/2 
mouse protocols (<code>"xxxPS/2"</code>).
Always specify the <code>"PS/2"</code> protocol for any PS/2 mouse 
in these versions regardless of the brand of the mouse.</p>
<p>FreeBSD versions 2.2.6 or later include the kernel-level
support for these mice.
Specify the <code>"PS/2"</code> or <code>"Auto"</code> protocol and 
the X server will automatically make use of the kernel-level support.
In fact, you may always specify <code>"Auto"</code> to any mouse in these
versions unless the mouse is an old serial model which doesn't support PnP.</p>

<H3><A NAME="7"></A>3.4. FreeBSD(98) </H3>
<p>The PS/2 mouse is not supported.</p>

<H3><A NAME="8"></A>3.5. Interactive Unix </H3>
<p>The PnP serial mouse support (the <code>"Auto"</code> protocol) is not
supported for the moment.</p>
<p>The bus mouse and PS/2 mouse should be supported by using the 
appropriate device drivers. 
Use <code>/dev/mouse</code> for the <code>"BusMouse"</code> protocol
and <code>/dev/kdmouse</code> for the <code>"PS/2"</code> protocol. 
These protocols are untested but may work. 
Please send success/failure reports to
<i>&lt;michael.rohleder@stadt-frankfurt.de&gt;</i>.</p>

<H3><A NAME="9"></A>3.6. Linux </H3>
<p>All protocol types should work.</p>

<H3><A NAME="10"></A>3.7. Linux/98 </H3>
<p>The PS/2 mouse is not supported.</p>

<H3><A NAME="11"></A>3.8. LynxOS </H3>
<p>The PnP serial mouse support (the <code>"Auto"</code> protocol) is disabled in
LynxOS, because of limited TTY device driver functionality.</p>

<H3><A NAME="12"></A>3.9. NetBSD </H3>
<p>NetBSD 1.3.x and former does not support extended PS/2 mouse protocols
(<code>"xxxPS/2"</code>). 
The PS/2 mouse device driver <code>/dev/pms</code> emulates the bus mouse.
Therefore, you should always specify the <code>"BusMouse"</code> protocol for 
any PS/2 mouse regardless of the brand of the mouse.</p>
<p>XFree86 3.3.4 supports the <code>"wsmouse"</code> protocol introduced in NetBSD
1.4 along with the wscons console driver. You need to run binaries
compiled on NetBSD 1.4 to have support 
for it though. Use <code>"/dev/wsmouse0"</code> for the device. Refer to the 
<em>wsmouse(4)</em> manual page for kernel configuration informations.</p>

<H3><A NAME="13"></A>3.10. NetBSD/pc98 </H3>
<p>The PS/2 mouse is not supported.</p>

<H3><A NAME="14"></A>3.11. OpenBSD </H3>
<p>The raw PS/2 mouse device driver <code>/dev/psm0</code> uses the raw PS/2
mouse protocol.</p>
<p>OpenBSD 2.2 and earlier does not support extended PS/2 mouse protocols
(<code>"xxxPS/2"</code>) .  Therefore, you should specify the
<code>"PS/2"</code> protocol for any PS/2 mouse regardless of the brand of
the mouse.</p>
<p>OpenBSD 2.3 and later support all extended PS/2 mouse protocols. 
You can select the <code>"Auto"</code> protocol for PnP PS/2
mice or any specific extended (<code>"xxxPS/2"</code>) protocol
for non PnP mice.</p>
<p>There is also a cooked PS/2 mouse device driver <code>/dev/pms0</code>
which emulates the bus mouse.  Specify the <code>"BusMouse"</code>
protocol for any PS/2 mouse regardless of the brand of the mouse when
using this device.</p>

<H3><A NAME="15"></A>3.12. OS/2 </H3>
<p>XFree86/OS2 always uses the native mouse driver of the operating system
and will support any type of pointer that the OS supports, whether it is
serial, bus mouse, or PnP type.
If the mouse works under Presentation Manager, 
it will also work under XFree86/OS2.</p>
<p>Always specify <code>"OSMouse"</code> as the protocol type.</p>

<H3><A NAME="16"></A>3.13. SCO </H3>
<p>The bus and PS/2 mouse are supported with the <code>"OSMouse"</code> 
protocol type.</p>
<p>The <code>"OSMouse"</code> may also be used with the serial mouse.</p>

<H3><A NAME="17"></A>3.14. Solaris </H3>
<p>Testing has been done with Solaris 2.5.1 and 2.6.  Logitech and
Microsoft bus mice
have not been tested, but might work with the <code>/dev/logi</code> and
<code>/dev/msm</code> devices.
Standard 2 and 3 button PS/2 mice work with the <code>"PS/2"</code> protocol
type and the <code>/dev/kdmouse</code> device.
The PnP serial mouse support (the <code>"Auto"</code> protocol) has been tested
and does not work.</p>

<H3><A NAME="18"></A>3.15. SVR4 </H3>
<p>The bus and PS/2 mouse may be supported with the <code>"Xqueue"</code> 
protocol type.</p>
<p>The <code>"Xqueue"</code> may also be used with the serial mouse.</p>
<p>The PnP serial mouse support (the <code>"Auto"</code> protocol) is not
tested.</p>

<H3><A NAME="19"></A>3.16. PANIX </H3>
<p>The PC/AT version of PANIX supports the bus and PS/2 mouse with the
<code>"Xqueue"</code> protocol type.
The PC-98 version of PANIX supports the bus mouse with the
<code>"Xqueue"</code> protocol type.</p>

 <HR NOSHADE>
<A HREF="mouse.html"><EM>Mouse Support in XFree86</EM></A>
 <b>:</b> <EM>OS Support for Mice </EM><BR>
<b>Previous:</b> <A HREF="mouse2.html"><EM>Supported Hardware </EM></A><BR>
<b>Next:</b> <A HREF="mouse4.html"><EM>Configuring Your Mouse </EM></A>



</BODY>
</HTML>
