Skip to content

Commit f28ec58

Browse files
committed
docs/FAQ.txt: add more reasons and symptoms that a running driver disappears
1 parent a6b29f3 commit f28ec58

File tree

2 files changed

+26
-1
lines changed

2 files changed

+26
-1
lines changed

Diff for: docs/FAQ.txt

+24
Original file line numberDiff line numberDiff line change
@@ -673,6 +673,30 @@ the symptoms for the problem look like this:
673673
[ 126.825775] hid-generic 0003:0463:FFFF.000B: timeout initializing reports
674674
[ 132.527809] usb 1-6: USB disconnect, device number 10
675675

676+
A similar report on the driver side may look like:
677+
678+
usbhid-ups[4554]: libusb_get_report: Input/output error
679+
upsd[4591]: Data for UPS [eaton] is stale - check driver
680+
usbhid-ups[4554]: Can't claim USB device [0463:ffff]: No such file or directory
681+
upsd[4591]: Can't connect to UPS [eaton] (usbhid-ups-eaton): No such file or directory
682+
upsmon[5148]: Poll UPS [eaton@localhost] failed - Driver not connected
683+
upsmon[5148]: Communications with UPS eaton@localhost lost
684+
685+
Other similar looking issues may include improper setup of udev, upower
686+
and similar frameworks to hand over the device from the OS to a driver
687+
daemon; competition with other software probing USB devices (ModemManager
688+
was mentioned in this context), including running several copies of the
689+
NUT drivers trying to use same port (e.g. one started by services and
690+
another manually as you tried to debug the problems).
691+
692+
Software quirks aside, please do test with a different USB cable and/or port
693+
on the computer. These were known to cause grief beyond what can be fixed
694+
with a few key words ;)
695+
696+
Finally, sometimes the issue is on the OS side (and/or USB chipset), to
697+
the point that the USB driver can not be unloaded and re-attached until
698+
you power cycle the system.
699+
676700
== Why doesn't my package work?
677701

678702
Or a variation like...

Diff for: docs/nut.dict

+2-1
Original file line numberDiff line numberDiff line change
@@ -1,4 +1,4 @@
1-
personal_ws-1.1 en 2910 utf-8
1+
personal_ws-1.1 en 2911 utf-8
22
AAS
33
ABI
44
ACFAIL
@@ -662,6 +662,7 @@ MiniGuard
662662
Minislot
663663
Moar
664664
Modbus
665+
ModemManager
665666
MonAMI
666667
MonUPS
667668
Monett

0 commit comments

Comments
 (0)