summaryrefslogtreecommitdiffstats
path: root/upstream/debian-unstable/man1/usbreset.1
diff options
context:
space:
mode:
Diffstat (limited to 'upstream/debian-unstable/man1/usbreset.1')
-rw-r--r--upstream/debian-unstable/man1/usbreset.153
1 files changed, 53 insertions, 0 deletions
diff --git a/upstream/debian-unstable/man1/usbreset.1 b/upstream/debian-unstable/man1/usbreset.1
new file mode 100644
index 00000000..324aff9a
--- /dev/null
+++ b/upstream/debian-unstable/man1/usbreset.1
@@ -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-017" "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>