This is Gentoo's testing wiki. It is a non-operational environment and its textual content is outdated.
Please visit our production wiki at https://wiki.gentoo.org
uvesafb
uvesafb is a framebuffer driver to use the VESA BIOS Extensions for changing display modes or display graphics on the console.
Installation
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.
Kernel
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
Emerge
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.
Configuration
Bootloader
Be sure the kernel command-line parameters are fixed in whatever bootloader loads the kernel.
GRUB2
In GRUB2 the parameters can be added to the variable GRUB_CMDLINE_LINUX_DEFAULT in /etc/default/grub.
linux video=uvesafb:1024x768-32,mtrr:3,ywrap
Then run:
root #
grub-mkconfig -o /boot/grub/grub.cfg
Usage
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.