January 5, 2004 WSMOUSED.CONF 5

### NAME

wsmoused.conf - multipurpose mouse daemon configuration

### SYNOPSIS

wsmoused.conf

### DESCRIPTION

The wsmoused.conf file configures all the features provided by the wsmoused(8) daemon. It is composed by a series of blocks, each of which defines a group of properties. The file format is free-form: new line markers are ignored as well as indentation. Comments start with the `#' sign and extend until the end of line.

A 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:

```name``=``value;`

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 `0' means false and `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.

A 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:

  `

      mode mode_name {
              property1 = value1;
              ...
              propertyN = valueN;
      }

  `

There are two recognized modes, `action' and `selection'. wsmoused(8) describes what they do in detail.

#### 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.

device = pathname;
  The wsmouse(4) device name to use. Defaults to ```/dev/wsmouse`.

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.

modes = string;
  Whitespace separated list of modes to be activated when running. Defaults to `selection'.

nodaemon = boolean;
  Set to 1 to not fork in the background.

pidfile = basename;
  The basename of the pidfile used to control the process. Pidfiles are always created under ```/var/run`, and have the `.pid' extension automatically added. By default it is set to daemon's program name.

ttystat = pathname;
  wsdisplay(4)'s notification device. Defaults to ```/dev/ttyEstat`. You will not want to change this.

xconsole = integer;
  Virtual console number which holds the X server (if any). The argument specifies the console number (the same found in ```/dev/ttyE?`). Unset by default.

xconsole_delay = integer;
  Number of seconds to wait before reactivating the mouse when returning from the X console (specified by the `xconsole' property). Defaults to 5.

#### Properties specific to the action mode

The following properties are only useful when running in the action mode:

button__ = command
  ; Assigns a command to a button, which will be executed using the system(3) call. The `number' part selects a button to which the command is assigned; the first button is numbered `0' and the maximum depends on the mouse type. The `status' part can be either `down' or `up', representing the events emitted when the button is pressed and released, respectively.

#### Properties specific to the selection mode

The following properties are only useful when running in the selection mode:

lefthanded = boolean;
  Set to 1 to swap mouse buttons, specially useful for left handed users.

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.

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.

### FILES

```/etc/wsmoused.conf`
  Default configuration file.
```/usr/share/examples/wsmoused/`
  Location of sample files.

### SEE ALSO

system(3), wsdisplay(4), wsmouse(4), wsmoused(8)

### HISTORY

The wsmoused.conf configuration file first appeared in NetBSD2.0.