1
0
Fork 0
mirror of https://github.com/gregkh/usbutils.git synced 2026-09-19 18:21:25 +00:00
USB utilities for Linux, including lsusb
  • C 75.9%
  • Shell 12%
  • Awk 8.4%
  • Python 2.7%
  • Meson 0.8%
  • Other 0.2%
Find a file
Greg Kroah-Hartman 24e48ca72b
Merge pull request #257 from JeffLepp/fix-usbreset-exit-status
usbreset: return failure when device reset fails
2026-09-04 09:12:54 +02:00
.github ci: bump the all-actions group with 5 updates 2026-08-01 22:37:20 +00:00
ccan Remove commented out code in usbreset.c and list.h and container_of.h 2024-11-16 16:09:35 +01:00
LICENSES tests: vendor brat 0.10.1 as the test runner 2026-05-27 16:23:13 +02:00
man usbreset.1: fix typo in the busnum/devicenum example 2025-05-28 17:42:01 +02:00
tests test/lsusb-vv.brat: send errors to /dev/null 2026-07-12 15:29:56 +02:00
usbhid-dump usbhid-dump: bound the HID-descriptor-extra walk by entry end, not start 2026-05-31 14:13:30 +02:00
.clang-format clang-format: bump column limit to 120 2024-10-16 17:29:29 +02:00
.codespellignore ci: add codespell action, fix all typos 2024-10-16 16:57:34 +01:00
.editorconfig editorconfig: make the line length 120 2024-10-01 16:43:37 +02:00
.gitignore Update .gitignore files 2024-09-19 18:04:23 +01:00
autogen.sh autogen.sh: use valid email for 2024 copyright 2024-09-18 22:09:08 +01:00
build-dev.ini ci: add SPDX copyright/licence identifiers 2024-09-23 20:42:30 +01:00
desc-defs.c lsusb: migrate the MIDIStreaming parsers onto the desc-dump table engine 2026-05-31 14:09:58 +02:00
desc-defs.h lsusb: migrate the MIDIStreaming parsers onto the desc-dump table engine 2026-05-31 14:09:58 +02:00
desc-dump.c desc-dump: don't exit() on a device-supplied size_field value 2026-05-31 14:09:58 +02:00
desc-dump.h rename "GPL-2.0+" to "GPL-2.0-or-later" 2021-02-22 14:25:02 +01:00
justfile justfile: add 'test' target 2026-05-27 16:23:13 +02:00
lsusb-t.c sysfs: strip control characters from device-supplied string attributes 2026-05-31 14:09:58 +02:00
lsusb.c lsusb: fix up parsing for older uvc devices 2026-06-19 17:14:03 +02:00
lsusb.h rename "GPL-2.0+" to "GPL-2.0-or-later" 2021-02-22 14:25:02 +01:00
lsusb.py Merge pull request #241 from cmheia/usb.ids 2026-06-06 07:28:32 +02:00
meson.build meson.build: turn off -Wno-unused-function 2026-06-19 17:02:31 +02:00
names.c names: fix missing null termination in get_vendor_product_with_fallback() 2026-05-27 16:36:46 +02:00
names.h lsusb: add fallback names for 'lsusb -v' output 2023-10-30 12:26:33 +01:00
NEWS usbutils 019 release 2025-10-22 14:00:57 +02:00
README.md README.md: add the linux-usb mailing list to the README. 2024-09-24 14:50:54 +02:00
REUSE.toml tests: vendor brat 0.10.1 as the test runner 2026-05-27 16:23:13 +02:00
sysfs.c sysfs: strip control characters from device-supplied string attributes 2026-05-31 14:09:58 +02:00
sysfs.h lsusb: make internal API const-aware 2024-09-24 10:46:56 +01:00
usb-devices usb-devices: fix default case in class_decode() 2026-05-27 17:05:09 +02:00
usb-spec.h usb-spec.h: fix up spelling mistake for "Tone Enable" entry 2026-04-12 07:59:49 +02:00
usbmisc.c lsusb: fix two -D path-resolution edge cases in usbmisc.c 2026-05-31 14:16:59 +02:00
usbmisc.h rename "GPL-2.0+" to "GPL-2.0-or-later" 2021-02-22 14:25:02 +01:00
usbreset.c usbreset: return failure when device reset fails 2026-08-31 17:06:56 -07:00
usbutils.spdx usbutils.spdx: update with new files added 2026-05-31 14:24:57 +02:00

usbutils

This is a collection of USB tools for use on Linux and BSD systems to query what type of USB devices are connected to the system. This is to be run on a USB host (i.e. a machine you plug USB devices into), not on a USB device (i.e. a device you plug into a USB host.)

Building and installing

Note, usbutils depends on libusb and libudev, be sure that libraries are properly installed first.

To work with the "raw" repo, after cloning it just do:

./autogen.sh

which will build everything and place the binaries into the build/ subdirectory.

usbutils uses meson to build, so if you wish to just build by hand you can do:

meson setup build
cd build/
meson compile

Source location

The source for usbutils can be found in many places, depending on the git hosting site you prefer. Here are the primary locations, in order of preference by the maintainer:

https://git.kernel.org/pub/scm/linux/kernel/git/gregkh/usbutils.git/
https://git.sr.ht/~gregkh/usbutils
https://github.com/gregkh/usbutils

Contributing

If you have patches or suggestions, you can submit them either via email to the maintainer or to the linux-usb mailing list or via a pull request.

Please note that commits must include a Signed-off-by trailer, indicating that you comply with the Developer Certificate of Origin v1.1.

In addition, when adding new files or contributing to existing ones, ensure that the SPDX tags SPDX-FileCopyrightText and SPDX-License-Identifier are available and are kept up-to date. You can learn more and do that via reuse-tool.