USBHIDCTL(1)               OpenBSD Reference Manual               USBHIDCTL(1)

NAME
     usbhidctl - manipulate USB HID devices

SYNOPSIS
     usbhidctl -f device [-t table] [-l] [-v] -a

     usbhidctl -f device [-t table] [-v] -r

     usbhidctl -f device [-t table] [-l] [-n] [-v] [item ...]

     usbhidctl -f device [-t table] -w [item=value ...]

DESCRIPTION
     usbhidctl can be used to dump or modify the state of a USB HID (Human In-
     terface Device).  If a list of items is present on the command line, then
     usbhidctl prints the current value of those items for the specified de-
     vice.  If the -w flag is specified usbhidctl attempts to set the speci-
     fied items to the given values.

     The options are as follows:

     -a      Show all items and their current values.

     -f device
             Specify a path name for the device to operate on.  If device is
             numeric, it is taken to be the USB HID device number.  If it is a
             relative path, it is taken to be the name of the device under
             /dev. An absolute path is taken to be the literal device path-
             name.

     -l      Loop and dump the device data every time it changes.  Only 'in-
             put' items are displayed in this mode.

     -n      Suppress printing of the item name when querying specific item
             values.

     -r      Dump the report descriptor.

     -t table
             Specify a path name for the HID usage table file.

     -v      Be verbose.  Repeating this option increases verbosity.

     -w      Change item values.  Only 'output' and 'feature' kinds can be set
             with this option.

FILES
     /usr/share/misc/usb_hid_usages The default HID usage table.

SEE ALSO
     usb(3), uhid(4), usb(4)

AUTHOR
     David Sainty <David.Sainty@dtsp.co.nz>

HISTORY
     The usbhidctl command first appeared in OpenBSD 3.0.

BUGS
     Some USB HID devices report multiple items with exactly the same descrip-
     tion.  The current naming scheme does not provide the means to specify
     which of the identically named items you are referring to.

OpenBSD 3.0                     August 27, 2000                              1
