Home | History | Annotate | Line # | Download | only in wsmoused
wsmoused.conf.5 revision 1.1 
 $NetBSD: wsmoused.conf.5,v 1.1 2003/03/04 14:33:55 jmmv Exp $

 Copyright (c) 2003 The NetBSD Foundation, Inc.
 All rights reserved.

 This code is derived from software contributed to The NetBSD Foundation
 by Julio Merino.

 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 March 4, 2003
.Dt WSMOUSED.CONF 5
.Os
.Sh NAME
.Nm wsmoused.conf
.Nd 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.

p
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:
.Dl name = value;

p
There is no difference between string or integer values when defining them.
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.

p
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:
d -literal -offset indent mode mode_name {
 property1 = value1;
 ...
 propertyN = valueN;
}
.Ed

p
In order to run
.Xr wsmoused 8
in a specific mode, it must be defined in the configuration file, even
if empty.
Actually, there is only one recognized mode, the
.Ql sel
mode.
.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.
l -tag -width indent t device = pathname; The
.Xr wsmouse 4
device name to use.
Defaults to

a /dev/wsmouse .
t nodaemon = boolean; Set to 1 to not fork in the background.
.El
.Ss Properties specific to the sel mode
The following properties are only useful when running in the
.Em sel
mode:
l -tag -width indent t 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.
t lefthanded = boolean; Set to 1 to swap mouse buttons, specially useful for left handed users.
t 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.
t 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.
t ttystat = pathname; .Xr wsdisplay 4 Ns 's
notification device.
Defaults to

a /dev/ttyEstat .
You will not want to change this.
t xconsole = integer; Virtual console number which holds the X server (if any).
The argument specifies the console number (the same found in

a /dev/ttyE? ) .
Unset by default.
.El
.Sh FILES
l -tag -width /usr/share/examples/wsmoused/ -compact t Pa /etc/wsmoused.conf Default configuration file.
t Pa /usr/share/examples/wsmoused/ Location of sample files.
.El
.Sh SEE ALSO
.Xr wsdisplay 4 ,
.Xr wsmouse 4 ,
.Xr wsmoused 8
.Sh HISTORY
The
.Nm
configuration file first appeared in
.Nx 2.0 .