detach-kernel-usb-driver — detach the kernel's own drivers from Generic USB devices
detach-kernel-usb-driver
{filename
...}
detach-kernel-usb-driver opens the device files filename
, which is assumed to be a Generic USB (ugen(4)) device, and instructs the kernel to detach its other device drivers from the device with the ioctl(3) function.
The usual use of the command is to prevent the kernel from automatically adding a USB keyboard or mouse to the set of devices constituting the primary user station, so that it can be employed for another user station.
On kernels where this is configured, which includes TrueOS kernels, the kernel detects the appearance of a USB HID device and automatically attaches a ums(4) or a ukbd(4) device to it. Plug and Play manager rules, in response to these devices, cause instances of moused(1) to be started for each HID mouse and cause each HID keyboard to be attached to the primary user station and the kernel virtual terminals.
detach-kernel-usb-driver causes these ums(4) and ukbd(4) devices to be removed. This permits the original ugen(4) device to be used for another user station.