diff options
Diffstat (limited to 'debian/patches/03-add-a-manpage-for-usbreset.patch')
-rw-r--r-- | debian/patches/03-add-a-manpage-for-usbreset.patch | 105 |
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> |