Troubleshooting

This is a quick guide to help you gather the information necessary to file a good bug report.

Where's the Problem?

It helps to know which component is broken in order to more quickly find the solution. Please check to see which type of issue best describes your problem:

• Third-party issues:

  • Control panel settings (e.g. button mapping, display mapping, etc.) are mis-applied.
  • Control panel layout is broken.
  • Any control panel issue for desktop environments other than GNOME, Unity, or Cinnamon.

• Database issues:

  • The device works, but is not detected by the GNOME/Unity/Cinnamon control panel (a "No tablet detected" or "No stylus detected" message).
  • The GNOME/Unity/Cinnamon control panel detects the device, but it has incorrect information.

• Xorg / xsetwacom issues:

  • The device works but is mis-configured.
  • The device works but graphics applications like GIMP, Krita, MyPaint, or Inkscape behave incorrectly.
  • The xsetwacom utility is not working properly.
  • The device works but is not listed in the output of xsetwacom
  • The device does not work but is listed in the output of grep -H "" /sys/module/*wacom*/drivers/*/*/input/*/name

• Kernel issues:

  • The device works and shows up in xsetwacom, but behaves incorrectly in all programs -- not just graphics applications.
  • The device does not work at all.
  • The device is not listed in the output of grep -H "" /sys/module/*wacom*/drivers/*/*/input/*/name
  • Nothing is listed in the output of ls /sys/module/ | grep wacom.

What Logs to Gather?

Copy/paste the following command to gather some high-level information from your system. Attach the generated libwacom-logs.txt.gz file to the issue for review.

$ D=$(mktemp -d linuxwacom-logs.XXXXXX); \
  F=$(mktemp --suffix=".tar.gz" linuxwacom-logs.XXXXXX); \
  libwacom-list-local-devices > "$D/libwacom.txt"; \
  xsetwacom > "$D/xsetwacom.txt"; \
  journalctl -b0 _COMM=gdm-x-session > "$D/journalctl.txt"; \
  grep -H "" /sys/module/*wacom*/drivers/*/*/input/*/name > "$D/devices.txt"; \
  grep -H "" /sys/module/*wacom*/version > "$D/version.txt"; \
  lsusb > "$D/lsusb.txt"; \
  dmesg > "$D/dmesg.txt"; \
  ls -d "$D" /var/log/Xorg.*.log* ~/.local/share/xorg/*.log* 2>/dev/null | \
  tar czf "$F" -T -; rm -rf "$D"; echo "Logs saved to $F"

Where To Report?

• Third-party issues:

  • Issues with the GNOME control panel belong at https://gitlab.gnome.org/GNOME/gnome-control-center/issues
  • Issues with the Unity control panel belong at https://bugs.launchpad.net/ubuntu/+source/unity-control-center
  • Issues with the Cinnamon control panel belong at https://github.com/linuxmint/cinnamon-control-center/issues
  • Issues with other control panels belong at their developer's issue tracker.

• Database issues:

  • All bugs should be filed against libwacom

• Xorg / xsetwacom issues:

  • All bugs should be filed against xf86-input-wacom

• Kernel issues:

  • All bugs should be filed against input-wacom