summaryrefslogtreecommitdiffstats
path: root/debian/patches/03-add-a-manpage-for-usbreset.patch
diff options
context:
space:
mode:
Diffstat (limited to 'debian/patches/03-add-a-manpage-for-usbreset.patch')
-rw-r--r--debian/patches/03-add-a-manpage-for-usbreset.patch105
1 files changed, 105 insertions, 0 deletions
diff --git a/debian/patches/03-add-a-manpage-for-usbreset.patch b/debian/patches/03-add-a-manpage-for-usbreset.patch
new file mode 100644
index 0000000..907103f
--- /dev/null
+++ b/debian/patches/03-add-a-manpage-for-usbreset.patch
@@ -0,0 +1,105 @@
+commit a5738f02804532efe96abd8c6d5df8beb6fd0a64
+Author: Aurelien Jarno <aurelien@aurel32.net>
+Date: Thu Jan 4 14:26:41 2024 +0100
+
+ Add a manpage for usbreset
+
+ Signed-off-by: Aurelien Jarno <aurelien@aurel32.net>
+
+diff --git a/Makefile.am b/Makefile.am
+index d3a9025..22452ba 100644
+--- a/Makefile.am
++++ b/Makefile.am
+@@ -49,7 +49,8 @@ man_MANS = \
+ lsusb.8 \
+ lsusb.py.1 \
+ usbhid-dump.8 \
+- usb-devices.1
++ usb-devices.1 \
++ usbreset.1
+
+ EXTRA_DIST = \
+ lsusb.8.in \
+@@ -58,6 +59,7 @@ EXTRA_DIST = \
+ usb-devices.1.in \
+ usb-devices \
+ lsusb.py.in \
++ usbreset.1.in \
+ usbreset.c \
+ LICENSES/GPL-2.0-only.txt \
+ LICENSES/GPL-3.0-only.txt
+@@ -80,11 +82,15 @@ usbhid-dump.8: $(srcdir)/usbhid-dump.8.in
+ usb-devices.1: $(srcdir)/usb-devices.1.in
+ sed 's|VERSION|$(VERSION)|g' $< >$@
+
++usbreset.1: $(srcdir)/usbreset.1.in
++ sed 's|VERSION|$(VERSION)|g' $< >$@
++
+ DISTCLEANFILES = \
+ lsusb.py \
+ lsusb.py.1 \
+ lsusb.8 \
+ usb-devices.1 \
++ usbreset.1 \
+ usbhid-dump.8
+
+ distclean-local:
+diff --git a/usbreset.1.in b/usbreset.1.in
+new file mode 100644
+index 0000000..1474ebc
+--- /dev/null
++++ b/usbreset.1.in
+@@ -0,0 +1,53 @@
++.\" SPDX-License-Identifier: GPL-2.0-only
++.\" Copyright (c) 2023 Aurelien Jarno <aurelien@aurel32.net>
++.TH usbreset 1 "04 January 2024" "usbutils-VERSION" "Linux USB Utilities"
++.IX usbreset
++.SH NAME
++usbreset \- send a USB port reset to a USB device
++.SH SYNOPSIS
++.B usbreset
++[
++.I device
++]
++
++.SH DESCRIPTION
++.B usbreset
++is a utility that performs resets on USB devices. It is particularly useful
++situations where a USB device is unresponsive or exhibits erratic behavior.
++The USB \fIdevice\fP to be reset can be specified in one of three formats:
++.TP
++.BR PPPP:VVVV
++Reset by product and vendor IDs
++.TP
++.BR BBB/DDD
++Reset by bus and device number
++.TP
++.BR "Product"
++Reset by product name
++.PP
++When run without any arguments,
++.B usbreset
++provides usage information and a list of connected USB devices, including their
++product and vendor IDs, bus and device numbers, and product names.
++
++.SH RETURN VALUE
++If the specified device is not found, a non-zero exit code is returned.
++
++.SH EXAMPLES
++.TP
++Reset device with vendor ID 1234 and product ID 5678:
++.B usbreset 1234:5678
++
++.TP
++Reset device 002 on bus 001:
++.B usbreset 001:002
++
++.TP
++Reset device named USB2.0 Hub:
++.B usbreset """USB2.0 Hub"""
++
++.SH SEE ALSO
++.BR lsusb (8).
++
++.SH AUTHOR
++Alan Stern <stern@rowland.harvard.edu>