194a804c5SMike Pritchard.\" Copyright (c) 1996 294a804c5SMike Pritchard.\" Mike Pritchard <mpp@FreeBSD.org>. All rights reserved. 394a804c5SMike Pritchard.\" 494a804c5SMike Pritchard.\" Redistribution and use in source and binary forms, with or without 594a804c5SMike Pritchard.\" modification, are permitted provided that the following conditions 694a804c5SMike Pritchard.\" are met: 794a804c5SMike Pritchard.\" 1. Redistributions of source code must retain the above copyright 894a804c5SMike Pritchard.\" notice, this list of conditions and the following disclaimer. 994a804c5SMike Pritchard.\" 2. Redistributions in binary form must reproduce the above copyright 1094a804c5SMike Pritchard.\" notice, this list of conditions and the following disclaimer in the 1194a804c5SMike Pritchard.\" documentation and/or other materials provided with the distribution. 1294a804c5SMike Pritchard.\" 3. All advertising materials mentioning features or use of this software 1394a804c5SMike Pritchard.\" must display the following acknowledgement: 1494a804c5SMike Pritchard.\" This product includes software developed by Mike Pritchard. 1594a804c5SMike Pritchard.\" 4. Neither the name of the author nor the names of its contributors 1694a804c5SMike Pritchard.\" may be used to endorse or promote products derived from this software 1794a804c5SMike Pritchard.\" without specific prior written permission. 1894a804c5SMike Pritchard.\" 1994a804c5SMike Pritchard.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND 2094a804c5SMike Pritchard.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE 2194a804c5SMike Pritchard.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE 2294a804c5SMike Pritchard.\" ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE 2394a804c5SMike Pritchard.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL 2494a804c5SMike Pritchard.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS 2594a804c5SMike Pritchard.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) 2694a804c5SMike Pritchard.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT 2794a804c5SMike Pritchard.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY 2894a804c5SMike Pritchard.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF 2994a804c5SMike Pritchard.\" SUCH DAMAGE. 3094a804c5SMike Pritchard.\" 3197d92980SPeter Wemm.\" $FreeBSD$ 325cf470d6SWolfram Schneider.\" 33e68b10b3SKazutaka YOKOTA.Dd April 1, 2000 3494a804c5SMike Pritchard.Dt MOUSED 8 3594a804c5SMike Pritchard.Os FreeBSD 3694a804c5SMike Pritchard.Sh NAME 3794a804c5SMike Pritchard.Nm moused 385f436cfbSKazutaka YOKOTA.Nd pass mouse data to the console driver 3994a804c5SMike Pritchard.Sh SYNOPSIS 4094a804c5SMike Pritchard.Nm 41e68b10b3SKazutaka YOKOTA.Op Fl DPRcdfs 42f82812a2SKazutaka YOKOTA.Op Fl I Ar file 435f436cfbSKazutaka YOKOTA.Op Fl F Ar rate 445f436cfbSKazutaka YOKOTA.Op Fl r Ar resolution 4594a804c5SMike Pritchard.Op Fl S Ar baudrate 465f436cfbSKazutaka YOKOTA.Op Fl C Ar threshold 475f436cfbSKazutaka YOKOTA.Op Fl m Ar N=M 489fb1d70cSKazutaka YOKOTA.Op Fl w Ar N 495f436cfbSKazutaka YOKOTA.Op Fl z Ar target 505f436cfbSKazutaka YOKOTA.Op Fl t Ar mousetype 51e68b10b3SKazutaka YOKOTA.Op Fl 3 Op Fl E Ar timeout 5294a804c5SMike Pritchard.Fl p Ar port 5394a804c5SMike Pritchard.Pp 545f436cfbSKazutaka YOKOTA.Nm 555f436cfbSKazutaka YOKOTA.Op Fl Pd 565f436cfbSKazutaka YOKOTA.Fl p Ar port 575f436cfbSKazutaka YOKOTA.Fl i Ar info 585f436cfbSKazutaka YOKOTA.Sh DESCRIPTION 595f436cfbSKazutaka YOKOTAThe mouse daemon 605f436cfbSKazutaka YOKOTA.Nm 615f436cfbSKazutaka YOKOTAand the console driver work together to support 625f436cfbSKazutaka YOKOTAmouse operation in the text console and user programs. 635f436cfbSKazutaka YOKOTAThey virtualize the mouse and provide user programs with mouse data 645f436cfbSKazutaka YOKOTAin the standard format 655f436cfbSKazutaka YOKOTA.Pq see Xr sysmouse 4 . 665f436cfbSKazutaka YOKOTA.Pp 675f436cfbSKazutaka YOKOTAThe mouse daemon listens to the specified port for mouse data, 685f436cfbSKazutaka YOKOTAinterprets and then passes it via ioctls to the console driver. 695f436cfbSKazutaka YOKOTAThe mouse daemon 705f436cfbSKazutaka YOKOTAreports translation movement, button press/release 715f436cfbSKazutaka YOKOTAevents and movement of the roller or the wheel if available. 725f436cfbSKazutaka YOKOTAThe roller/wheel movement is reported as ``Z'' axis movement. 735f436cfbSKazutaka YOKOTA.Pp 745f436cfbSKazutaka YOKOTAThe console driver will display the mouse pointer on the screen 755f436cfbSKazutaka YOKOTAand provide cut and paste functions if the mouse pointer is enabled 765f436cfbSKazutaka YOKOTAin the virtual console via 772f2ac2cbSChris Costello.Xr vidcontrol 1 . 785f436cfbSKazutaka YOKOTAIf 795f436cfbSKazutaka YOKOTA.Xr sysmouse 4 805f436cfbSKazutaka YOKOTAis opened by the user program, the console driver also passes the mouse 815f436cfbSKazutaka YOKOTAdata to the device so that the user program will see it. 825f436cfbSKazutaka YOKOTA.Pp 835f436cfbSKazutaka YOKOTAIf the mouse daemon receives the signal 845f436cfbSKazutaka YOKOTA.Dv SIGHUP , 85f2e366a1SSheldon Hearnit will reopen the mouse port and reinitializes itself. 86f2e366a1SSheldon HearnUseful if 875f436cfbSKazutaka YOKOTAthe mouse is attached/detached while the system is suspended. 885f436cfbSKazutaka YOKOTA.Pp 895f436cfbSKazutaka YOKOTAThe following options are available: 9094a804c5SMike Pritchard.Bl -tag -width indent 915f436cfbSKazutaka YOKOTA.It Fl 3 92f2e366a1SSheldon HearnEmulate the third (middle) button for 2-button mice. 93f2e366a1SSheldon HearnIt is emulated 945f436cfbSKazutaka YOKOTAby pressing the left and right physical buttons simultaneously. 955f436cfbSKazutaka YOKOTA.It Fl C Ar threshold 965f436cfbSKazutaka YOKOTASet double click speed as the maximum interval in msec between button clicks. 975f436cfbSKazutaka YOKOTAWithout this option, the default value of 500 msec will be assumed. 985f436cfbSKazutaka YOKOTAThis option will have effect only on the cut and paste operations 99f2e366a1SSheldon Hearnin the text mode console. 100f2e366a1SSheldon HearnThe user program which is reading mouse data 1015f436cfbSKazutaka YOKOTAvia 1025f436cfbSKazutaka YOKOTA.Xr sysmouse 4 1035f436cfbSKazutaka YOKOTAwon't be affected. 10494a804c5SMike Pritchard.It Fl D 10594a804c5SMike PritchardLower DTR on the serial port. 1065f436cfbSKazutaka YOKOTAThis option is valid only if 1075f436cfbSKazutaka YOKOTA.Ar mousesystems 1085f436cfbSKazutaka YOKOTAis selected as the protocol type. 1095f436cfbSKazutaka YOKOTAThe DTR line may need to be dropped for a 3-button mouse 1105f436cfbSKazutaka YOKOTAto operate in the 1115f436cfbSKazutaka YOKOTA.Ar mousesystems 1125f436cfbSKazutaka YOKOTAmode. 113e68b10b3SKazutaka YOKOTA.It Fl E Ar timeout 114e68b10b3SKazutaka YOKOTAWhen the third button emulation is enabled 115e68b10b3SKazutaka YOKOTA.Pq see above , 116e68b10b3SKazutaka YOKOTAthe 117e68b10b3SKazutaka YOKOTA.Nm 118e68b10b3SKazutaka YOKOTAdaemon waits 119e68b10b3SKazutaka YOKOTA.Ar timeout 120e68b10b3SKazutaka YOKOTAmsec at maximum before deciding if two buttons are pressed 121e68b10b3SKazutaka YOKOTAsimultaneously. 122e68b10b3SKazutaka YOKOTAThe default timeout is 200 msec. 1235f436cfbSKazutaka YOKOTA.It Fl F Ar rate 1245f436cfbSKazutaka YOKOTASet the report rate (reports/sec) of the device if supported. 125f82812a2SKazutaka YOKOTA.It Fl I Ar file 126f82812a2SKazutaka YOKOTAWrite the process id of the 127f82812a2SKazutaka YOKOTA.Nm 128f82812a2SKazutaka YOKOTAdaemon in the specified file. 129f82812a2SKazutaka YOKOTAWithout this option, the process id will be stored in 130f82812a2SKazutaka YOKOTA.Pa /var/run/moused.pid . 1315f436cfbSKazutaka YOKOTA.It Fl P 1325f436cfbSKazutaka YOKOTADo not start the Plug and Play COM device enumeration procedure 1335f436cfbSKazutaka YOKOTAwhen identifying the serial mouse. 1345f436cfbSKazutaka YOKOTAIf this option is given together with the 1355f436cfbSKazutaka YOKOTA.Fl i 1365f436cfbSKazutaka YOKOTAoption, the 1375f436cfbSKazutaka YOKOTA.Nm 13865b81961SKazutaka YOKOTAcommand won't be able to print useful information for the serial mouse. 13994a804c5SMike Pritchard.It Fl R 14094a804c5SMike PritchardLower RTS on the serial port. 1415f436cfbSKazutaka YOKOTAThis option is valid only if 1425f436cfbSKazutaka YOKOTA.Ar mousesystems 1435f436cfbSKazutaka YOKOTAis selected as the protocol type by the 1445f436cfbSKazutaka YOKOTA.Fl t 145f2e366a1SSheldon Hearnoption below. 146f2e366a1SSheldon HearnIt is often used with the 1475f436cfbSKazutaka YOKOTA.Fl D 148f2e366a1SSheldon Hearnoption above. 149f2e366a1SSheldon HearnBoth RTS and DTR lines may need to be dropped for 1505f436cfbSKazutaka YOKOTAa 3-button mouse to operate in the 1515f436cfbSKazutaka YOKOTA.Ar mousesystems 1525f436cfbSKazutaka YOKOTAmode. 15394a804c5SMike Pritchard.It Fl S Ar baudrate 15494a804c5SMike PritchardSelect the baudrate for the serial port (1200 to 9600). 1555f436cfbSKazutaka YOKOTANot all serial mice support this option. 15694a804c5SMike Pritchard.It Fl c 1575f436cfbSKazutaka YOKOTASome mice report middle button down events 158f2e366a1SSheldon Hearnas if the left and right buttons are pressed. 159f2e366a1SSheldon HearnThis option handles this. 16094a804c5SMike Pritchard.It Fl d 16194a804c5SMike PritchardEnable debugging messages. 16294a804c5SMike Pritchard.It Fl f 16394a804c5SMike PritchardDo not become a daemon and instead run as a foreground process. 1645f436cfbSKazutaka YOKOTAUseful for testing and debugging. 1655f436cfbSKazutaka YOKOTA.It Fl i Ar info 1665f436cfbSKazutaka YOKOTAPrint specified information and quit. Available pieces of 1675f436cfbSKazutaka YOKOTAinformation are: 1685f436cfbSKazutaka YOKOTA.Pp 1695f436cfbSKazutaka YOKOTA.Bl -tag -compact -width modelxxx 1705f436cfbSKazutaka YOKOTA.It Ar port 1715f436cfbSKazutaka YOKOTAPort (device file) name, i.e. 1725f436cfbSKazutaka YOKOTA.Pa /dev/cuaa0 , 1735f436cfbSKazutaka YOKOTA.Pa /dev/mse0 1745f436cfbSKazutaka YOKOTAand 1755f436cfbSKazutaka YOKOTA.Pa /dev/psm0 . 1765f436cfbSKazutaka YOKOTA.It Ar if 1775f436cfbSKazutaka YOKOTAInterface type: serial, bus, inport or ps/2. 1785f436cfbSKazutaka YOKOTA.It Ar type 179f2e366a1SSheldon HearnProtocol type. 180f2e366a1SSheldon HearnIt is one of the types listed under the 1815f436cfbSKazutaka YOKOTA.Fl t 1825f436cfbSKazutaka YOKOTAoption below or 1835f436cfbSKazutaka YOKOTA.Ar sysmouse 1845f436cfbSKazutaka YOKOTAif the driver supports the 1855f436cfbSKazutaka YOKOTA.Ar sysmouse 1865f436cfbSKazutaka YOKOTAdata format standard. 1875f436cfbSKazutaka YOKOTA.It Ar model 1885f436cfbSKazutaka YOKOTAMouse model. The 1895f436cfbSKazutaka YOKOTA.Nm 1905f436cfbSKazutaka YOKOTAcommand may not always be able to identify the model. 1915f436cfbSKazutaka YOKOTA.It Ar all 1925f436cfbSKazutaka YOKOTAAll of the above items. Print port, interface, type and model in this order 1935f436cfbSKazutaka YOKOTAin one line. 1945f436cfbSKazutaka YOKOTA.El 1955f436cfbSKazutaka YOKOTA.Pp 1965f436cfbSKazutaka YOKOTAIf the 1975f436cfbSKazutaka YOKOTA.Nm 1985f436cfbSKazutaka YOKOTAcommand cannot determine the requested information, it prints ``unknown'' 1995f436cfbSKazutaka YOKOTAor ``generic''. 2005f436cfbSKazutaka YOKOTA.It Fl m Ar N=M 2015f436cfbSKazutaka YOKOTAAssign the physical button 2025f436cfbSKazutaka YOKOTA.Ar M 2035f436cfbSKazutaka YOKOTAto the logical button 2045f436cfbSKazutaka YOKOTA.Ar N. 2055f436cfbSKazutaka YOKOTAYou may specify as many instances of this option as you like. 2065f436cfbSKazutaka YOKOTAMore than one physical button may be assigned to a logical button at the 207f2e366a1SSheldon Hearnsame time. 208f2e366a1SSheldon HearnIn this case the logical button will be down, 2095f436cfbSKazutaka YOKOTAif either of the assigned physical buttons is held down. 2105f436cfbSKazutaka YOKOTADo not put space around `='. 21194a804c5SMike Pritchard.It Fl p Ar port 21294a804c5SMike PritchardUse 21394a804c5SMike Pritchard.Ar port 2145f436cfbSKazutaka YOKOTAto communicate with the mouse. 2155f436cfbSKazutaka YOKOTA.It Fl r Ar resolution 2165f436cfbSKazutaka YOKOTASet the resolution of the device; in Dots Per Inch, or 2175f436cfbSKazutaka YOKOTA.Ar low , 2185f436cfbSKazutaka YOKOTA.Ar medium-low , 2195f436cfbSKazutaka YOKOTA.Ar medium-high 2205f436cfbSKazutaka YOKOTAor 2215f436cfbSKazutaka YOKOTA.Ar high . 2225f436cfbSKazutaka YOKOTAThis option may not be supported by all the device. 22394a804c5SMike Pritchard.It Fl s 22494a804c5SMike PritchardSelect a baudrate of 9600 for the serial line. 2255f436cfbSKazutaka YOKOTANot all serial mice support this option. 2265f436cfbSKazutaka YOKOTA.It Fl t Ar type 227f8b013e2SKazutaka YOKOTASpecify the protocol type of the mouse attached to the port. 22830ee7535SKazutaka YOKOTAYou may explicitly specify a type listed below, or use 22930ee7535SKazutaka YOKOTA.Ar auto 23030ee7535SKazutaka YOKOTAto let the 231f8b013e2SKazutaka YOKOTA.Nm 23230ee7535SKazutaka YOKOTAcommand to automatically select an appropriate protocol for the given 23330ee7535SKazutaka YOKOTAmouse. 23430ee7535SKazutaka YOKOTAIf you entirely ommit this options in the command line, 23530ee7535SKazutaka YOKOTA.Fl t Ar auto 23630ee7535SKazutaka YOKOTAis assumed. 23730ee7535SKazutaka YOKOTAUnder normal circumstances, 23830ee7535SKazutaka YOKOTAyou need to use this option only if the 23930ee7535SKazutaka YOKOTA.Nm 24030ee7535SKazutaka YOKOTAcommand is not able to detect the protocol automatically 241f8b013e2SKazutaka YOKOTA.Pq see the Sx Configuring Mouse Daemon . 242f8b013e2SKazutaka YOKOTA.Pp 2439e65e45bSKazutaka YOKOTANote that if a protocol type is specified with this option, the 24430ee7535SKazutaka YOKOTA.Fl P 24530ee7535SKazutaka YOKOTAoption above is implied and Plug and Play COM device enumeration 24630ee7535SKazutaka YOKOTAprocedure will be disabled. 24730ee7535SKazutaka YOKOTA.Pp 2489e65e45bSKazutaka YOKOTAAlso note that if your mouse is attached to the PS/2 mouse port, you should 2499e65e45bSKazutaka YOKOTAalways choose 2509e65e45bSKazutaka YOKOTA.Ar auto 2519e65e45bSKazutaka YOKOTAor 2529e65e45bSKazutaka YOKOTA.Ar ps/2 , 2539e65e45bSKazutaka YOKOTAregardless of the brand and model of the mouse. Likewise, if your 2549e65e45bSKazutaka YOKOTAmouse is attached to the bus mouse port, choose 2559e65e45bSKazutaka YOKOTA.Ar auto 2569e65e45bSKazutaka YOKOTAor 2579e65e45bSKazutaka YOKOTA.Ar busmouse . 2589e65e45bSKazutaka YOKOTASerial mouse protocols will not work with these mice. 2599e65e45bSKazutaka YOKOTA.Pp 260045c8108SKazutaka YOKOTAFor the USB mouse, the protocol must be 261045c8108SKazutaka YOKOTA.Ar auto . 262045c8108SKazutaka YOKOTANo other protocol will work with the USB mouse. 263045c8108SKazutaka YOKOTA.Pp 264f8b013e2SKazutaka YOKOTAValid types for this option are 2655f436cfbSKazutaka YOKOTAlisted below. 26694a804c5SMike Pritchard.Pp 2675f436cfbSKazutaka YOKOTAFor the serial mouse: 26894a804c5SMike Pritchard.Bl -tag -compact -width mousesystemsxxx 2695f436cfbSKazutaka YOKOTA.It Ar microsoft 2705f436cfbSKazutaka YOKOTAMicrosoft serial mouse protocol. Most 2-button serial mice use this protocol. 2715f436cfbSKazutaka YOKOTA.It Ar intellimouse 2725f436cfbSKazutaka YOKOTAMicrosoft IntelliMouse protocol. Genius NetMouse, ASCII Mie Mouse, 2735f436cfbSKazutaka YOKOTALogitech MouseMan+ and FirstMouse+ use this protocol too. 2745f436cfbSKazutaka YOKOTAOther mice with a roller/wheel may be compatible with this protocol. 2755f436cfbSKazutaka YOKOTA.It Ar mousesystems 2765f436cfbSKazutaka YOKOTAMouseSystems 5-byte protocol. 3-button mice may use this protocol. 2775f436cfbSKazutaka YOKOTA.It Ar mmseries 2785f436cfbSKazutaka YOKOTAMM Series mouse protocol. 2795f436cfbSKazutaka YOKOTA.It Ar logitech 2805f436cfbSKazutaka YOKOTALogitech mouse protocol. Note that this is for old Logitech models. 2815f436cfbSKazutaka YOKOTA.Ar mouseman 2825f436cfbSKazutaka YOKOTAor 2835f436cfbSKazutaka YOKOTA.Ar intellimouse 2845f436cfbSKazutaka YOKOTAshould be specified for newer models. 2855f436cfbSKazutaka YOKOTA.It Ar mouseman 2865f436cfbSKazutaka YOKOTALogitech MouseMan and TrackMan protocol. Some 3-button mice may be compatible 2875f436cfbSKazutaka YOKOTAwith this protocol. Note that MouseMan+ and FirstMouse+ use 2885f436cfbSKazutaka YOKOTA.Ar intellimouse 2895f436cfbSKazutaka YOKOTAprotocol rather than this one. 2905f436cfbSKazutaka YOKOTA.It Ar glidepoint 2915f436cfbSKazutaka YOKOTAALPS GlidePoint protocol. 2925f436cfbSKazutaka YOKOTA.It Ar thinkingmouse 2935f436cfbSKazutaka YOKOTAKensington ThinkingMouse protocol. 294929cbbf2SDoug White.It Ar mmhitab 2955f436cfbSKazutaka YOKOTAHitachi tablet protocol. 29667978692SAmancio Hasty.It Ar x10mouseremote 29767978692SAmancio HastyX10 MouseRemote. 2981b11ca6cSKazutaka YOKOTA.It Ar kidspad 2991b11ca6cSKazutaka YOKOTAGenius Kidspad and Easypad protocol. 3002e09fb67SKazutaka YOKOTA.It Ar versapad 3012e09fb67SKazutaka YOKOTAInterlink VersaPad protocol. 30294a804c5SMike Pritchard.El 3035f436cfbSKazutaka YOKOTA.Pp 3045f436cfbSKazutaka YOKOTAFor the bus and InPort mouse: 3055f436cfbSKazutaka YOKOTA.Bl -tag -compact -width mousesystemsxxx 3065f436cfbSKazutaka YOKOTA.It Ar busmouse 3075f436cfbSKazutaka YOKOTAThis is the only protocol type available for 3085f436cfbSKazutaka YOKOTAthe bus and InPort mouse and should be specified for any bus mice 3095f436cfbSKazutaka YOKOTAand InPort mice, regardless of the brand. 3105f436cfbSKazutaka YOKOTA.El 3115f436cfbSKazutaka YOKOTA.Pp 3125f436cfbSKazutaka YOKOTAFor the PS/2 mouse: 3135f436cfbSKazutaka YOKOTA.Bl -tag -compact -width mousesystemsxxx 3145f436cfbSKazutaka YOKOTA.It Ar ps/2 3155f436cfbSKazutaka YOKOTAThis is the only protocol type available for the PS/2 mouse 3165f436cfbSKazutaka YOKOTAand should be specified for any PS/2 mice, regardless of the brand. 3175f436cfbSKazutaka YOKOTA.El 318045c8108SKazutaka YOKOTA.Pp 319045c8108SKazutaka YOKOTAFor the USB mouse, 320045c8108SKazutaka YOKOTA.Ar auto 321045c8108SKazutaka YOKOTAis the only protocol type available for the USB mouse 322045c8108SKazutaka YOKOTAand should be specified for any USB mice, regardless of the brand. 3239fb1d70cSKazutaka YOKOTA.It Fl w Ar N 3249fb1d70cSKazutaka YOKOTAMake the physical button 3259fb1d70cSKazutaka YOKOTA.Ar N 3269fb1d70cSKazutaka YOKOTAact as the wheel mode button. 3279fb1d70cSKazutaka YOKOTAWhile this button is pressed, X and Y axis movement is reported to be zero 3289fb1d70cSKazutaka YOKOTAand the Y axis movement is mapped to Z axis. 3299fb1d70cSKazutaka YOKOTAYou may further map the Z axis movement to virtual buttons by the 3309fb1d70cSKazutaka YOKOTA.Fl z 3319fb1d70cSKazutaka YOKOTAoption below. 3325f436cfbSKazutaka YOKOTA.It Fl z Ar target 3335f436cfbSKazutaka YOKOTAMap Z axis (roller/wheel) movement to another axis or to virtual buttons. 3345f436cfbSKazutaka YOKOTAValid 3355f436cfbSKazutaka YOKOTA.Ar target 3365f436cfbSKazutaka YOKOTAmaybe: 3375f436cfbSKazutaka YOKOTA.Bl -tag -compact -width x__ 3385f436cfbSKazutaka YOKOTA.It Ar x 3395f436cfbSKazutaka YOKOTA.It Ar y 3405f436cfbSKazutaka YOKOTAX or Y axis movement will be reported when the Z axis movement is detected. 3415f436cfbSKazutaka YOKOTA.It Ar N 3425f436cfbSKazutaka YOKOTAReport the virtual buttons 3435f436cfbSKazutaka YOKOTA.Ar N 3445f436cfbSKazutaka YOKOTAand 3455f436cfbSKazutaka YOKOTA.Ar N+1 3465f436cfbSKazutaka YOKOTAdown events respectively when negative and positive Z axis movement 347f2e366a1SSheldon Hearnis detected. 348f2e366a1SSheldon HearnThere doesn't need to be physical buttons 3495f436cfbSKazutaka YOKOTA.Ar N 3505f436cfbSKazutaka YOKOTAand 3515f436cfbSKazutaka YOKOTA.Ar N+1 . 3525f436cfbSKazutaka YOKOTANote that mapping to logical buttons is carried out after mapping 3535f436cfbSKazutaka YOKOTAfrom the Z axis movement to the virtual buttons is done. 354e68b10b3SKazutaka YOKOTA.It Ar N1 N2 355e68b10b3SKazutaka YOKOTAReport the virtual buttons 356e68b10b3SKazutaka YOKOTA.Ar N1 357e68b10b3SKazutaka YOKOTAand 358e68b10b3SKazutaka YOKOTA.Ar N2 359e68b10b3SKazutaka YOKOTAdown events respectively when negative and positive Z axis movement 360e68b10b3SKazutaka YOKOTAis detected. 361e68b10b3SKazutaka YOKOTA.It Ar N1 N2 N3 N4 362e68b10b3SKazutaka YOKOTAThis is useful for the mouse with two wheels of which 363e68b10b3SKazutaka YOKOTAthe second wheel is used to generate horizontal scroll action, 364e68b10b3SKazutaka YOKOTAand for the mouse which has a knob or a stick which can detect 365e68b10b3SKazutaka YOKOTAthe horizontal force applied by the user. 366e68b10b3SKazutaka YOKOTA.Pp 367e68b10b3SKazutaka YOKOTAThe motion of the second wheel will be mapped to the buttons 368e68b10b3SKazutaka YOKOTA.Ar N3 , 369e68b10b3SKazutaka YOKOTAfor the negative direction, and 370e68b10b3SKazutaka YOKOTA.Ar N4 , 371e68b10b3SKazutaka YOKOTAfor the positive direction. 372e68b10b3SKazutaka YOKOTAIf the buttons 373e68b10b3SKazutaka YOKOTA.Ar N3 374e68b10b3SKazutaka YOKOTAand 375e68b10b3SKazutaka YOKOTA.Ar N4 376e68b10b3SKazutaka YOKOTAactually exist in this mouse, their actions won't be detected. 377e68b10b3SKazutaka YOKOTA.Pp 378e68b10b3SKazutaka YOKOTANote that horizontal movement or second roller/wheel movement may not 379e68b10b3SKazutaka YOKOTAalways be detected, 380e68b10b3SKazutaka YOKOTAbecause there appears to be no accepted standard as to how it is encoded. 381e68b10b3SKazutaka YOKOTA.Pp 382e68b10b3SKazutaka YOKOTANote also that some mice think left is the negative horizontal direction, 383e68b10b3SKazutaka YOKOTAothers may think otherwise. 384e68b10b3SKazutaka YOKOTAMoreover, there are some mice whose two wheels are both mounted vertically, 385e68b10b3SKazutaka YOKOTAand the direction of the second vertical wheel does not match the 386e68b10b3SKazutaka YOKOTAfirst one's. 3875f436cfbSKazutaka YOKOTA.El 3885f436cfbSKazutaka YOKOTA.El 389f8b013e2SKazutaka YOKOTA.Ss Configuring Mouse Daemon 3905f436cfbSKazutaka YOKOTAThe first thing you need to know is the interface type 3915f436cfbSKazutaka YOKOTAof the mouse you are going to use. 3925f436cfbSKazutaka YOKOTAIt can be determined by looking at the connector of the mouse. 3935f436cfbSKazutaka YOKOTAThe serial mouse has a D-Sub female 9- or 25-pin connector. 3945f436cfbSKazutaka YOKOTAThe bus and InPort mice have either a D-Sub male 9-pin connector 3955f436cfbSKazutaka YOKOTAor a round DIN 9-pin connector. 3965f436cfbSKazutaka YOKOTAThe PS/2 mouse is equipped with a small, round DIN 6-pin connector. 3975f436cfbSKazutaka YOKOTASome mice come with adapters with which the connector can 3985f436cfbSKazutaka YOKOTAbe converted to another. If you are to use such an adapter, 3995f436cfbSKazutaka YOKOTAremember the connector at the very end of the mouse/adapter pair is 4005f436cfbSKazutaka YOKOTAwhat matters. 401045c8108SKazutaka YOKOTAThe USB mouse has a flat rectangular connector. 4025f436cfbSKazutaka YOKOTA.Pp 4035f436cfbSKazutaka YOKOTAThe next thing to decide is a port to use for the given interface. 4045f436cfbSKazutaka YOKOTAFor the bus, InPort and PS/2 mice, there is little choice: 4055f436cfbSKazutaka YOKOTAthe bus and InPort mice always use 4065f436cfbSKazutaka YOKOTA.Pa /dev/mse0 , 4075f436cfbSKazutaka YOKOTAand the PS/2 mouse is always at 4085f436cfbSKazutaka YOKOTA.Pa /dev/psm0 . 4095f436cfbSKazutaka YOKOTAThere may be more than one serial port to which the serial 4105f436cfbSKazutaka YOKOTAmouse can be attached. Many people often assign the first, built-in 4115f436cfbSKazutaka YOKOTAserial port 4125f436cfbSKazutaka YOKOTA.Pa /dev/cuaa0 4135f436cfbSKazutaka YOKOTAto the mouse. 414045c8108SKazutaka YOKOTAYou can attach multiple USB mice to your system or to your USB hub. 415045c8108SKazutaka YOKOTAThey are accessible as 416045c8108SKazutaka YOKOTA.Pa /dev/ums0, /dev/ums1, 417045c8108SKazutaka YOKOTAand so on. 418045c8108SKazutaka YOKOTA.Pa 4195f436cfbSKazutaka YOKOTAYou may want to create a symbolic link 4205f436cfbSKazutaka YOKOTA.Pa /dev/mouse 4215f436cfbSKazutaka YOKOTApointing to the real port to which the mouse is connected, so that you 4225f436cfbSKazutaka YOKOTAcan easily distinguish which is your ``mouse'' port later. 4235f436cfbSKazutaka YOKOTA.Pp 4245f436cfbSKazutaka YOKOTAThe next step is to guess the appropriate protocol type for the mouse. 4255f436cfbSKazutaka YOKOTAThe 4265f436cfbSKazutaka YOKOTA.Nm 4275f436cfbSKazutaka YOKOTAcommand may be able to automatically determine the protocol type. 4285f436cfbSKazutaka YOKOTARun the 4295f436cfbSKazutaka YOKOTA.Nm 4305f436cfbSKazutaka YOKOTAcommand with the 4315f436cfbSKazutaka YOKOTA.Fl i 4325f436cfbSKazutaka YOKOTAoption and see what it says. If the command can identify 4335f436cfbSKazutaka YOKOTAthe protocol type, no further investigation is necessary on your part. 4345f436cfbSKazutaka YOKOTAYou may start the daemon without explicitly specifying a protocol type 4355f436cfbSKazutaka YOKOTA.Pq see Sx EXAMPLE . 4365f436cfbSKazutaka YOKOTA.Pp 4375f436cfbSKazutaka YOKOTAThe command may print 4385f436cfbSKazutaka YOKOTA.Ar sysmouse 4395f436cfbSKazutaka YOKOTAif the mouse driver supports this protocol type. 4405f436cfbSKazutaka YOKOTA.Pp 4415f436cfbSKazutaka YOKOTANote that the 4425f436cfbSKazutaka YOKOTA.Dv type 4435f436cfbSKazutaka YOKOTAand 4445f436cfbSKazutaka YOKOTA.Dv model 4455f436cfbSKazutaka YOKOTAprinted by the 4465f436cfbSKazutaka YOKOTA.Fl i 4475f436cfbSKazutaka YOKOTAoption do not necessarily match the product name of the pointing device 4485f436cfbSKazutaka YOKOTAin question, but they may give the name of the device with which it is 4495f436cfbSKazutaka YOKOTAcompatible. 4505f436cfbSKazutaka YOKOTA.Pp 4515f436cfbSKazutaka YOKOTAIf the 4525f436cfbSKazutaka YOKOTA.Fl i 4535f436cfbSKazutaka YOKOTAoption yields nothing, you need to specify a protocol type to the 4545f436cfbSKazutaka YOKOTA.Nm 4555f436cfbSKazutaka YOKOTAcommand by the 4565f436cfbSKazutaka YOKOTA.Fl t 457f2e366a1SSheldon Hearnoption. 458f2e366a1SSheldon HearnYou have to make a guess and try. 4595f436cfbSKazutaka YOKOTAThere is rule of thumb: 4605f436cfbSKazutaka YOKOTA.Pp 4615f436cfbSKazutaka YOKOTA.Bl -tag -compact -width 1.X 4625f436cfbSKazutaka YOKOTA.It 1. 4635f436cfbSKazutaka YOKOTAThe bus and InPort mice always use 4645f436cfbSKazutaka YOKOTA.Ar busmouse 4655f436cfbSKazutaka YOKOTAprotocol regardless of the brand of the mouse. 4665f436cfbSKazutaka YOKOTA.It 2. 4675f436cfbSKazutaka YOKOTAThe 4685f436cfbSKazutaka YOKOTA.Ar ps/2 4695f436cfbSKazutaka YOKOTAprotocol should always be specified for the PS/2 mouse 4705f436cfbSKazutaka YOKOTAregardless of the brand of the mouse. 4715f436cfbSKazutaka YOKOTA.It 3. 472045c8108SKazutaka YOKOTAYou must specify the 473045c8108SKazutaka YOKOTA.Ar auto 474045c8108SKazutaka YOKOTAprotocol for the USB mouse. 475045c8108SKazutaka YOKOTA.It 4. 4765f436cfbSKazutaka YOKOTAMost 2-button serial mice support the 4775f436cfbSKazutaka YOKOTA.Ar microsoft 4785f436cfbSKazutaka YOKOTAprotocol. 479045c8108SKazutaka YOKOTA.It 5. 4805f436cfbSKazutaka YOKOTA3-button serial mice may work with the 4815f436cfbSKazutaka YOKOTA.Ar mousesystems 482f2e366a1SSheldon Hearnprotocol. 483f2e366a1SSheldon HearnIf it doesn't, it may work with the 4845f436cfbSKazutaka YOKOTA.Ar microsoft 4855f436cfbSKazutaka YOKOTAprotocol although 4865f436cfbSKazutaka YOKOTAthe third (middle) button won't function. 4875f436cfbSKazutaka YOKOTA3-button serial mice may also work with the 4885f436cfbSKazutaka YOKOTA.Ar mouseman 4895f436cfbSKazutaka YOKOTAprotocol under which the third button may function as expected. 490045c8108SKazutaka YOKOTA.It 6. 4915f436cfbSKazutaka YOKOTA3-button serial mice may have a small switch to choose between ``MS'' 4925f436cfbSKazutaka YOKOTAand ``PC'', or ``2'' and ``3''. 4935f436cfbSKazutaka YOKOTA``MS'' or ``2'' usually mean the 4945f436cfbSKazutaka YOKOTA.Ar microsoft 4955f436cfbSKazutaka YOKOTAprotocol. 4965f436cfbSKazutaka YOKOTA``PC'' or ``3'' will choose the 4975f436cfbSKazutaka YOKOTA.Ar mousesystems 4985f436cfbSKazutaka YOKOTAprotocol. 499045c8108SKazutaka YOKOTA.It 7. 5005f436cfbSKazutaka YOKOTAIf the mouse has a roller or a wheel, it may be compatible with the 5015f436cfbSKazutaka YOKOTA.Ar intellimouse 5025f436cfbSKazutaka YOKOTAprotocol. 5035f436cfbSKazutaka YOKOTA.El 5045f436cfbSKazutaka YOKOTA.Pp 5055f436cfbSKazutaka YOKOTATo test if the selected protocol type is correct for the given mouse, 5065f436cfbSKazutaka YOKOTAenable the mouse pointer in the current virtual console, 5075f436cfbSKazutaka YOKOTA.Pp 5085f436cfbSKazutaka YOKOTA.Dl vidcontrol -m on 5095f436cfbSKazutaka YOKOTA.Pp 5105f436cfbSKazutaka YOKOTAstart the mouse daemon in the foreground mode, 5115f436cfbSKazutaka YOKOTA.Pp 5125f436cfbSKazutaka YOKOTA.Dl moused -f -p Ar _selected_port_ -t Ar _selected_protocol_ 5135f436cfbSKazutaka YOKOTA.Pp 5145f436cfbSKazutaka YOKOTAand see if the mouse pointer travels correctly 515f2e366a1SSheldon Hearnaccording to the mouse movement. 516f2e366a1SSheldon HearnThen try cut & paste features by 517f2e366a1SSheldon Hearnclicking the left, right and middle buttons. 518f2e366a1SSheldon HearnType ^C to stop 5195f436cfbSKazutaka YOKOTAthe command. 5205f436cfbSKazutaka YOKOTA.Ss Multiple Mice 5215f436cfbSKazutaka YOKOTAAs many instances of the mouse daemon as the number of mice attached to 5225f436cfbSKazutaka YOKOTAthe system may be run simultaneously; one 5235f436cfbSKazutaka YOKOTAinstance for each mouse. 5245f436cfbSKazutaka YOKOTAThis is useful if the user wants to use the built-in PS/2 pointing device 5255f436cfbSKazutaka YOKOTAof a laptop computer while on the road, but wants to use a serial 5265f436cfbSKazutaka YOKOTAmouse when s/he attaches the system to the docking station in the office. 5275f436cfbSKazutaka YOKOTARun two mouse daemons and tell the application program 5285f436cfbSKazutaka YOKOTA.Pq such as the X Window System 5295f436cfbSKazutaka YOKOTAto use 5305f436cfbSKazutaka YOKOTA.Xr sysmouse , 5315f436cfbSKazutaka YOKOTAthen the application program will always see mouse data from either mice. 5325f436cfbSKazutaka YOKOTAWhen the serial mouse is not attached, the corresponding mouse daemon 5335f436cfbSKazutaka YOKOTAwon't detect any movement or button state change and the application 5345f436cfbSKazutaka YOKOTAprogram will only see mouse data coming from the daemon for the 535f2e366a1SSheldon HearnPS/2 mouse. 536f2e366a1SSheldon HearnIn contrast when both mice are attached and both of them 5375f436cfbSKazutaka YOKOTAare moved at the same time in this configuration, 5385f436cfbSKazutaka YOKOTAthe mouse pointer will travel across the screen just as if movement of 5395f436cfbSKazutaka YOKOTAthe mice is combined all together. 5405f436cfbSKazutaka YOKOTA.Sh FILES 5415f436cfbSKazutaka YOKOTA.Bl -tag -width /dev/consolectl -compact 5425f436cfbSKazutaka YOKOTA.It Pa /dev/consolectl 5435f436cfbSKazutaka YOKOTAdevice to control the console 5445f436cfbSKazutaka YOKOTA.It Pa /dev/mse%d 5455f436cfbSKazutaka YOKOTAbus and InPort mouse driver 5465f436cfbSKazutaka YOKOTA.It Pa /dev/psm%d 5475f436cfbSKazutaka YOKOTAPS/2 mouse driver 5485f436cfbSKazutaka YOKOTA.It Pa /dev/sysmouse 5495f436cfbSKazutaka YOKOTAvirtualized mouse driver 5505f436cfbSKazutaka YOKOTA.It Pa /dev/ttyv%d 5515f436cfbSKazutaka YOKOTAvirtual consoles 552045c8108SKazutaka YOKOTA.It Pa /dev/ums%d 553045c8108SKazutaka YOKOTAUSB mouse driver 554f82812a2SKazutaka YOKOTA.It Pa /var/run/moused.pid 555f82812a2SKazutaka YOKOTAprocess id of the currently running 556f82812a2SKazutaka YOKOTA.Nm 557f82812a2SKazutaka YOKOTAdaemon 55867978692SAmancio Hasty.It Pa /var/run/MouseRemote 55967978692SAmancio HastyUNIX-domain stream socket for X10 MouseRemote events 56094a804c5SMike Pritchard.El 561bf29452fSWolfram Schneider.Sh EXAMPLE 562bf29452fSWolfram Schneider.Pp 5635f436cfbSKazutaka YOKOTA.Dl moused -p /dev/cuaa0 -i type 5645f436cfbSKazutaka YOKOTA.Pp 5655f436cfbSKazutaka YOKOTALet the 5665f436cfbSKazutaka YOKOTA.Nm 5675f436cfbSKazutaka YOKOTAcommand determine the protocol type of the mouse at the serial port 5685f436cfbSKazutaka YOKOTA.Pa /dev/cuaa0 . 5695f436cfbSKazutaka YOKOTAIf successful, the command will print the type, otherwise it will say 5705f436cfbSKazutaka YOKOTA``unknown''. 5715f436cfbSKazutaka YOKOTA.Pp 5725f436cfbSKazutaka YOKOTA.Dl moused -p /dev/cuaa0 573bf29452fSWolfram Schneider.Dl vidcontrol -m on 574bf29452fSWolfram Schneider.Pp 5755f436cfbSKazutaka YOKOTAIf the 5765f436cfbSKazutaka YOKOTA.Nm 5775f436cfbSKazutaka YOKOTAcommand is able to identify the protocol type of the mouse at the specified 5785f436cfbSKazutaka YOKOTAport automatically, you can start the daemon without the 5795f436cfbSKazutaka YOKOTA.Fl t 5805f436cfbSKazutaka YOKOTAoption and enable the mouse pointer in the text console as above. 5815f436cfbSKazutaka YOKOTA.Pp 5825f436cfbSKazutaka YOKOTA.Dl moused -p /dev/mouse -t microsoft 5835f436cfbSKazutaka YOKOTA.Dl vidcontrol -m on 5845f436cfbSKazutaka YOKOTA.Pp 5855f436cfbSKazutaka YOKOTAStart the mouse daemon on the serial port 5865f436cfbSKazutaka YOKOTA.Pa /dev/mouse . 5875f436cfbSKazutaka YOKOTAThe protocol type 5885f436cfbSKazutaka YOKOTA.Ar microsoft 5895f436cfbSKazutaka YOKOTAis explicitly specified by the 5905f436cfbSKazutaka YOKOTA.Fl t 5915f436cfbSKazutaka YOKOTAoption. 5925f436cfbSKazutaka YOKOTA.Pp 5935f436cfbSKazutaka YOKOTA.Dl moused -p /dev/mouse -m 1=3 -m 3=1 5945f436cfbSKazutaka YOKOTA.Pp 5955f436cfbSKazutaka YOKOTAAssign the physical button 3 (right button) to the logical button 1 5965f436cfbSKazutaka YOKOTA(logical left) and the physical button 1 (left) to the logical 5975f436cfbSKazutaka YOKOTAbutton 3 (logical right). 5985f436cfbSKazutaka YOKOTAThis will effectively swap the left and right buttons. 5995f436cfbSKazutaka YOKOTA.Pp 6005f436cfbSKazutaka YOKOTA.Dl moused -p /dev/mouse -t intellimouse -z 4 6015f436cfbSKazutaka YOKOTA.Pp 6025f436cfbSKazutaka YOKOTAReport negative Z axis (roller) movement as the button 4 pressed 6035f436cfbSKazutaka YOKOTAand positive Z axis movement as the button 5 pressed. 6045f436cfbSKazutaka YOKOTA.Sh CAVEATS 6055f436cfbSKazutaka YOKOTAThe 6065f436cfbSKazutaka YOKOTA.Nm 6075f436cfbSKazutaka YOKOTAcommand does not currently work with the alternative console driver 6085f436cfbSKazutaka YOKOTA.Xr pcvt 4 . 6095f436cfbSKazutaka YOKOTA.Pp 6105f436cfbSKazutaka YOKOTAMany pad devices behave as if the first (left) button were pressed if 6115f436cfbSKazutaka YOKOTAthe user `taps' the surface of the pad. 6122e09fb67SKazutaka YOKOTAIn contrast, some ALPS GlidePoint and Interlink VersaPad models 6132e09fb67SKazutaka YOKOTAtreat the tapping action 614f2e366a1SSheldon Hearnas fourth button events. 615f2e366a1SSheldon HearnUse the option ``-m 1=4'' for these models 6165f436cfbSKazutaka YOKOTAto obtain the same effect as the other pad devices. 617851c9886SKazutaka YOKOTA.Pp 618851c9886SKazutaka YOKOTACut and paste functions in the virtual console assume that there 619851c9886SKazutaka YOKOTAare three buttons on the mouse. 620851c9886SKazutaka YOKOTAThe logical button 1 (logical left) selects a region of text in the 621851c9886SKazutaka YOKOTAconsole and copies it to the cut buffer. 622851c9886SKazutaka YOKOTAThe logical button 3 (logical right) extends the selected region. 623851c9886SKazutaka YOKOTAThe logical button 2 (logical middle) pastes the selected text 624851c9886SKazutaka YOKOTAat the text cursor position. 625851c9886SKazutaka YOKOTAIf the mouse has only two buttons, the middle, `paste' button 626851c9886SKazutaka YOKOTAis not available. 627851c9886SKazutaka YOKOTATo obtain the paste function, use the 628851c9886SKazutaka YOKOTA.Fl 3 629851c9886SKazutaka YOKOTAoption to emulate the middle button, or use the 630851c9886SKazutaka YOKOTA.Fl m 631851c9886SKazutaka YOKOTAoption to assign the physical right button to the logical middle button: 632851c9886SKazutaka YOKOTA``-m 2=3''. 63394a804c5SMike Pritchard.Sh SEE ALSO 6345f436cfbSKazutaka YOKOTA.Xr kill 1 , 6355cf470d6SWolfram Schneider.Xr vidcontrol 1 , 63694a804c5SMike Pritchard.Xr keyboard 4 , 6375f436cfbSKazutaka YOKOTA.Xr mse 4 , 63894a804c5SMike Pritchard.Xr pcvt 4 , 6395f436cfbSKazutaka YOKOTA.Xr psm 4 , 640b7d50183SWolfram Schneider.Xr screen 4 , 641045c8108SKazutaka YOKOTA.Xr sysmouse 4 , 642045c8108SKazutaka YOKOTA.Xr ums 4 6435f436cfbSKazutaka YOKOTA.Sh STANDARD 6445f436cfbSKazutaka YOKOTAThe 6455f436cfbSKazutaka YOKOTA.Nm 64679d8f01cSAlexey Zelkincommand partially supports 64779d8f01cSAlexey Zelkin.Dq Plug and Play External COM Device Specification 6485f436cfbSKazutaka YOKOTAin order to support PnP serial mice. 6495f436cfbSKazutaka YOKOTAHowever, due to various degrees of conformance to the specification by 6505f436cfbSKazutaka YOKOTAexisting serial mice, it does not strictly follow the version 1.0 of the 651f2e366a1SSheldon Hearnstandard. 652f2e366a1SSheldon HearnEven with this less strict approach, 6535f436cfbSKazutaka YOKOTAit may not always determine an appropriate protocol type 6545f436cfbSKazutaka YOKOTAfor the given serial mouse. 65594a804c5SMike Pritchard.Sh AUTHORS 65694a804c5SMike PritchardThe 65794a804c5SMike Pritchard.Nm 65807e1d533SPhilippe Charniercommand was written by 6592dcf9f10SSteve Price.An Michael Smith Aq msmith@FreeBSD.org . 6605f436cfbSKazutaka YOKOTAThis manual page was written by 66107e1d533SPhilippe Charnier.An Mike Pritchard Aq mpp@FreeBSD.org . 6622dcf9f10SSteve PriceThe command and manual page have since been updated by 6632dcf9f10SSteve Price.An Kazutaka Yokota Aq yokota@FreeBSD.org . 66494a804c5SMike Pritchard.Sh HISTORY 66594a804c5SMike PritchardThe 66607e1d533SPhilippe Charnier.Nm 66794a804c5SMike Pritchardcommand first appeared in 66894a804c5SMike Pritchard.Fx 2.2 . 669