lmctl man page on Mandriva

Man page or keyword search:  
man Server   17060 pages
apropos Keyword Search (all sections)
Output format
Mandriva logo
[printable version]

LMCTL(1)							      LMCTL(1)

NAME
       lmctl - Configure Logitech Mice

SYNOPSIS
       lmctl [OPTIONS]

DESCRIPTION
       lmctl  can  configure  vendor-specific options on Logitech USB mice (or
       dual-personality mice plugged into the USB port). A  number  of	recent
       devices are supported. The program is mostly useful in setting the res‐
       olution to 800 cpi on mice that boot at 400 cpi (such as	 the  author's
       MX-500),	 and  disabling	 SmartScroll  or  Cruise Control for those who
       would rather use the two extra buttons as ordinary mouse buttons.

       Hint 1: use a Linux kernel with Event Interface support (the evdev mod‐
       ule) if you want full access to the numerous buttons on these mice.

       Hint  2:	 on Linux, the usbmouse driver ignores the extra buttons alto‐
       gether. Don't let it handle your Logitech mice -- use the  generic  hid
       driver for USB HID devices instead.

EXIT STATUS
       An  exit	 status	 of  zero indicates successful termination. A non-zero
       exit status denotes abnormal termination due to an error.

OPTIONS
       lmctl accepts a number of arguments. The	 following  arguments  control
       which device is accessed or modified:

       -b, --bus=USB-BUS-NUMBER
	      Only  apply  the command to the specified bus, specified in full
	      (e.g. use	 -b 001 for bus 1). This is  in	 the  same  format  as
	      reported by lmctl -s (the first column, on the left hand side of
	      the period) or lsusb(1) (next to `Bus').

       -d, --dev=USB-DEVICE-NUMBER
	      Only apply the command to the specified bus, specified  in  full
	      (e.g.  use  -d 01b for device 27). This is in the same format as
	      reported by lmctl -s (the first column, on the right  hand  side
	      of the period) or lsusb(1) (next to `Device').

       -p, --pid=USB-PRODUCT-ID
	      Only  apply  the command to the specified USB product ID, speci‐
	      fied in hexadecimal and in full (e.g. use -p c025 for an	MX-500
	      optical mouse). Again, you can use lmctl -s or lsusb(1) to get a
	      listing of product IDs (the  right  hand	side  of  tuples  like
	      046d:xxxx).

       The following generic actions can be performed:

       -i, --inquire
	      Obtain  and display the status of all supported capabilities for
	      all matching devices.

       -s, --scan
	      Scan the USB bus and report  all	matching,  supported  Logitech
	      mice.

       The  following  commands configure wireless receivers and mice with the
       CSR command set (use lmctl -s to see if yours supports it):

       -1, --ch1
	      Set matching devices to channel 1. Please be aware that not  all
	      CSR-supporting devices are dual channel.

       -2, --ch2
	      Set matching devices to channel 2.

       -c, --clear
	      Make  all matching receivers forget about the mouse connected to
	      it, just as if the Connect  button  on  the  receiver  had  been
	      pressed for three seconds.

       -l, --lock
	      Stop  the	 30 second search for a wireless mouse on all matching
	      receivers. This search is initiated using the -u option,	or  by
	      pressing the Connect button on the receiver.

       -u, --unlock
	      Unlock  all  matching  receivers	and  initiate a search for any
	      wireless mouse in range. This is the same as pressing  the  Con‐
	      nect button on the receiver.

       The following settings control mouse resolution, for mice with both 400
       and 800 cpi support, and the RES capability.

       -4, --400
	      Sets matching devices to a resolution of 400 cpi.

       -8, --800
	      Sets matching devices to a resolution of 800 cpi. Very useful on
	      certain  Logitech	 mice  (the MX500 is one of them) that boot in
	      400 cpi.

       The following settings control  SmartScroll/Cruise  Control,  for  mice
       that support it (i.e. include the SMS capability).

       --no-sms
	      Disable  SmartScroll/Cruise  Control  an all matching mice. `Up'
	      and `down' buttons do not also issue wheel events. Useful if you
	      want to use the additional buttons for something else.

       --sms  Enable SmartScroll/Cruise Control an all matching mice. `Up' and
	      `down' buttons will now also issue wheel events (but  will  also
	      issue  their  native  button events, which user applications are
	      expected to ignore). This is how most mice boot.

       Other, miscellaneous options:

       -?, --help
	      List all available options and their meanings.

       --usage
	      Display brief usage information.

       -V, --version
	      Show the program's version, credits and licensing.

BUGS
       I only have an MX500, which lacks the CSR set. As such,	this  code  is
       untested.

       lmctl is an early version of a quick hack -- there are almost certainly
       numerous other bugs.

AUTHOR
       Written by Alexios Chouchoulas.

REPORTING BUGS
       Report bugs to Alexios Chouchoulas <alexios@bedroomlan.org>.

COPYRIGHT
       Copyright © 2004 Alexios Chouchoulas <alexios@bedroomlan.org>.
       This is free software; see the source for copying conditions.  There is
       NO  warranty;  not even for MERCHANTABILITY or FITNESS FOR A PARTICULAR
       PURPOSE.

SEE ALSO
       lsusb(1).

			       January 19, 2004			      LMCTL(1)
[top]

List of man pages available for Mandriva

Copyright (c) for man pages and the logo by the respective OS vendor.

For those who want to learn more, the polarhome community provides shell access and support.

[legal] [privacy] [GNU] [policy] [cookies] [netiquette] [sponsors] [FAQ]
Tweet
Polarhome, production since 1999.
Member of Polarhome portal.
Based on Fawad Halim's script.
....................................................................
Vote for polarhome
Free Shell Accounts :: the biggest list on the net