head 1.8; access; symbols netbsd-9-4-RELEASE:1.8 netbsd-10-0-RELEASE:1.8 netbsd-10-0-RC6:1.8 netbsd-10-0-RC5:1.8 netbsd-10-0-RC4:1.8 netbsd-10-0-RC3:1.8 netbsd-10-0-RC2:1.8 netbsd-10-0-RC1:1.8 netbsd-10:1.8.0.100 netbsd-10-base:1.8 netbsd-9-3-RELEASE:1.8 cjep_sun2x-base1:1.8 cjep_sun2x:1.8.0.98 cjep_sun2x-base:1.8 cjep_staticlib_x-base1:1.8 netbsd-9-2-RELEASE:1.8 cjep_staticlib_x:1.8.0.96 cjep_staticlib_x-base:1.8 netbsd-9-1-RELEASE:1.8 phil-wifi-20200421:1.8 phil-wifi-20200411:1.8 is-mlppp:1.8.0.94 is-mlppp-base:1.8 phil-wifi-20200406:1.8 netbsd-8-2-RELEASE:1.8 netbsd-9-0-RELEASE:1.8 netbsd-9-0-RC2:1.8 netbsd-9-0-RC1:1.8 phil-wifi-20191119:1.8 netbsd-9:1.8.0.92 netbsd-9-base:1.8 phil-wifi-20190609:1.8 netbsd-8-1-RELEASE:1.8 netbsd-8-1-RC1:1.8 pgoyette-compat-merge-20190127:1.8 pgoyette-compat-20190127:1.8 pgoyette-compat-20190118:1.8 pgoyette-compat-1226:1.8 pgoyette-compat-1126:1.8 pgoyette-compat-1020:1.8 pgoyette-compat-0930:1.8 pgoyette-compat-0906:1.8 netbsd-7-2-RELEASE:1.8 pgoyette-compat-0728:1.8 netbsd-8-0-RELEASE:1.8 phil-wifi:1.8.0.90 phil-wifi-base:1.8 pgoyette-compat-0625:1.8 netbsd-8-0-RC2:1.8 pgoyette-compat-0521:1.8 pgoyette-compat-0502:1.8 pgoyette-compat-0422:1.8 netbsd-8-0-RC1:1.8 pgoyette-compat-0415:1.8 pgoyette-compat-0407:1.8 pgoyette-compat-0330:1.8 pgoyette-compat-0322:1.8 pgoyette-compat-0315:1.8 netbsd-7-1-2-RELEASE:1.8 pgoyette-compat:1.8.0.88 pgoyette-compat-base:1.8 netbsd-7-1-1-RELEASE:1.8 matt-nb8-mediatek:1.8.0.86 matt-nb8-mediatek-base:1.8 perseant-stdc-iso10646:1.8.0.84 perseant-stdc-iso10646-base:1.8 netbsd-8:1.8.0.82 netbsd-8-base:1.8 prg-localcount2-base3:1.8 prg-localcount2-base2:1.8 prg-localcount2-base1:1.8 prg-localcount2:1.8.0.80 prg-localcount2-base:1.8 pgoyette-localcount-20170426:1.8 bouyer-socketcan-base1:1.8 pgoyette-localcount-20170320:1.8 netbsd-7-1:1.8.0.78 netbsd-7-1-RELEASE:1.8 netbsd-7-1-RC2:1.8 netbsd-7-nhusb-base-20170116:1.8 bouyer-socketcan:1.8.0.76 bouyer-socketcan-base:1.8 pgoyette-localcount-20170107:1.8 netbsd-7-1-RC1:1.8 pgoyette-localcount-20161104:1.8 netbsd-7-0-2-RELEASE:1.8 localcount-20160914:1.8 netbsd-7-nhusb:1.8.0.74 netbsd-7-nhusb-base:1.8 pgoyette-localcount-20160806:1.8 pgoyette-localcount-20160726:1.8 pgoyette-localcount:1.8.0.72 pgoyette-localcount-base:1.8 netbsd-7-0-1-RELEASE:1.8 netbsd-7-0:1.8.0.70 netbsd-7-0-RELEASE:1.8 netbsd-7-0-RC3:1.8 netbsd-7-0-RC2:1.8 netbsd-7-0-RC1:1.8 netbsd-5-2-3-RELEASE:1.8 netbsd-5-1-5-RELEASE:1.8 netbsd-6-0-6-RELEASE:1.8 netbsd-6-1-5-RELEASE:1.8 netbsd-7:1.8.0.68 netbsd-7-base:1.8 yamt-pagecache-base9:1.8 yamt-pagecache-tag8:1.8 netbsd-6-1-4-RELEASE:1.8 netbsd-6-0-5-RELEASE:1.8 tls-earlyentropy:1.8.0.66 tls-earlyentropy-base:1.8 riastradh-xf86-video-intel-2-7-1-pre-2-21-15:1.8 riastradh-drm2-base3:1.8 netbsd-6-1-3-RELEASE:1.8 netbsd-6-0-4-RELEASE:1.8 netbsd-5-2-2-RELEASE:1.8 netbsd-5-1-4-RELEASE:1.8 netbsd-6-1-2-RELEASE:1.8 netbsd-6-0-3-RELEASE:1.8 netbsd-5-2-1-RELEASE:1.8 netbsd-5-1-3-RELEASE:1.8 netbsd-6-1-1-RELEASE:1.8 riastradh-drm2-base2:1.8 riastradh-drm2-base1:1.8 riastradh-drm2:1.8.0.60 riastradh-drm2-base:1.8 netbsd-6-1:1.8.0.64 netbsd-6-0-2-RELEASE:1.8 netbsd-6-1-RELEASE:1.8 netbsd-6-1-RC4:1.8 netbsd-6-1-RC3:1.8 agc-symver:1.8.0.62 agc-symver-base:1.8 netbsd-6-1-RC2:1.8 netbsd-6-1-RC1:1.8 yamt-pagecache-base8:1.8 netbsd-5-2:1.8.0.58 netbsd-6-0-1-RELEASE:1.8 yamt-pagecache-base7:1.8 netbsd-5-2-RELEASE:1.8 netbsd-5-2-RC1:1.8 matt-nb6-plus-nbase:1.8 yamt-pagecache-base6:1.8 netbsd-6-0:1.8.0.56 netbsd-6-0-RELEASE:1.8 netbsd-6-0-RC2:1.8 tls-maxphys:1.8.0.54 tls-maxphys-base:1.8 matt-nb6-plus:1.8.0.52 matt-nb6-plus-base:1.8 netbsd-6-0-RC1:1.8 yamt-pagecache-base5:1.8 yamt-pagecache-base4:1.8 netbsd-6:1.8.0.50 netbsd-6-base:1.8 netbsd-5-1-2-RELEASE:1.8 netbsd-5-1-1-RELEASE:1.8 yamt-pagecache-base3:1.8 yamt-pagecache-base2:1.8 yamt-pagecache:1.8.0.48 yamt-pagecache-base:1.8 cherry-xenmp:1.8.0.46 cherry-xenmp-base:1.8 bouyer-quota2-nbase:1.8 bouyer-quota2:1.8.0.44 bouyer-quota2-base:1.8 matt-mips64-premerge-20101231:1.8 matt-nb5-mips64-premerge-20101231:1.8 matt-nb5-pq3:1.8.0.42 matt-nb5-pq3-base:1.8 netbsd-5-1:1.8.0.40 netbsd-5-1-RELEASE:1.8 netbsd-5-1-RC4:1.8 matt-nb5-mips64-k15:1.8 netbsd-5-1-RC3:1.8 netbsd-5-1-RC2:1.8 netbsd-5-1-RC1:1.8 netbsd-5-0-2-RELEASE:1.8 matt-nb5-mips64-premerge-20091211:1.8 matt-premerge-20091211:1.8 matt-nb5-mips64-u2-k2-k4-k7-k8-k9:1.8 matt-nb4-mips64-k7-u2a-k9b:1.8 matt-nb5-mips64-u1-k1-k5:1.8 matt-nb5-mips64:1.8.0.38 netbsd-5-0-1-RELEASE:1.8 jym-xensuspend-nbase:1.8 netbsd-5-0:1.8.0.36 netbsd-5-0-RELEASE:1.8 netbsd-5-0-RC4:1.8 netbsd-5-0-RC3:1.8 netbsd-5-0-RC2:1.8 jym-xensuspend:1.8.0.34 jym-xensuspend-base:1.8 netbsd-5-0-RC1:1.8 netbsd-5:1.8.0.32 netbsd-5-base:1.8 matt-mips64-base2:1.8 matt-mips64:1.8.0.30 mjf-devfs2:1.8.0.28 mjf-devfs2-base:1.8 netbsd-4-0-1-RELEASE:1.8 wrstuden-revivesa-base-3:1.8 wrstuden-revivesa-base-2:1.8 wrstuden-fixsa-newbase:1.8 wrstuden-revivesa-base-1:1.8 yamt-pf42-base4:1.8 yamt-pf42-base3:1.8 hpcarm-cleanup-nbase:1.8 yamt-pf42-baseX:1.8 yamt-pf42-base2:1.8 wrstuden-revivesa:1.8.0.26 wrstuden-revivesa-base:1.8 yamt-pf42:1.8.0.24 yamt-pf42-base:1.8 keiichi-mipv6-nbase:1.8 keiichi-mipv6:1.8.0.22 keiichi-mipv6-base:1.8 matt-armv6-nbase:1.8 matt-armv6-prevmlocking:1.8 wrstuden-fixsa-base-1:1.8 netbsd-4-0:1.8.0.20 netbsd-4-0-RELEASE:1.8 cube-autoconf:1.8.0.18 cube-autoconf-base:1.8 netbsd-4-0-RC5:1.8 netbsd-4-0-RC4:1.8 netbsd-4-0-RC3:1.8 netbsd-4-0-RC2:1.8 netbsd-4-0-RC1:1.8 matt-armv6:1.8.0.16 matt-armv6-base:1.8 matt-mips64-base:1.8 hpcarm-cleanup:1.8.0.14 hpcarm-cleanup-base:1.8 netbsd-3-1-1-RELEASE:1.8 netbsd-3-0-3-RELEASE:1.8 wrstuden-fixsa:1.8.0.12 wrstuden-fixsa-base:1.8 abandoned-netbsd-4-base:1.8 abandoned-netbsd-4:1.8.0.6 netbsd-3-1:1.8.0.8 netbsd-3-1-RELEASE:1.8 netbsd-3-0-2-RELEASE:1.8 netbsd-3-1-RC4:1.8 netbsd-3-1-RC3:1.8 netbsd-3-1-RC2:1.8 netbsd-3-1-RC1:1.8 netbsd-4:1.8.0.10 netbsd-4-base:1.8 netbsd-3-0-1-RELEASE:1.8 netbsd-3-0:1.8.0.4 netbsd-3-0-RELEASE:1.8 netbsd-3-0-RC6:1.8 netbsd-3-0-RC5:1.8 netbsd-3-0-RC4:1.8 netbsd-3-0-RC3:1.8 netbsd-3-0-RC2:1.8 netbsd-3-0-RC1:1.8 netbsd-2-0-3-RELEASE:1.7.2.1 netbsd-2-1:1.7.2.1.0.4 netbsd-2-1-RELEASE:1.7.2.1 netbsd-2-1-RC6:1.7.2.1 netbsd-2-1-RC5:1.7.2.1 netbsd-2-1-RC4:1.7.2.1 netbsd-2-1-RC3:1.7.2.1 netbsd-2-1-RC2:1.7.2.1 netbsd-2-1-RC1:1.7.2.1 netbsd-2-0-2-RELEASE:1.7.2.1 netbsd-3:1.8.0.2 netbsd-3-base:1.8 netbsd-2-0-1-RELEASE:1.7.2.1 netbsd-2:1.7.2.1.0.2 netbsd-2-base:1.7.2.1 netbsd-2-0-RELEASE:1.7.2.1 netbsd-2-0-RC5:1.7.2.1 netbsd-2-0-RC4:1.7.2.1 netbsd-2-0-RC3:1.7.2.1 netbsd-2-0-RC2:1.7.2.1 netbsd-2-0-RC1:1.7.2.1 netbsd-2-0:1.7.0.2 netbsd-2-0-base:1.7; locks; strict; comment @.\" @; 1.8 date 2004.03.31.11.15.36; author jmmv; state Exp; branches; next 1.7; 1.7 date 2004.01.05.12.16.25; author jmmv; state Exp; branches 1.7.2.1; next 1.6; 1.6 date 2004.01.05.10.59.19; author jmmv; state Exp; branches; next 1.5; 1.5 date 2003.08.06.22.11.50; author jmmv; state Exp; branches; next 1.4; 1.4 date 2003.08.06.18.07.53; author jmmv; state Exp; branches; next 1.3; 1.3 date 2003.03.04.22.31.15; author jmmv; state Exp; branches; next 1.2; 1.2 date 2003.03.04.14.38.25; author jmmv; state Exp; branches; next 1.1; 1.1 date 2003.03.04.14.33.55; author jmmv; state Exp; branches; next ; 1.7.2.1 date 2004.04.01.02.26.08; author jmc; state Exp; branches; next ; desc @@ 1.8 log @Fix two typos, reported as part of PR bin/22581. @ text @.\" $NetBSD: wsmoused.conf.5,v 1.7 2004/01/05 12:16:25 jmmv Exp $ .\" .\" Copyright (c) 2003, 2004 The NetBSD Foundation, Inc. .\" All rights reserved. .\" .\" This code is derived from software contributed to The NetBSD Foundation .\" by Julio M. Merino Vidal. .\" .\" Redistribution and use in source and binary forms, with or without .\" modification, are permitted provided that the following conditions .\" are met: .\" 1. Redistributions of source code must retain the above copyright .\" notice, this list of conditions and the following disclaimer. .\" 2. Neither the name of The NetBSD Foundation nor the names of its .\" contributors may be used to endorse or promote products derived .\" from this software without specific prior written permission. .\" .\" THIS SOFTWARE IS PROVIDED BY THE NETBSD FOUNDATION, INC. AND CONTRIBUTORS .\" ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED .\" TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR .\" PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE FOUNDATION OR CONTRIBUTORS .\" BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR .\" CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF .\" SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS .\" INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN .\" CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) .\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE .\" POSSIBILITY OF SUCH DAMAGE. .\" .Dd January 5, 2004 .Dt WSMOUSED.CONF 5 .Os .Sh NAME .Nm wsmoused.conf .Nd multipurpose mouse daemon configuration .Sh SYNOPSIS .Nm .Sh DESCRIPTION The .Nm file configures all the features provided by the .Xr wsmoused 8 daemon. It is composed by a series of .Em blocks , each of which defines a group of .Em properties . The file format is free-form: new line markers are ignored as well as indentation. Comments start with the .Sq # sign and extend until the end of line. .Pp A .Em property is like a variable assignment. It has a name, which goes to the left of the equal sign, and a value, which goes to the right. The assignment ends with a semicolon. It looks like: .Pp .Dl name = value; .Pp There is no difference between string or integer values when defining them. The value must be surrounded by double quotes if it contains whitespace. Booleans are specified as integers, where .Sq 0 means false and .Sq 1 stands for true. Even though, the program cares about this and will emit a warning if you have done an incorrect assignment. Note that it will not accept unrecognized names. .Pp A .Em mode is a type of block that defines how the program behaves when run in a specific mode. A mode inherits properties defined in the global scope. It has the following syntax: .Bd -literal -offset indent mode mode_name { property1 = value1; ... propertyN = valueN; } .Ed .Pp There are two recognized modes, .Ql action and .Ql selection . .Xr wsmoused 8 describes what they do in detail. .Ss Properties common to all modes The following properties can be defined in the global scope, thus affecting all modes, or inside the mode definition, to override global values. .Bl -tag -width indent .It device = pathname; The .Xr wsmouse 4 device name to use. Defaults to .Pa /dev/wsmouse . .It fifo = pathname; Specify an optional fifo where to redirect all mouse events, no matter if they have been processed. By default, no fifo is used. .It modes = string; Whitespace separated list of modes to be activated when running. Defaults to .Sq selection . .It nodaemon = boolean; Set to 1 to not fork in the background. .It pidfile = basename; The basename of the pidfile used to control the process. Pidfiles are always created under .Pa /var/run , and have the .Sq .pid extension automatically added. By default it is set to daemon's program name. .It ttystat = pathname; .Xr wsdisplay 4 Ns 's notification device. Defaults to .Pa /dev/ttyEstat . You will not want to change this. .It xconsole = integer; Virtual console number which holds the X server (if any). The argument specifies the console number (the same found in .Pa /dev/ttyE? ) . Unset by default. .It xconsole_delay = integer; Number of seconds to wait before reactivating the mouse when returning from the X console (specified by the .Sq xconsole property). Defaults to 5. .El .Ss Properties specific to the action mode The following properties are only useful when running in the .Em action mode: .Bl -tag -width indent .It button__ = "command"; Assigns a command to a button, which will be executed using the .Xr system 3 call. The .Sq number part selects a button to which the command is assigned; the first button is numbered .Sq 0 and the maximum depends on the mouse type. The .Sq status part can be either .Sq down or .Sq up , representing the events emitted when the button is pressed and released, respectively. .El .Ss Properties specific to the selection mode The following properties are only useful when running in the .Em selection mode: .Bl -tag -width indent .It lefthanded = boolean; Set to 1 to swap mouse buttons, specially useful for left handed users. .It slowdown_x = integer; X axis slowdown. This positive integer specifies how many events in the vertical direction should be ignored before changing the current column. It defaults to 0. .It slowdown_y = integer; Y axis slowdown. This positive integer specifies how many events in the horizontal direction should be ignored before changing the current row. It defaults to 3. .El .Sh FILES .Bl -tag -width /usr/share/examples/wsmoused/ -compact .It Pa /etc/wsmoused.conf Default configuration file. .It Pa /usr/share/examples/wsmoused/ Location of sample files. .El .Sh SEE ALSO .Xr system 3 , .Xr wsdisplay 4 , .Xr wsmouse 4 , .Xr wsmoused 8 .Sh HISTORY The .Nm configuration file first appeared in .Nx 2.0 . @ 1.7 log @Add the xconsole_delay property which specifies the number of seconds to wait when returning from the X console before reactivating the mouse. Some systems may require more than the default (or may want less to get faster response). @ text @d1 1 a1 1 .\" $NetBSD: wsmoused.conf.5,v 1.6 2004/01/05 10:59:19 jmmv Exp $ d156 1 a156 1 and the maximun depends on the mouse type. d163 1 a163 1 representing the events emmited when the button is pressed and released, @ 1.7.2.1 log @Pullup rev 1.8 (requested by jmmv in ticket #29) Fix two typos. PR#22581 @ text @d1 1 a1 1 .\" $NetBSD: wsmoused.conf.5,v 1.7 2004/01/05 12:16:25 jmmv Exp $ d156 1 a156 1 and the maximum depends on the mouse type. d163 1 a163 1 representing the events emitted when the button is pressed and released, @ 1.6 log @fifo, ttystat and xconsole properties are generic (used by all modes), so move them to their respective section. Fixes part of PR bin/23223. @ text @d1 1 a1 1 .\" $NetBSD: wsmoused.conf.5,v 1.5 2003/08/06 22:11:50 jmmv Exp $ d135 6 @ 1.5 log @Add the `action' mode, which can be used to associate commands with mouse button events. This mode needs to be explicitly enabled at runtime, and does nothing if not configured. As there are now two different modes available, adjust the manpages accordingly, describing what they do and how they work separatedly. While here, remove a bunch of unused stuff (event syntax) from config file parsing. This was initially added with this new mode in mind, but it has not been used to make it a lot simpler. @ text @d1 1 a1 1 .\" $NetBSD: wsmoused.conf.5,v 1.4 2003/08/06 18:07:53 jmmv Exp $ d3 1 a3 1 .\" Copyright (c) 2003 The NetBSD Foundation, Inc. d30 1 a30 1 .Dd August 6, 2003 d106 4 d124 11 a164 4 .It fifo = pathname; Specify an optional fifo where to redirect all mouse events, no matter if they have been processed. By default, no fifo is used. a177 11 .It ttystat = pathname; .Xr wsdisplay 4 Ns 's notification device. Defaults to .Pa /dev/ttyEstat . You will not want to change this. .It xconsole = integer; Virtual console number which holds the X server (if any). The argument specifies the console number (the same found in .Pa /dev/ttyE? ) . Unset by default. @ 1.4 log @- Let the main program handle multiple run modes easily. Each one is described by a structure with pointers to functions. - Clearly separate the "selection" mode (which provides copy and paste support in console) from wsmoused's main program. - Added the "modes" property to the configuration file and the "-m" command line option to specify which modes should be activated. (this is mostly useless for now, as only the "selection" mode exists; a new mode will be added soon, hopefully). - While here, several style fixes according to share/misc/style. @ text @d1 1 a1 1 .\" $NetBSD: wsmoused.conf.5,v 1.3 2003/03/04 22:31:15 jmmv Exp $ d35 1 a35 1 .Nd mouse daemon configuration d89 6 a94 3 Actually, there is only one recognized mode, the .Ql selection mode. d121 24 d187 1 @ 1.3 log @Create a pidfile while running (which can be tuned with the new "pidfile" configuration variable). Ok'ed by christos. @ text @d1 1 a1 1 .\" $NetBSD: wsmoused.conf.5,v 1.2 2003/03/04 14:38:25 jmmv Exp $ d7 1 a7 1 .\" by Julio Merino. d30 1 a30 1 .Dd March 4, 2003 d61 1 d65 1 d90 1 a90 1 .Ql sel d103 4 d118 1 a118 1 .Ss Properties specific to the sel mode d120 1 a120 1 .Em sel @ 1.2 log @Configuration file is optional, as well as sections inside it. @ text @d1 1 a1 1 .\" $NetBSD: wsmoused.conf.5,v 1.1 2003/03/04 14:33:55 jmmv Exp $ d103 8 @ 1.1 log @Add support to parse a configuration file, /etc/wsmoused.conf by default. This file lets users tune the behavior of the daemon in a easy way, without having to mess with command line options (nor in rc.conf). It will also simplify future integration of new functionality within the program as multiple "modes" of operator are recognized. The new wsmoused.conf(5) manpage contains all related details. Some error message cleanup and minor manpage fixes too. Ok'ed by christos. @ text @d1 1 a1 1 .\" $NetBSD$ a86 4 In order to run .Xr wsmoused 8 in a specific mode, it must be defined in the configuration file, even if empty. @