Skip to content

Reporting Bugs

With great power, comes great responsibility!

Similarly in case of custom roms, there might be a bug which slept away unnoticed either by source or by the maintainer, so if you face them your duty is to report it.

How To Report Bugs

A proper bug report includes logs of various android components, such as,

  • kernel logs (known as dmesg)
  • system logs (known as logcat)

Logcat

To grab a logcat it is required to have USB debugging enabled:

  • Go into Settings -> About Phone and press 7 times the Build Number.
  • Go into Settings -> System -> Developer options and enable USB Debugging.
  • Open an ADB & Fastboot tools window on your PC and run this:
$ adb logcat -d > logcat.log
  • If a radio buffer log is requested, run this as well:
$ adb logcat -db radio > radio.log

Dmesg

Grabbing a dmesg requires root access. Fortunately, userdebug builds of LineageOS can access a root shell enviroment out-of-the box:

  • Go into Settings -> About Phone and press 7 times the Build Number.
  • Go into Settings -> System -> Developer options and enable USB Debugging and Rooted debugging.
  • Open a ADB & Fastboot tools window on your PC and run this:
$ adb root # Enables root shell
$ adb shell dmesg > dmesg.log