hid-recorder (1) - Linux Manuals

hid-recorder: HID Input device recorder.

NAME

hid-recorder - HID Input device recorder.

SYNOPSIS

hid-recorder

hid-recorder [OPTIONS] [/dev/hidrawX] [[/dev/hidrawY] ... ]

OPTIONS

-d, --debugfs

use HID debugfs node. Some devices (like "Logitech USB Receiver" or "Apple Magic Mouse") grabs the hidraw output leading to an empty output. Fortunately, relying on HID debugfs can help us most of the time. However, if hte device does report two many events at once (multitouch panles for example), the HID debugfs node is missing a lot of events, preventing us to make this the default behaviour.

DESCRIPTION

hid-recorder is a tool that allow users to capture hidraw description and events in order to replay them through the uhid kernel module.

The first invocation type displayed above (without arguments) causes hid-recorder to let the user choose which hidraw she will use, including the name the device.

Several hidraw nodes can be given to hid-recorder. In this case, the recording of each node are multiplexed thanks to the tag D: as seen below.

hid-recorder needs to be able to read from the hidraw device; in most cases this means it must be run as root.

hid-recorder and hid-replay are used to debug kernel issues with HID input devices. The output of hid-recorder has the following syntax:

• # lines comments

• D: tell which device we are currently working with

• R: size dump_of_report_descriptor_in_hexadecimal

• N: common_name_of_the_device

• P: physical_path

• I: bus vendor_id product_id

• E: timestamp size report_in_hexadecimal

EXIT CODE

hid-recorder returns EXIT_FAILURE on error.

COPYRIGHT

Copyright 2012, Benjamin Tissoires.
Copyright 2012, Red Hat, Inc.

AUTHOR

Benjamin Tissoires <benjamin.tissoires [at] redhat.com>