.\" Automatically generated by Pandoc 3.1.8
.\"
.TH "HID-RECORDER" "1" "" "" ""
.SS NAME
hid-recorder - HID input device recorder
.SS SYNOPSIS
\f[B]hid-recorder\f[R] \f[I][--output=output_file]\f[R]
\f[I][/dev/hidrawX]\f[R] [\f[I][/dev/hidrawX]\f[R] [\&...]]
.SS OPTIONS
.TP
\f[B]--output=path/to/file\f[R]
Write the output to the given file.
When omitted, \f[B]hid-recorder\f[R] prints to stdout.
.SS DESCRIPTION
\f[B]hid-recorder\f[R] captures report descriptors and hid reports
(events) through the \f[I]hidraw\f[R] kernel module and prints them in a
standardized format (see below) to debug and replay HID devices.
.PP
When invoked without arguments, \f[B]hid-recorder\f[R] shows a list of
available devices.
.PP
\f[B]hid-recorder\f[R] needs to be able to read from the hidraw device;
usually this means it must be run as root.
.SS FILE FORMAT
The output of \f[B]hid-recorder\f[R] has the following syntax:
.IP \[bu] 2
\f[B]#\f[R] comment lines are ignored when parsing
.IP \[bu] 2
\f[B]D:\f[R] the device index, only used when recording multiple devices
.IP \[bu] 2
\f[B]R:\f[R] The report descriptor length in bytes, followed by the
report descriptor bytes in hexadecimal
.IP \[bu] 2
\f[B]N:\f[R] the name of the device
.IP \[bu] 2
\f[B]P:\f[R] physical path
.IP \[bu] 2
\f[B]I:\f[R] bus vendor_id product_id
.IP \[bu] 2
\f[B]E:\f[R] timestamp size report in hexadecimal
.SS EXIT CODE
\f[B]hid-recorder\f[R] returns 1 on error.
.SS SEE ALSO
hid-replay(1)
.SS COPYRIGHT
Copyright 2012-2018, Benjamin Tissoires.
.PP
Copyright 2018, Red Hat, Inc.
.SS AUTHOR
Benjamin Tissoires <benjamin.tissoires@redhat.com>