Debian Codegraph @

upstream/debian-trixie/man1/usbreset.1

raw
1 .\" SPDX-License-Identifier: GPL-2.0-only
2 .\" Copyright (c) 2023 Aurelien Jarno <[email protected]>
3 .TH usbreset 1 "04 January 2024" usbutils "Linux USB Utilities"
4 .IX usbreset
5 .SH NAME
6 usbreset \- send a USB port reset to a USB device
7 .SH SYNOPSIS
8 .B usbreset
9 [
10 .I device
11 ]
12
13 .SH DESCRIPTION
14 .B usbreset
15 is a utility that performs resets on USB devices.
16 It is particularly useful for
17 situations where a USB device is unresponsive or exhibits erratic behavior.
18 The USB \fIdevice\fP to be reset can be specified in one of three formats:
19 .TP
20 .B VVVV:PPPP
21 Reset by vendor and product IDs
22 .TP
23 .B BBB/DDD
24 Reset by bus and device number
25 .TP
26 .B Product
27 Reset by product name
28 .PP
29 When run without any arguments,
30 .B usbreset
31 provides usage information and a list of connected USB devices, including their
32 vendor and product IDs, bus and device numbers, and product names.
33
34 .SH RETURN VALUE
35 If the specified device is not found, a non-zero exit code is returned.
36
37 .SH EXAMPLES
38 .TP
39 Reset device with vendor ID 1234 and product ID 5678:
40 .B usbreset 1234:5678
41
42 .TP
43 Reset device 002 on bus 001:
44 .B usbreset 001:002
45
46 .TP
47 Reset device named USB2.0 Hub:
48 .B usbreset """USB2.0 Hub"""
49
50 .SH SEE ALSO
51 .BR lsusb (8).
52
53 .SH AUTHOR
54 Alan Stern <[email protected]>