USBHID(4)
π USBHID(4) β the kernel interfaces manual, but make it cute
okay so bestie, welcome to usbhid(4) β that's the USB HID transport driver page from the Kernel Interfaces Manual, and I'm gonna walk you through it like we're texting at 2am π«Ά
β¨ NAME β¨
usbhid β the USB HID transport driver. that's it, that's the name, iconic π
π¦ SYNOPSIS π¦
so like, if you wanna compile this driver into the kernel? you gotta place these lines in your kernel configuration file:
device usbhid
orrrr, alternatively, if you'd rather load the driver as a module at boot time (very lowkey of you), place this line in loader.conf(5):
usbhid_load="YES"
slay, either way works π
πΈ DESCRIPTION πΈ
the usbhid driver provides an interface to USB Human Interface Devices, aka HIDs π that's literally the whole vibe. it's the transport driver, it's the middleman, it's giving main character energy β¨
π SYSCTL VARIABLES π
these variables are available as both sysctl(8) variables and loader(8) tunables, which is honestly so convenient of them π«Ά
hw.usb.usbhid.enableβ enablesusbhidand makes its priority greater than other USB HID drivers, likeukbd(4),ums(4), anduhid(4). default is1. she's enabled by default, periodt πhw.usb.usbhid.debugβ the debug output level, where0means debugging is disabled and larger values increase debug message verbosity. default is0. and ngl, those debug messages get printed on the system console and can be viewed usingdmesg(8)π₯
π heads up bestie: if you crank up hw.usb.usbhid.debug, you're gonna get more verbose messages, and they show up on the system console β that's straight from the page, no cap.
π§ SEE ALSO π§
the whole friend group showed up for this one, iykyk:
ehci(4), hkbd(4), hms(4), ohci(4), uhci(4), usb(4), xhci(4), usbconfig(8) π
π HISTORY π
okay so storytime π the usbhid driver first appeared in FreeBSD 13.0. and then it was enabled by default in FreeBSD 15.0. glow up fr fr β¨
π AUTHORS π
the usbhid driver was written by Vladimir Kondratyev <wulf@FreeBSD.org> β thank you for your service king π«‘π
π and that's the page!! this version came from Debian, dated October 2, 2025, filed under USBHID(4) in the Kernel Interfaces Manual. mwah, love u, go read your dmesg πβ¨
π¦ where this page comes from
- freebsd 15.1: base 15.1
- Copyright (c) 2020 Vladimir Kondratyev <wulf@FreeBSD.org>
- π girlified by deepseek-ai/DeepSeek-V4.1-Flash-1017 on : a language model's rewrite of the original, under its terms