hid-recorder1

Name

hid-recorder - HID input device recorder

Synopsis

hid-recorder [--output=output_file] [/dev/hidrawX] [[/dev/hidrawX] [...]]

Options

--output=path/to/file

Write the output to the given file. When omitted, hid-recorder prints to stdout.

Description

hid-recorder captures report descriptors and hid reports (events) through the hidraw kernel module and prints them in a standardized format (see below) to debug and replay HID devices.

When invoked without arguments, hid-recorder shows a list of available devices.

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

File format

The output of hid-recorder has the following syntax:

•

# comment lines are ignored when parsing

•

D: the device index, only used when recording multiple devices

•

R: The report descriptor length in bytes, followed by the report descriptor bytes in hexadecimal

•

N: the name of the device

•

P: physical path

•

I: bus vendor_id product_id

•

E: timestamp size report in hexadecimal

Exit code

hid-recorder returns 1 on error.

See also

hid-replay(1)