mouseconfig(8)                                     mouseconfig(8)

NAME
       mouseconfig - configure mouse for use under Linux

SYNOPSIS
       mouseconfig [--help] [--expert] [--noprobe] [--kickstart]
                   [--device  device]  [--emulthree]  [mousetype]
                [--test]

DESCRIPTION
       mouseconfig sets up the necessary configuration files  and
       file  links  to use a mouse on a Red Hat system. There are
       two modes of operation: interactive and kickstart.

       In interactive mode the user is prompted for the  type  of
       mouse attached to the system. Some of this information may
       be automatically probed and  filled  in.  If  --expert  is
       specified  then the user will have an opportunity to over-
       ride the probed values.  After changes to the  mouse  con-
       figuration  have  been  made, mouseconfig offers to modify
       the X server configuration to reflect the new settings.

       In kickstart mode, Xconfigurator will try to autoprobe all
       required  information,  non-interactively.  Mice on a PS/2
       type port will be found automatically.  Serial  mice  will
       usually be found, but the type of serial mouse cannot nor-
       mally be determined. The  user  can  use  the  <mousetype>
       option  to  force  mouseconfig  to  use a particular mouse
       type. Running mouseconfig --help will list the valid mouse
       types.

   OPTIONS
       --help Print  a  usage message on standard output and exit
              successfully.  Gives complete lists  of  the  mouse
              types recognized.

       --back Display  a  back  button on the first screen rather
              then the normal cancel button.

       --expert
              Gives the user manual control over some  parameters
              which are automatically satisfied in normal use.

       --noprobe
              No  probing  will  be  done  to  find attached mice
              devices.

       --kickstart
              Tells Xconfigurator to run in non-interactive mode,
              filling  in as much information as posible by prob-
              ing for a mouse. If no mouse is found, a  Microsoft
              mouse on /dev/ttyS0 is assumed.

       --device <port>
              Specifies  the  hardware  port  to use in kickstart
              mode.  One of "ttyS0", "ttyS1",  "ttyS2",  "ttyS3",
              or  "psaux"  normally.  mouseconfig should normally
              be able to probe this information.

       --emulthree
              Specifies that X11 should cause a two button  mouse
              to  emulate  a three button mouse when both buttons
              are pressed together. Use only for two button mice.

       --test Lets  mouseconfig  be  run  by a non-root user, and
              doesn't attempt to save the new configuration.

       <mousetype>
              Specifies the mouse type to use in kickstart  mode.
              PS/2  type  mice are probed automatically, but if a
              non-Microsoft compatible serial mouse is  connected
              then this argument is required.  mouseconfig --help
              will list the valid types of mice.

RETURN CODES
       mouseconfig returns 0 on success, 2 on error, and 1 if the
       user  cancelled the program (by using either the Cancel or
       Back button).

FILES
       /etc/sysconfig/mouse
                           Specifies the mouse type, and  whether
                           3 button emulation should be used.

       /dev/mouse          Symlink  pointing  to  the device file
                           for the mouse.

                         Tue Mar 30 1999                        1