mouseadmin(1)

mouseadmin -- mouse administration

Synopsis

mouseadmin

mouseadmin -v | -t | -n | -b | -l | -i irq | -d terminal | -a terminal mouse

Description

mouseadmin allows any user with system administrator privileges to add or delete mouse devices. Users without appropriate privileges will only be allowed to list the current mouse and display assignments. The recommended way to use mouseadmin is to enter the command without arguments; this will display the following menu:

   Mouse Configuration Program
   ---------------------------
   
   Select one of the following:
   

        D) Display configuration
        A) Autoconfigure mouse (PS2/serial mice only)
        B) Add a bus mouse
        P) Add a PS2 mouse
        S) Add a serial mouse
        U) Add a USB mouse
        N) Set number of mouse buttons
        T) Test your mouse configuration
        R) Remove a mouse
        E) Exit
   

   Enter Selection:

D

DIsplay COnfiguration. The status of all non-bus mice currently configured is displayed. as in this example:

The following terminals have mice assigned:

Display terminal Mouse device ---------------- ------------ console PS2 mouse on /dev/m320

A

Autoconfigures serial and PS2 mice. If the scan is successful, you are returned to the main menu. Select D to display the updated configuration.

B

Configure a Bus Mouse. Enter the IRQ (interrupt) for the bus mouse when prompted. If the configuration is successful, you are returned to the main menu. Select D to display the updated configuration.

P

Configure a PS2 Mouse. Enter the terminal device (e.g., console) that will use the PS2 mouse, and the mouse device name (e.g., m320) when prompted. If the configuration is successful, you are returned to the main menu. Select D to display the updated configuration.

S

Configure a Serial Mouse. Enter the terminal device (e.g., console) that will use the PS2 mouse, and the serial device name (e.g., tty00, tty01) when prompted. If the configuration is successful, you are returned to the main menu. Select D to display the updated configuration.

U

Configure a USB Mouse. Enter the terminal device (e.g., console) that will use the USB mouse. If the USB mouse is detected and configured successfully, you are returned to the main menu. Select D to display the updated configuration.

N

Set the default number of mouse buttons.

T

Test the mouse configured for the current processes' terminal, if any.

R

Remove a configured mouse from a display. Enter the terminal device (e.g., console) from which the mouse will be removed when prompted.

E

Exit mouseadmin.

Options

The following options are provided primarily for use within installation and other shell scripts.

-a: assign mouse device (PS2 BUS tty00 s0tty0 . . . ) to terminal (console s0vt00 . . . ).
-b: do not validate for BUS mouse in system configuration. (This option should only be used within install scripts.)
-d: delete terminal assignment.
-i: specify an interrupt vector for a BUS mouse. When using the -i option mouse must be BUS.
-l: list mouse/display assignments.
-n: build mouse/display pair table without downloading to driver. (This option should only be used within install scripts.)
-t: test currently configured mouse. If the mouse is there and detected the return will be ``0''; otherwise the return will be ``1'' or higher.
-v: verbose output. mouseadmin actively searches the PS/2 port and the serial ports for a mouse, and then reports what it has found. It does not look for bus mice. This option is mainly for use within install scripts.

Examples

mouseadmin -a console PS2
mouseadmin -i 5 -a console BUS
mouseadmin -a s0vt00 tty00
mouseadmin -a s0vt00 tty01

Files

/usr/bin/mouseadmin
/usr/lib/mousemgr

References

mouse(7)