Debian Codegraph @

upstream/debian-unstable/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 SN:SERIAL
27 Reset by serial number
28 .TP
29 .B Product
30 Reset by product name
31 .PP
32 When run without any arguments,
33 .B usbreset
34 provides usage information and a list of connected USB devices, including their
35 vendor and product IDs, bus and device numbers, and product names.
36
37 .SH RETURN VALUE
38 If the specified device is not found, a non-zero exit code is returned.
39
40 .SH EXAMPLES
41 .TP
42 Reset device with vendor ID 1234 and product ID 5678:
43 .B usbreset 1234:5678
44
45 .TP
46 Reset device 002 on bus 001:
47 .B usbreset 001/002
48
49 .TP
50 Reset device with serial number ABCDEF0
51 .B usbreset SN:ABCDEF0
52
53 .TP
54 Reset device named USB2.0 Hub:
55 .B usbreset """USB2.0 Hub"""
56
57 .SH SEE ALSO
58 .BR lsusb (8).
59
60 .SH AUTHOR
61 Alan Stern <[email protected]>