source: archive/x7driver-vmmouse.xml

trunk
Last change on this file was 45ab6c7, checked in by Xi Ruoyao <xry111@…>, 3 months ago

more SVN prop clean up

Remove "$LastChanged$" everywhere, and also some unused $Date$

  • Property mode set to 100644
File size: 7.1 KB
Line 
1<?xml version="1.0" encoding="ISO-8859-1"?>
2<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
3 "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
4 <!ENTITY % general-entities SYSTEM "../../general.ent">
5 %general-entities;
6
7 <!ENTITY xorg-vmmouse-driver-version "13.1.0">
8
9 <!ENTITY xorg-vmmouse-driver-download-http "&xorg-download-http;/driver/xf86-input-vmmouse-&xorg-vmmouse-driver-version;.tar.bz2">
10 <!ENTITY xorg-vmmouse-driver-download-ftp "&xorg-download-ftp;/driver/xf86-input-vmmouse-&xorg-vmmouse-driver-version;.tar.bz2">
11 <!ENTITY xorg-vmmouse-driver-md5sum "85e2e464b7219c495ad3a16465c226ed">
12 <!ENTITY xorg-vmmouse-driver-size "312 KB">
13 <!ENTITY xorg-vmmouse-driver-buildsize "2.9 MB">
14 <!ENTITY xorg-vmmouse-driver-time "less than 0.1 SBU">
15]>
16
17 <!-- Begin Xorg VMMouse Driver -->
18 <sect2 id="xorg-vmmouse-driver" xreflabel="Xorg VMMouse Driver-&xorg-vmmouse-driver-version;">
19
20 <sect2info>
21 <date>$Date$</date>
22 </sect2info>
23
24 <title>Xorg VMMouse Driver-&xorg-vmmouse-driver-version;</title>
25
26 <indexterm zone="xorg-vmmouse-driver">
27 <primary sortas="a-xorg-vmmouse-driver">xorg-vmmouse-driver</primary>
28 </indexterm>
29
30 <sect3 role="package">
31 <title>Introduction to Xorg VMMouse Driver</title>
32
33 <para>
34 The <application>Xorg VMMouse Driver</application> package contains the
35 VMMouse input driver for the Xorg X server. The VMMouse driver enables
36 support for the special VMMouse protocol that is provided by VMware
37 virtual machines to give absolute pointer positioning. It can be used
38 with <application>Qemu</application>, too.
39 </para>
40
41 <note>
42 <para>
43 Starting with version 4.1, the linux kernel supports the VMMouse protocol
44 so that this driver is not needed anymore. Furthermore, kernel support
45 conflicts with earlier versions of this driver (before 13.1), so it is
46 advisable to either remove this driver if you plan to always use kernels
47 with versions greater or equal to 4.1, or update this driver to 13.1
48 or above if you want to be able to use both old and recent kernels.
49 </para>
50 </note>
51
52 &lfs84_checked;
53 <!-- I used this with both VMWare and QEMU. -->
54 <!-- with Kernel 5.1, this package is now obsolete and will cause X to crash.-->
55
56 <bridgehead renderas="sect4">Package Information</bridgehead>
57 <itemizedlist spacing="compact">
58 <listitem>
59 <para>
60 Download (HTTP): <ulink url="&xorg-vmmouse-driver-download-http;"/>
61 </para>
62 </listitem>
63 <listitem>
64 <para>
65 Download (FTP): <ulink url="&xorg-vmmouse-driver-download-ftp;"/>
66 </para>
67 </listitem>
68 <listitem>
69 <para>
70 Download MD5 sum: &xorg-vmmouse-driver-md5sum;
71 </para>
72 </listitem>
73 <listitem>
74 <para>
75 Download size: &xorg-vmmouse-driver-size;
76 </para>
77 </listitem>
78 <listitem>
79 <para>
80 Estimated disk space required: &xorg-vmmouse-driver-buildsize;
81 </para>
82 </listitem>
83 <listitem>
84 <para>
85 Estimated build time: &xorg-vmmouse-driver-time;
86 </para>
87 </listitem>
88 </itemizedlist>
89
90 <bridgehead renderas="sect4">Xorg VMMouse Driver Dependencies</bridgehead>
91
92 <bridgehead renderas="sect5">Required</bridgehead>
93 <para role="required">
94 <xref linkend="xorg-server"/>
95 </para>
96
97 <para condition="html" role="usernotes">
98 User Notes: <ulink url="&blfs-wiki;/xorg-vmmouse-driver"/>
99 </para>
100 </sect3>
101
102 <sect3 role="kernel" id="vmmouse-kernel">
103 <title>Kernel Configuration</title>
104
105 <para>
106 To get kernel support for the VMMouse, enable the following options in the
107 kernel configuration and recompile the kernel if necessary:
108 </para>
109
110<screen><literal>Processor type and features ---&gt;
111 [*] Symmetric multi-processing support [CONFIG_SMP]
112 [*] Support for extended (non-PC) x86 platforms [CONFIG_X86_EXTENDED_PLATFORM]
113 [*] ScaleMP vSMP [CONFIG_X86_VSMP]
114Device Drivers ---&gt;
115 Input device support ---&gt;
116 [*] Mice ---&gt; [CONFIG_INPUT_MOUSE]
117 &lt;*/M&gt; PS/2 mouse [CONFIG_MOUSE_PS2]
118 [*] Virtual mouse (vmmouse) [CONFIG_MOUSE_PS2_VMMOUSE]</literal></screen>
119 </sect3>
120 <sect3 role="installation">
121 <title>Installation of Xorg VMMouse Driver</title>
122
123 <para>
124 Install <application>Xorg VMMouse Driver</application> by running the
125 following commands:
126 </para>
127
128<screen><userinput>./configure $XORG_CONFIG \
129 --without-hal-fdi-dir \
130 --without-hal-callouts-dir \
131 --with-udev-rules-dir=/lib/udev/rules.d &amp;&amp;
132make</userinput></screen>
133
134 <para>
135 This package does not come with a test suite.
136 </para>
137
138 <para>
139 Now, as the <systemitem class="username">root</systemitem> user:
140 </para>
141
142<screen role="root"><userinput>make install</userinput></screen>
143 </sect3>
144
145 <sect3>
146 <title>Command Explanations</title>
147
148 <para>
149 <parameter>--with-udev-rules-dir=/lib/udev/rules.d</parameter>:
150 This switch specifies where udev rules should be installed.
151 </para>
152
153 <para>
154 <parameter>--without-hal-*-dir</parameter>: These switches disable
155 installation of the <application>HAL</application> components
156 which are not needed on Linux.
157 </para>
158
159 </sect3>
160
161 <sect3 role="content">
162 <title>Contents</title>
163
164 <segmentedlist>
165 <segtitle>Installed Program</segtitle>
166 <segtitle>Installed Xorg Drivers</segtitle>
167
168 <seglistitem>
169 <seg>
170 vmmouse_detect
171 </seg>
172 <seg>
173 vmmouse_drv.so
174 </seg>
175 </seglistitem>
176 </segmentedlist>
177
178 <variablelist>
179 <bridgehead renderas="sect4">Short Descriptions</bridgehead>
180 <?dbfo list-presentation="list"?>
181 <?dbhtml list-presentation="table"?>
182
183 <varlistentry id="vmmouse_detect">
184 <term><command>vmmouse_detect</command></term>
185 <listitem>
186 <para>
187 is a tool for detecting if running in a VMware environment where
188 vmmouse is used.
189 </para>
190 <indexterm zone="xorg-vmmouse-driver vmmouse_detect">
191 <primary sortas="b-vmmouse_detect">vmmouse_detect</primary>
192 </indexterm>
193 </listitem>
194 </varlistentry>
195
196 <varlistentry id="vmmouse_drv">
197 <term><filename class="libraryfile">vmmouse_drv.so</filename></term>
198 <listitem>
199 <para>
200 is an Xorg input driver for VMware Mouse.
201 </para>
202 <indexterm zone="xorg-vmmouse-driver vmmouse_drv">
203 <primary sortas="c-vmmouse_drv">vmmouse_drv.so</primary>
204 </indexterm>
205 </listitem>
206 </varlistentry>
207
208 </variablelist>
209
210 </sect3>
211
212 </sect2>
213 <!-- End Xorg VMMouse Driver -->
Note: See TracBrowser for help on using the repository browser.