From Gentoo Wiki
Jump to: navigation, search

 As of 2017-08-14, the information in this article is probably outdated. You can help the Gentoo community by verifying and updating this article.
This article has some todo items:
  • Update regarding the removal of v86d

uvesafb is a framebuffer driver to use the VESA BIOS Extensions for changing display modes or display graphics on the console.


The uvesafb relies on kernel modules and the daemon sys-apps/v86d to change the resolutions and display. Prepare the system for the daemon by including kernel support.


Activate the following kernel options:

Device Drivers  --->
   <*> Connector - unified userspace <-> kernelspace linker  --->
   Graphics support  --->
      Frame buffer Devices  --->
         [*] Support for frame buffer devices --->
            [*] Enable firmware EDID
            <*> Userspace VESA VGA graphics support


Before this step, the kernel needs to be built and the link in /usr/src/linux updated to point to the compiled kernel sources with uvesafb enabled.

Rebuild dev-libs/klibc and install sys-apps/v86d:

root #emerge --ask --oneshot dev-libs/klibc
root #emerge --ask sys-apps/v86d

Initramfs inclusion

Once the installation is finished, you need to activate the following kernel options and then rebuild the initramfs:

General setup  --->
    [*] Initial RAM filesystem and RAM disk (initramfs/initrd) support
    (/usr/share/v86d/initramfs) Initramfs source file(s)

Use dracut, genkernel, or another initramfs generator of choice to rebuild the initramfs.



Be sure the kernel command-line parameters are fixed in whatever bootloader loads the kernel.


In GRUB2 the parameters can be added to the variable GRUB_CMDLINE_LINUX_DEFAULT in /etc/default/grub.

CODE Kernel command-line
linux video=uvesafb:1024x768-32,mtrr:3,ywrap

Then run:

root #grub-mkconfig -o /boot/grub/grub.cfg


The resolution and behavior of uvesafb is set during boot, a full list of kernel parameters can be found online or in the local kernel documentation via /usr/src/linux/Documentation/fb/uvesafb.txt.

External resources