System administration command. Provide a mouse server and cut-and-paste utility for use on the Linux console. gpm acts like a daemon, responding to both mouse events and client input. If no clients are connected to the active console, gpm provides cut-and-paste services.
Force two buttons. If there is a middle button, it is treated as the right button.
Force three buttons. With a three-button mouse, the left button makes a selection, the right button extends the selection, and the middle button pastes it. Using this option with a two-button mouse results in being unable to paste.
Set the acceleration for a single motion longer than the delta specified with the -d option.
Start up with pasting disabled for security. If specified, limit gives the time in seconds during which a selection can be pasted. If too much time has passed, the paste is not allowed.
Specify the baud rate.
Set a three-digit button sequence, mapping the left, middle, and right buttons to buttons 1, 2, and 3. The default is 123. The sequence 321 is useful if you are left-handed, or 132 for a two-button mouse.
Set the delta value for use with -a. When a mouse motion event is longer than the specified delta, use accel as a multiplier. delta must be 2 or greater.
Debugging mode. When set, gpm does not put itself into the background, and it logs messages to standard error instead of syslog.
For a glidepoint device, specify the button to be emulated by a tap. num must be 1, 2, or 3 and refers to the button number before any remapping is done by the -B option. Applies to mman and ps2 protocol decoding.
Print a help message and exit.
Specify the upper time limit, in milliseconds, between mouse clicks for the clicks to be considered a double or triple click.
Kill a running gpm. For use with a bus mouse to kill gpm before running X. See also -R.
Specify the inword( ) lookup table, which determines which characters can appear in a word. charset is a list of characters. The list can include only printable characters. Specify a range with -, and use \ to escape the following character or to specify an octal character.
Specify the mouse file to open. The default is /dev/mouse.
Enable the use of more than one mouse. Options appearing before -M apply to the first mouse; those appearing after it apply to the second mouse. Forces the use of -R.
Specify a comma-separated list of additional mouse-specific options. See the gpm info page for a description of the mouse types and the possible options.
Keep the pointer visible while text is being selected. The default is not to show the pointer.
Specify the responsiveness. A higher number causes the cursor to move faster.
Act as a repeater and pass any mouse data received while in graphical mode to the fifo /dev/gpmdata in the protocol specified by name (default is msc). In addition to certain protocol types available with -t, you can specify raw to repeat the data with no protocol translation.
Specify the sample rate for the mouse device.
Enable special-command processing (see the next section). Custom commands can be specified as a colon-separated list to associate commands with the left button, middle button, and right button. If a command is omitted, it defaults to sending a signal to init.
Specify the mouse protocol type. Use -t help for a list of types; those marked with an asterisk (*) can be used with -R.
Print version information and exit.
Make gpm more or less verbose by the specified increment. The default verbosity level is 5, and the default increment is 1. A larger value of increment causes more messages to be logged. The increment can be negative, but must be specified with no space (e.g., -V-3).
Special commands, activated with the -S option, are associated with each mouse button. You can also use -S to customize the commands. To execute a special command, triple-click the left and right buttons (hold down one of the buttons and triple-click the other). A message appears on the console, and the speaker beeps twice. At this point, release the buttons and press the desired button within three seconds to activate the associated special command. The default special commands are: