pub/scm/linux/kernel/git/gregkh/usbutils.git  about / heads / tags
usbutils main repo
$ git log --pretty=format:'%h %s (%cs)%d'
d0c76b6 usbutils 019 release (2025-10-22)
	(HEAD -> master, tag: v019)
48ddd84 usb-devices: fix up some minor shellcheck warning messages (2025-10-19)
ab6db9a usb-devices: fix up bash warning for $altset (2025-10-19)
366f12c Merge pull request #236 from gregkh/dependabot/github_actions/all-actions-71574ff7fa (2025-10-02)
d6d1d5f ci: bump the all-actions group across 1 directory with 3 updates (2025-10-01)
66fc4a8 Merge pull request #234 from valdaarhun/usb_devices_prnt (2025-06-20)
0d3cc5d usb-devices: Make devnum 'local' to handle recursion (2025-06-20)
69ba5fd Merge pull request #232 from gregkh/dependabot/github_actions/all-actions-ced721f930 (2025-06-02)
20c953d ci: bump github/codeql-action in the all-actions group (2025-06-01)
82e4aff Merge pull request #231 from prahal/fix-usbreset-example (2025-05-28)
...

$ git cat-file blob HEAD:README.md
<!---
SPDX-License-Identifier: GPL-2.0-or-later
Copyright (c) 2018 Greg Kroah-Hartman <gregkh@linuxfoundation.org>
-->
# 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].

[to the maintainer]: mailto:gregkh@linuxfoundation.org
[to the linux-usb mailing list]: mailto:linux-usb@vger.kernel.org
[pull request]: https://github.com/gregkh/usbutils/pulls
[Developer Certificate of Origin v1.1]: https://developercertificate.org/
[reuse-tool]: https://github.com/fsfe/reuse-tool

# heads (aka `branches'):
$ git for-each-ref --sort=-creatordate refs/heads \
	--format='%(HEAD) %(refname:short) %(subject) (%(creatordate:short))'
* master       usbutils 019 release (2025-10-22)

# tags:
$ git for-each-ref --sort=-creatordate refs/tags \
	--format='%(refname:short) %(subject) (%(creatordate:short))'
v019         usbutils 019 release (2025-10-22) tar.gz
v018         usbutils 018 release (2024-10-22) tar.gz
v017         usbutils 017 release (2023-10-30) tar.gz
v016         usbutils 016 release (2023-10-22) tar.gz
v015         usbutils v015 release (2022-10-22) tar.gz
v014         usbutils 014 release (2021-08-06) tar.gz
v013         usbutils 013 release (2020-10-22) tar.gz
v012         usbutils 012 release (2019-05-07) tar.gz
v011         usbutils 011 release (2019-05-06) tar.gz
v010         usbutils 010 release (2018-05-15) tar.gz
...

# associated public inboxes:
# (number on the left is used for dev purposes)
         22 lkml
         21 linux-usb
          8 linux-devicetree
          8 u-boot
          6 ltp
          5 netdev
          5 linux-arm-kernel
          4 qemu-devel
          4 linux-clk
          4 linux-gpio
          4 dri-devel
          4 intel-gfx
          3 linux-input
          3 alsa-devel
          3 dpdk-dev
          3 git
          3 linux-arch
          3 dm-devel
          3 buildroot
          3 openembedded-core
          2 linux-riscv
          2 linux-nfs
          2 linux-mediatek
          2 linux-acpi
          2 netfilter-devel
          2 linux-fsdevel
          2 linux-amlogic
          2 linux-mm
          2 xen-devel
          2 stable
          2 linux-snps-arc
          2 linux-mips
          2 linux-pm
          2 linux-rtc
          2 linux-btrfs
          2 linux-kselftest
          2 linux-rdma
          2 linux-parisc
          2 linux-ext4
          2 linux-leds
          2 linux-f2fs-devel
          2 linuxppc-dev
          2 linux-m68k
          2 util-linux
          2 linux-csky
          2 amd-gfx
          2 linux-rockchip
          2 linux-perf-users
          2 linux-sh
          2 rust-for-linux
          2 fio
          2 yocto
          2 yocto-meta-arm
          2 openembedded-devel
          2 yocto-meta-ti
          2 loongarch
          2 intel-xe
          2 linux-um
          2 virtio-dev
          2 virtio-comment
          2 poky
          2 qemu-riscv
          2 linux-alpha
          2 linux-sound
          1 linux-samsung-soc
          1 linux-fscrypt
          1 linux-wireless
          1 linux-mtd
          1 cocci
          1 linux-block
          1 linux-nvme
          1 linux-xfs
          1 live-patching
          1 bpf
          1 linux-crypto
          1 linux-efi
          1 linux-integrity
          1 linux-edac
          1 linux-cifs
          1 linux-arm-msm
          1 linux-erofs
          1 linux-nvdimm
          1 linux-iommu
          1 linux-media
          1 fstests
          1 linux-hwmon
          1 linux-scsi
          1 kvmarm
          1 driverdev-devel
          1 linux-renesas-soc
          1 selinux
          1 kernel-hardening
          1 linux-iio
          1 dmaengine
          1 linux-next
          1 linux-security-module
          1 linux-pci
          1 kvm
          1 linux-modules
          1 kernelnewbies
          1 linux-rt-users
          1 linux-bluetooth
          1 linux-sgx
          1 linux-ide
          1 linux-serial
          1 linux-watchdog
          1 linux-trace-devel
          1 linux-hyperv
          1 workflows
          1 rcu
          1 linux-i3c
          1 linux-spdx
          1 linux-wpan
          1 ksummit-discuss
          1 wireguard
          1 backports
          1 io-uring
          1 linux-kernel-mentees
          1 linux-doc
          1 linux-man
          1 linux-mmc
          1 tpmdd-devel
          1 linux-unionfs
          1 linux-firmware
          1 linux-api
          1 cip-dev
          1 linux-omap
          1 linux-audit
          1 linux-spi
          1 linux-i2c
          1 linux-remoteproc
          1 linux-dash
          1 linux-bcache
          1 linux-sparse
          1 mm-commits
          1 linux-pwm
          1 linux-tegra
          1 lttng-dev
          1 virtualization
          1 linux-kbuild
          1 linux-fpga
          1 ceph-devel
          1 linux-can
          1 containers
          1 linux-raid
          1 xdp-newbies
          1 platform-driver-x86
          1 phone-devel
          1 openbmc
          1 linux-hardening
          1 dash
          1 keyrings
          1 linux-fbdev
          1 linux-sctp
          1 linux-cxl
          1 target-devel
          1 lustre-devel
          1 soc
          1 ocfs2-devel
          1 ath10k
          1 ath11k
          1 nouveau
          1 linux-phy
          1 linux-s390
          1 kernel-janitors
          1 sparclinux
          1 linux-staging
          1 linux-sunxi
          1 mptcp
          1 linux-coco
          1 regressions
          1 ksummit
          1 b43-dev
          1 nvdimm
          1 linux-nfc
          1 linux-bcachefs
          1 ath9k-devel
          1 ntfs3
          1 llvm
          1 iwd
          1 ell
          1 ofono
          1 yocto-meta-freescale
          1 yocto-toaster
          1 yocto-docs
          1 bitbake-devel
          1 linux-patches
          1 yocto-meta-virtualization
          1 chrome-platform
          1 ntb
          1 yocto-meta-arago
          1 outreachy
          1 xenomai
          1 damon
          1 asahi
          1 openrisc
          1 intel-wired-lan
          1 kexec
          1 imx
          1 ath12k
          1 b4-sent
          1 linux-trace-kernel
          1 oe-linux-nfc
          1 oe-kbuild-all
          1 oe-chipsec
          1 batman
          1 v9fs
          1 ecryptfs
          1 linux-ia64
          1 cluster-devel
          1 grub-devel
          1 kbd
          1 autofs
          1 cpufreq
          1 dccp
          1 cgroups
          1 devicetree-spec
          1 devicetree-compiler
          1 initramfs
          1 kvm-ppc
          1 hail-devel
          1 kvm-ia64
          1 linux-8086
          1 kernel-testers
          1 linux-btrace
          1 linux-embedded
          1 linux-hams
          1 linux-hexagon
          1 linux-hotplug
          1 linux-laptop
          1 trinity
          1 reiserfs-devel
          1 linux-metag
          1 linux-x25
          1 linux-nilfs
          1 lvs-devel
          1 netfilter
          1 linux-oxnas
          1 u-boot-amlogic
          1 lm-sensors
          1 lvm-devel
          1 acpica-devel
          1 perfbook
          1 virtio-fs
          1 smatch
          1 fuego
          1 wireless-regdb
          1 igt-dev
          1 powertop
          1 dtrace
          1 barebox

git clone https://yhbt.net/lore/pub/scm/linux/kernel/git/gregkh/usbutils.git