uvesafb::reporting bugs

In order to streamline the process of reporting and solving bugs with uvesafb, please follow the guidelines below.

  1. make sure you're using the latest available version of v86d
  2. if uvesafb is compiled into the kernel, try to build it as a module and load it manually after boot
    • try installing v86d with --with-x86emu --with-debug (that's USE="x86emu debug" for Gentoo users)
    • if you're starting X automatically during boot, check whether loading uvesafb before X is started changes anything
    • if you're using a proprietary X11 driver, check whether loading the uvesafb module before the proprietary kernel module changes anything
    • attach the output of testvbe
  3. include a relevant dmesg excerpt in your bug report (it should contain all uvesafb related messages; if you're not sure what exactly is relevant in your case, include the whole thing); include kernel log excerpts for both built-in uvesafb and uvesafb built as a module
  4. attach your full kernel config file as well as the bootloader config file excerpt for the kernel you're currently running (the kernel command line settings and the initrd are important)
  5. make sure your bug report contains a clear description of the problem and the verions of v86d and the Linux kernel that you're using
  6. if uvesafb worked for you before, make sure to mention it along with the version of the kernel and v86d which worked