mouseemu(8) [debian man page]
MOUSEEMU(8) System Manager's Manual MOUSEEMU(8) NAME
mouseemu - Emulate mouse buttons and mouse wheel SYNOPSIS
mouseemu [options] DESCRIPTION
Mouseemu is a daemon to emulate mouse buttons on trackpads with only one button. It lets you: - emulate middle and right click - emulate mouse wheel - block trackpad while typing It was initially developed for Apple PowerBooks and iBooks, but it may be useful on other architectures as well. This program only works when booting a 2.6 kernel because it uses the new uinput interface to emulate the mouse. OPTIONS
-middle B2_MOD B2_KEY Modifier and key for the middle (second) mouse button. Defaults to F10 and no modifier on PowerPC and Intel Macs, and to none on all other architectures. -right B3_MOD B3_KEY Modifier and key for the right (third) mouse button. Defaults to F11 and no modifier on PowerPC and Intel Macs, and to none on all other architectures. -scroll SCROLL_MOD Modifier for the scrolling function. Defaults to Alt. -typing-block DELAY Time in milliseconds for which the trackpad will be blocked while typing on the keyboard. Defaults to 300ms. -device UINPUT Device node for the uinput device. Defaults to /dev/uinput. If this device is not read and writeable the following devices are also tried: /dev/uinput, /dev/input/uinput and /dev/misc/uinput. -nofork don't run in the background -autorescan Automatically scan every 5s for new devices. This is normally not need, as udev should inform mouseemu about new devices. -debug print debugging messages about device scans -help show usage message The key codes for the buttons and modifiers are key scancodes. They can be found in include/linux/input.h in the kernel headers or by using `showkey` in a console. The keycodes must be given as decimal values (`showkey` displays hex values!). Mouseemu does normally not automatically scan for new devices. An udev rule is used to trigger a rescan when new devices are connected. You can also trigger a rescan manually by sending a HUP signal to the mouseemu process. EXAMPLES
To have the same behaviour as in MacOS X (CTRL-click for right mouse button and no emulation for the middle button): mouseemu -middle 0 0 -right 29 272 The code for the (left) mouse button is 272 (0x110 in hex). The code for CTRL is 29. Trigger a rescan for newly attached devices: kill -HUP `cat /var/run/mouseemu.pid` AUTHOR
Mouseemu was written by Colin Leroy <colin@colino.net>. This manpage was originally written by Gaudenz Steinlin <gaudenz@debian.org> for the Debian Project, but may be used by others under the terms of the GNU General Public License. 2005-03-29 MOUSEEMU(8)
Check Out this Related Man Page
virtualkm(7D) virtualkm(7D) NAME
virtualkm - Virtual keyboard and mouse SYNOPSIS
/dev/kbd /dev/mouse A virtual keyboard or mouse is an abstraction of one or more physical keyboards or mice (USB or PS2) connected to a system. Input streams for these physical devices are coalesced into a single input stream and appear as a single device to the upper layers. /dev/kbd is the virtual keyboard device file. Inputs from multiple keyboards are coalesced into a single input stream, meaning that all keyboards appear as a single keyboard to a console or window system and accordingly, are treated as a single device. The virtual keyboard layout is consistent with the layout of the first keyboard plugged into the system. Note that on x86 platforms, the virtual keyboard layout can be overloaded by eeprom(1M). /dev/mouse is the virtual mouse device file. Inputs from multiple mice are coalesced into a single input stream, meaning that all mice appear as single mouse to the window system. Commands from applications are dispatched by the virtual keyboard/mouse facility to the underlying physical devices and will succeed pro- vided that one of the underlying devices responds with success. For example, a single command issued to turn on LED's will turn on corre- sponding LED's for all underlying physical keyboards. Although physical keyboards/mice are linked to the virtual keyboard/mouse facility, each may be opened separately by accessing its asso- ciated device file. (For example, /dev/usb/hid0 for a usb mouse). Directly accessing a device file can be useful for multi-seat, gok(1) or similar purposes. When a single physical device is opened via its associated device file, it is automatically removed from the single virtual input stream. When closed, it is automatically re- coalesced into the single virtual input stream. Under the virtualkm facility, the PS/2 mouse is coalesced into a virtual mouse single input stream and can be accessed using the /dev/mouse file. (Note that in previous releases, the PS/2 mouse was accessed via the /dev/kdmouse physical device file). In the current release, you use the /dev/kdmouse file to directly access the physical PS/2 mouse. INTERFACES The virtual mouse provides the following event ID's for mouse capability changes: MOUSE_CAP_CHANGE_NUM_BUT This event is reported when the total number of mouse buttons changes. The Firm_event.value is set to the new button total, which is the maximum number of all mice buttons. Other fields are ignored. MOUSE_CAP_CHANGE_NUM_WHEEL This event is reported when the total number of mouse wheels changes. The Firm_event.value is set to the new wheel total. Other fields are ignored. The event value (Firm_event.value) can be 0 (no wheel), 1 (vertical wheel), or 2 (vertical and horizontal wheel). The Firm_event structure is described in <sys/vuid_event.h>. As with other events, firm events are received using read(2). Event ID's are used by applications (including certain mouse demo applications) that are programmed to graphically represent the actual number of buttons and wheels on a mouse. When an application of this type receives a Firm_event with a ID MOUSE_CAP_CHANGE_NUM_BUT or MOUSE_CAP_CHANGE_NUM_WHEEL event, it is instructed to update its state information using the new value. Consider, for example, a mouse demo application whose sole function is to display a mouse with buttons that graphically correspond to the actual number of buttons on the mouse. If, for example, the system has a single two-button USB mouse attached, the application, by default, will graphically display the mouse with a left and a right button. However, if a another three-button USB mouse is hot-plugged into the system, a MOUSE_CAP_CHANGE_NUM_BUT Firm event with Firm_event.value of three instructs the demo application to update the mouse display to indicate three buttons. /dev/kbd Virtual Keyboard device file. /dev/mouse Virtual Mouse device file. /dev/kdmouse Physical PS/2 mouse device file. /dev/usb/hid* Physical USB keyboard/mouse device file. /etc/dacf.conf Device auto-configuration file. See attributes(5) for descriptions of the following attributes: +-----------------------------+-----------------------------+ | ATTRIBUTE TYPE | ATTRIBUTE VALUE | |Architecture |SPARC, | |Availability |SUNWckr, SUNWcsd, SUNWusb, | | |SUNWpsdcr, SUNWcakr.i | |Interface Stability |Evolving | +-----------------------------+-----------------------------+ SEE ALSO
, eeprom(1M), read(2), attributes(5), hid(7D), usba(7D), kb(7M), usbkbm(7M), usbms(7M), vuidmice(7M) See gok(1) in the GNOME man pages, available in the SUNWgnome package. gok(1) is not a SunOS man page. DIAGNOSTICS
The messages described below may appear on the system console as well as being logged. All messages are formatted in the following man- ner: WARNING: Error message... conskbd: keyboard is not available for system debugging: device_path. Errors were encountered while entering kmdb during initialization for debugger mode. As a result, the keyboard is not available. conskbd: keyboard is not available: <device_path> Errors were encountered while exiting kmdb during un-initialization for debugger mode. As a result, the keyboard is not available. Failed to relink the mouse <device_path> underneath virtual mouse An error was encountered and the mouse is unavailable. (When a mouse is physically opened via a physical device file such as /dev/usb/hid0, it is removed from the single virtual input stream (/dev/mouse). When closed, it is re-coalesced into a single virtual input stream beneath /dev/mouse. If an error is encountered, (for example, the mouse has been physically removed), it is unavailable beneath /dev/mouse. NOTES
Currently, the virtualkm device supports only USB and PS2 keyboards and mice. The virtualkm device maintains complete compatibility on select legacy systems, (including Ultra 10's), that are equipped with serial key- board/mouse. 21 June 2005 virtualkm(7D)