xref: /freebsd/usr.sbin/moused/moused.8 (revision e68b10b3a06f282fbd005f84efec81557f6d2b95)
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