sphinx.addnodesdocument)}( rawsourcechildren]( translations LanguagesNode)}(hhh](h pending_xref)}(hhh]docutils.nodesTextChinese (Simplified)}parenthsba attributes}(ids]classes]names]dupnames]backrefs] refdomainstdreftypedoc reftarget/translations/zh_CN/fb/vesafbmodnameN classnameN refexplicitutagnamehhh ubh)}(hhh]hChinese (Traditional)}hh2sbah}(h]h ]h"]h$]h&] refdomainh)reftypeh+ reftarget/translations/zh_TW/fb/vesafbmodnameN classnameN refexplicituh1hhh ubh)}(hhh]hItalian}hhFsbah}(h]h ]h"]h$]h&] refdomainh)reftypeh+ reftarget/translations/it_IT/fb/vesafbmodnameN classnameN refexplicituh1hhh ubh)}(hhh]hJapanese}hhZsbah}(h]h ]h"]h$]h&] refdomainh)reftypeh+ reftarget/translations/ja_JP/fb/vesafbmodnameN classnameN refexplicituh1hhh ubh)}(hhh]hKorean}hhnsbah}(h]h ]h"]h$]h&] refdomainh)reftypeh+ reftarget/translations/ko_KR/fb/vesafbmodnameN classnameN refexplicituh1hhh ubh)}(hhh]hPortuguese (Brazilian)}hhsbah}(h]h ]h"]h$]h&] refdomainh)reftypeh+ reftarget/translations/pt_BR/fb/vesafbmodnameN classnameN refexplicituh1hhh ubh)}(hhh]hSpanish}hhsbah}(h]h ]h"]h$]h&] refdomainh)reftypeh+ reftarget/translations/sp_SP/fb/vesafbmodnameN classnameN refexplicituh1hhh ubeh}(h]h ]h"]h$]h&]current_languageEnglishuh1h hh _documenthsourceNlineNubhsection)}(hhh](htitle)}(h+vesafb - Generic graphic framebuffer driverh]h+vesafb - Generic graphic framebuffer driver}(hhhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhhh7/var/lib/git/docbuild/linux/Documentation/fb/vesafb.rsthKubh paragraph)}(hBThis is a generic driver for a graphic framebuffer on intel boxes.h]hBThis is a generic driver for a graphic framebuffer on intel boxes.}(hhhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhhhhubh)}(hThe idea is simple: Turn on graphics mode at boot time with the help of the BIOS, and use this as framebuffer device /dev/fb0, like the m68k (and other) ports do.h]hThe idea is simple: Turn on graphics mode at boot time with the help of the BIOS, and use this as framebuffer device /dev/fb0, like the m68k (and other) ports do.}(hhhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhhhhubh)}(hX This means we decide at boot time whenever we want to run in text or graphics mode. Switching mode later on (in protected mode) is impossible; BIOS calls work in real mode only. VESA BIOS Extensions Version 2.0 are required, because we need a linear frame buffer.h]hX This means we decide at boot time whenever we want to run in text or graphics mode. Switching mode later on (in protected mode) is impossible; BIOS calls work in real mode only. VESA BIOS Extensions Version 2.0 are required, because we need a linear frame buffer.}(hhhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK hhhhubh)}(h Advantages:h]h Advantages:}(hhhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhhhhubh block_quote)}(hX * It provides a nice large console (128 cols + 48 lines with 1024x768) without using tiny, unreadable fonts. * You can run XF68_FBDev on top of /dev/fb0 (=> non-accelerated X11 support for every VBE 2.0 compliant graphics board). * Most important: boot logo :-) h]h bullet_list)}(hhh](h list_item)}(hjIt provides a nice large console (128 cols + 48 lines with 1024x768) without using tiny, unreadable fonts.h]h)}(hjIt provides a nice large console (128 cols + 48 lines with 1024x768) without using tiny, unreadable fonts.h]hjIt provides a nice large console (128 cols + 48 lines with 1024x768) without using tiny, unreadable fonts.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjubah}(h]h ]h"]h$]h&]uh1jhj ubj)}(hvYou can run XF68_FBDev on top of /dev/fb0 (=> non-accelerated X11 support for every VBE 2.0 compliant graphics board).h]h)}(hvYou can run XF68_FBDev on top of /dev/fb0 (=> non-accelerated X11 support for every VBE 2.0 compliant graphics board).h]hvYou can run XF68_FBDev on top of /dev/fb0 (=> non-accelerated X11 support for every VBE 2.0 compliant graphics board).}(hj.hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhj*ubah}(h]h ]h"]h$]h&]uh1jhj ubj)}(hMost important: boot logo :-) h]h)}(hMost important: boot logo :-)h]hMost important: boot logo :-)}(hjFhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjBubah}(h]h ]h"]h$]h&]uh1jhj ubeh}(h]h ]h"]h$]h&]bullet*uh1j hhhKhjubah}(h]h ]h"]h$]h&]uh1jhhhKhhhhubh)}(hDisadvantages:h]hDisadvantages:}(hjhhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhhhhubj)}(h,* graphic mode is slower than text mode... h]j )}(hhh]j)}(h*graphic mode is slower than text mode... h]h)}(h(graphic mode is slower than text mode...h]h(graphic mode is slower than text mode...}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhj}ubah}(h]h ]h"]h$]h&]uh1jhjzubah}(h]h ]h"]h$]h&]j`jauh1j hhhKhjvubah}(h]h ]h"]h$]h&]uh1jhhhKhhhhubh)}(hhh](h)}(hHow to use it?h]hHow to use it?}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhhhhhKubh)}(hoSwitching modes is done using the vga=... boot parameter. Read Documentation/admin-guide/svga.rst for details.h]hoSwitching modes is done using the vga=... boot parameter. Read Documentation/admin-guide/svga.rst for details.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK hjhhubh)}(hYou should compile in both vgacon (for text mode) and vesafb (for graphics mode). Which of them takes over the console depends on whenever the specified mode is text or graphics.h]hYou should compile in both vgacon (for text mode) and vesafb (for graphics mode). Which of them takes over the console depends on whenever the specified mode is text or graphics.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK#hjhhubh)}(hThe graphic modes are NOT in the list which you get if you boot with vga=ask and hit return. The mode you wish to use is derived from the VESA mode number. Here are those VESA mode numbers:h]hThe graphic modes are NOT in the list which you get if you boot with vga=ask and hit return. The mode you wish to use is derived from the VESA mode number. Here are those VESA mode numbers:}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK'hjhhubhtable)}(hhh]htgroup)}(hhh](hcolspec)}(hhh]h}(h]h ]h"]h$]h&]colwidthKuh1jhjubj)}(hhh]h}(h]h ]h"]h$]h&]colwidthKuh1jhjubj)}(hhh]h}(h]h ]h"]h$]h&]colwidthKuh1jhjubj)}(hhh]h}(h]h ]h"]h$]h&]colwidthKuh1jhjubj)}(hhh]h}(h]h ]h"]h$]h&]colwidthK uh1jhjubhthead)}(hhh]hrow)}(hhh](hentry)}(hhh]h)}(hcolorsh]hcolors}(hj)hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK,hj&ubah}(h]h ]h"]h$]h&]uh1j$hj!ubj%)}(hhh]h)}(h640x480h]h640x480}(hj@hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK,hj=ubah}(h]h ]h"]h$]h&]uh1j$hj!ubj%)}(hhh]h)}(h800x600h]h800x600}(hjWhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK,hjTubah}(h]h ]h"]h$]h&]uh1j$hj!ubj%)}(hhh]h)}(h1024x768h]h1024x768}(hjnhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK,hjkubah}(h]h ]h"]h$]h&]uh1j$hj!ubj%)}(hhh]h)}(h 1280x1024h]h 1280x1024}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK,hjubah}(h]h ]h"]h$]h&]uh1j$hj!ubeh}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhjubhtbody)}(hhh](j )}(hhh](j%)}(hhh]h)}(h256h]h256}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK.hjubah}(h]h ]h"]h$]h&]uh1j$hjubj%)}(hhh]h)}(h0x101h]h0x101}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK.hjubah}(h]h ]h"]h$]h&]uh1j$hjubj%)}(hhh]h)}(h0x103h]h0x103}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK.hjubah}(h]h ]h"]h$]h&]uh1j$hjubj%)}(hhh]h)}(h0x105h]h0x105}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK.hjubah}(h]h ]h"]h$]h&]uh1j$hjubj%)}(hhh]h)}(h0x107h]h0x107}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK.hj ubah}(h]h ]h"]h$]h&]uh1j$hjubeh}(h]h ]h"]h$]h&]uh1jhjubj )}(hhh](j%)}(hhh]h)}(h32kh]h32k}(hj,hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK/hj)ubah}(h]h ]h"]h$]h&]uh1j$hj&ubj%)}(hhh]h)}(h0x110h]h0x110}(hjChhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK/hj@ubah}(h]h ]h"]h$]h&]uh1j$hj&ubj%)}(hhh]h)}(h0x113h]h0x113}(hjZhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK/hjWubah}(h]h ]h"]h$]h&]uh1j$hj&ubj%)}(hhh]h)}(h0x116h]h0x116}(hjqhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK/hjnubah}(h]h ]h"]h$]h&]uh1j$hj&ubj%)}(hhh]h)}(h0x119h]h0x119}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK/hjubah}(h]h ]h"]h$]h&]uh1j$hj&ubeh}(h]h ]h"]h$]h&]uh1jhjubj )}(hhh](j%)}(hhh]h)}(h64kh]h64k}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK0hjubah}(h]h ]h"]h$]h&]uh1j$hjubj%)}(hhh]h)}(h0x111h]h0x111}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK0hjubah}(h]h ]h"]h$]h&]uh1j$hjubj%)}(hhh]h)}(h0x114h]h0x114}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK0hjubah}(h]h ]h"]h$]h&]uh1j$hjubj%)}(hhh]h)}(h0x117h]h0x117}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK0hjubah}(h]h ]h"]h$]h&]uh1j$hjubj%)}(hhh]h)}(h0x11Ah]h0x11A}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK0hjubah}(h]h ]h"]h$]h&]uh1j$hjubeh}(h]h ]h"]h$]h&]uh1jhjubj )}(hhh](j%)}(hhh]h)}(h16Mh]h16M}(hj$hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK1hj!ubah}(h]h ]h"]h$]h&]uh1j$hjubj%)}(hhh]h)}(h0x112h]h0x112}(hj;hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK1hj8ubah}(h]h ]h"]h$]h&]uh1j$hjubj%)}(hhh]h)}(h0x115h]h0x115}(hjRhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK1hjOubah}(h]h ]h"]h$]h&]uh1j$hjubj%)}(hhh]h)}(h0x118h]h0x118}(hjihhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK1hjfubah}(h]h ]h"]h$]h&]uh1j$hjubj%)}(hhh]h)}(h0x11Bh]h0x11B}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK1hj}ubah}(h]h ]h"]h$]h&]uh1j$hjubeh}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]colsKuh1jhjubah}(h]h ]h"]h$]h&]uh1jhjhhhhhNubh)}(hMThe video mode number of the Linux kernel is the VESA mode number plus 0x200:h]hMThe video mode number of the Linux kernel is the VESA mode number plus 0x200:}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK5hjhhubj)}(h4Linux_kernel_mode_number = VESA_mode_number + 0x200 h]h)}(h3Linux_kernel_mode_number = VESA_mode_number + 0x200h]h3Linux_kernel_mode_number = VESA_mode_number + 0x200}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK8hjubah}(h]h ]h"]h$]h&]uh1jhhhK8hjhhubh)}(h-So the table for the Kernel mode numbers are:h]h-So the table for the Kernel mode numbers are:}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK:hjhhubj)}(hhh]j)}(hhh](j)}(hhh]h}(h]h ]h"]h$]h&]colwidthKuh1jhjubj)}(hhh]h}(h]h ]h"]h$]h&]colwidthKuh1jhjubj)}(hhh]h}(h]h ]h"]h$]h&]colwidthKuh1jhjubj)}(hhh]h}(h]h ]h"]h$]h&]colwidthKuh1jhjubj)}(hhh]h}(h]h ]h"]h$]h&]colwidthK uh1jhjubj)}(hhh]j )}(hhh](j%)}(hhh]h)}(hcolorsh]hcolors}(hj"hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK=hjubah}(h]h ]h"]h$]h&]uh1j$hjubj%)}(hhh]h)}(h640x480h]h640x480}(hj9hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK=hj6ubah}(h]h ]h"]h$]h&]uh1j$hjubj%)}(hhh]h)}(h800x600h]h800x600}(hjPhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK=hjMubah}(h]h ]h"]h$]h&]uh1j$hjubj%)}(hhh]h)}(h1024x768h]h1024x768}(hjghhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK=hjdubah}(h]h ]h"]h$]h&]uh1j$hjubj%)}(hhh]h)}(h 1280x1024h]h 1280x1024}(hj~hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK=hj{ubah}(h]h ]h"]h$]h&]uh1j$hjubeh}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhjubj)}(hhh](j )}(hhh](j%)}(hhh]h)}(h256h]h256}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK?hjubah}(h]h ]h"]h$]h&]uh1j$hjubj%)}(hhh]h)}(h0x301h]h0x301}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK?hjubah}(h]h ]h"]h$]h&]uh1j$hjubj%)}(hhh]h)}(h0x303h]h0x303}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK?hjubah}(h]h ]h"]h$]h&]uh1j$hjubj%)}(hhh]h)}(h0x305h]h0x305}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK?hjubah}(h]h ]h"]h$]h&]uh1j$hjubj%)}(hhh]h)}(h0x307h]h0x307}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK?hjubah}(h]h ]h"]h$]h&]uh1j$hjubeh}(h]h ]h"]h$]h&]uh1jhjubj )}(hhh](j%)}(hhh]h)}(h32kh]h32k}(hj#hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK@hj ubah}(h]h ]h"]h$]h&]uh1j$hjubj%)}(hhh]h)}(h0x310h]h0x310}(hj:hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK@hj7ubah}(h]h ]h"]h$]h&]uh1j$hjubj%)}(hhh]h)}(h0x313h]h0x313}(hjQhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK@hjNubah}(h]h ]h"]h$]h&]uh1j$hjubj%)}(hhh]h)}(h0x316h]h0x316}(hjhhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK@hjeubah}(h]h ]h"]h$]h&]uh1j$hjubj%)}(hhh]h)}(h0x319h]h0x319}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK@hj|ubah}(h]h ]h"]h$]h&]uh1j$hjubeh}(h]h ]h"]h$]h&]uh1jhjubj )}(hhh](j%)}(hhh]h)}(h64kh]h64k}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKAhjubah}(h]h ]h"]h$]h&]uh1j$hjubj%)}(hhh]h)}(h0x311h]h0x311}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKAhjubah}(h]h ]h"]h$]h&]uh1j$hjubj%)}(hhh]h)}(h0x314h]h0x314}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKAhjubah}(h]h ]h"]h$]h&]uh1j$hjubj%)}(hhh]h)}(h0x317h]h0x317}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKAhjubah}(h]h ]h"]h$]h&]uh1j$hjubj%)}(hhh]h)}(h0x31Ah]h0x31A}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKAhjubah}(h]h ]h"]h$]h&]uh1j$hjubeh}(h]h ]h"]h$]h&]uh1jhjubj )}(hhh](j%)}(hhh]h)}(h16Mh]h16M}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKBhjubah}(h]h ]h"]h$]h&]uh1j$hjubj%)}(hhh]h)}(h0x312h]h0x312}(hj2hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKBhj/ubah}(h]h ]h"]h$]h&]uh1j$hjubj%)}(hhh]h)}(h0x315h]h0x315}(hjIhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKBhjFubah}(h]h ]h"]h$]h&]uh1j$hjubj%)}(hhh]h)}(h0x318h]h0x318}(hj`hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKBhj]ubah}(h]h ]h"]h$]h&]uh1j$hjubj%)}(hhh]h)}(h0x31Bh]h0x31B}(hjwhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKBhjtubah}(h]h ]h"]h$]h&]uh1j$hjubeh}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]colsKuh1jhjubah}(h]h ]h"]h$]h&]uh1jhjhhhhhNubh)}(hTo enable one of those modes you have to specify "vga=ask" in the lilo.conf file and rerun LILO. Then you can type in the desired mode at the "vga=ask" prompt. For example if you like to use 1024x768x256 colors you have to say "305" at this prompt.h]hXTo enable one of those modes you have to specify “vga=ask” in the lilo.conf file and rerun LILO. Then you can type in the desired mode at the “vga=ask” prompt. For example if you like to use 1024x768x256 colors you have to say “305” at this prompt.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKEhjhhubh)}(hXMIf this does not work, this might be because your BIOS does not support linear framebuffers or because it does not support this mode at all. Even if your board does, it might be the BIOS which does not. VESA BIOS Extensions v2.0 are required, 1.2 is NOT sufficient. You will get a "bad mode number" message if something goes wrong.h]hXQIf this does not work, this might be because your BIOS does not support linear framebuffers or because it does not support this mode at all. Even if your board does, it might be the BIOS which does not. VESA BIOS Extensions v2.0 are required, 1.2 is NOT sufficient. You will get a “bad mode number” message if something goes wrong.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKJhjhhubhenumerated_list)}(hhh](j)}(hwNote: LILO cannot handle hex, for booting directly with "vga=mode-number" you have to transform the numbers to decimal.h]h)}(hwNote: LILO cannot handle hex, for booting directly with "vga=mode-number" you have to transform the numbers to decimal.h]h{Note: LILO cannot handle hex, for booting directly with “vga=mode-number” you have to transform the numbers to decimal.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKPhjubah}(h]h ]h"]h$]h&]uh1jhjhhhhhNubj)}(hsNote: Some newer versions of LILO appear to work with those hex values, if you set the 0x in front of the numbers. h]h)}(hrNote: Some newer versions of LILO appear to work with those hex values, if you set the 0x in front of the numbers.h]hrNote: Some newer versions of LILO appear to work with those hex values, if you set the 0x in front of the numbers.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKRhjubah}(h]h ]h"]h$]h&]uh1jhjhhhhhNubeh}(h]h ]h"]h$]h&]enumtypearabicprefixhsuffix.uh1jhjhhhhhKPubeh}(h] how-to-use-itah ]h"]how to use it?ah$]h&]uh1hhhhhhhhKubh)}(hhh](h)}(hX11h]hX11}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhhhhhKVubh)}(hXF68_FBDev should work just fine, but it is non-accelerated. Running another (accelerated) X-Server like XF86_SVGA might or might not work. It depends on X-Server and graphics board.h]hXF68_FBDev should work just fine, but it is non-accelerated. Running another (accelerated) X-Server like XF86_SVGA might or might not work. It depends on X-Server and graphics board.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKXhjhhubh)}(hThe X-Server must restore the video mode correctly, else you end up with a broken console (and vesafb cannot do anything about this).h]hThe X-Server must restore the video mode correctly, else you end up with a broken console (and vesafb cannot do anything about this).}(hj'hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK\hjhhubeh}(h]x11ah ]h"]x11ah$]h&]uh1hhhhhhhhKVubh)}(hhh](h)}(h Refresh ratesh]h Refresh rates}(hj@hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj=hhhhhKaubh)}(hThere is no way to change the vesafb video mode and/or timings after booting linux. If you are not happy with the 60 Hz refresh rate, you have these options:h]hThere is no way to change the vesafb video mode and/or timings after booting linux. If you are not happy with the 60 Hz refresh rate, you have these options:}(hjNhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKchj=hhubj)}(hXI* configure and load the DOS-Tools for the graphics board (if available) and boot linux with loadlin. * use a native driver (matroxfb/atyfb) instead if vesafb. If none is available, write a new one! * VBE 3.0 might work too. I have neither a gfx board with VBE 3.0 support nor the specs, so I have not checked this yet. h]j )}(hhh](j)}(hcconfigure and load the DOS-Tools for the graphics board (if available) and boot linux with loadlin.h]h)}(hcconfigure and load the DOS-Tools for the graphics board (if available) and boot linux with loadlin.h]hcconfigure and load the DOS-Tools for the graphics board (if available) and boot linux with loadlin.}(hjghhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKghjcubah}(h]h ]h"]h$]h&]uh1jhj`ubj)}(h_use a native driver (matroxfb/atyfb) instead if vesafb. If none is available, write a new one!h]h)}(h_use a native driver (matroxfb/atyfb) instead if vesafb. If none is available, write a new one!h]h_use a native driver (matroxfb/atyfb) instead if vesafb. If none is available, write a new one!}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKihj{ubah}(h]h ]h"]h$]h&]uh1jhj`ubj)}(hyVBE 3.0 might work too. I have neither a gfx board with VBE 3.0 support nor the specs, so I have not checked this yet. h]h)}(hwVBE 3.0 might work too. I have neither a gfx board with VBE 3.0 support nor the specs, so I have not checked this yet.h]hwVBE 3.0 might work too. I have neither a gfx board with VBE 3.0 support nor the specs, so I have not checked this yet.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKkhjubah}(h]h ]h"]h$]h&]uh1jhj`ubeh}(h]h ]h"]h$]h&]j`jauh1j hhhKghj\ubah}(h]h ]h"]h$]h&]uh1jhhhKghj=hhubeh}(h] refresh-ratesah ]h"] refresh ratesah$]h&]uh1hhhhhhhhKaubh)}(hhh](h)}(h Configurationh]h Configuration}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhhhhhKpubh)}(hXThe VESA BIOS provides protected mode interface for changing some parameters. vesafb can use it for palette changes and to pan the display. It is turned off by default because it seems not to work with some BIOS versions, but there are options to turn it on.h]hXThe VESA BIOS provides protected mode interface for changing some parameters. vesafb can use it for palette changes and to pan the display. It is turned off by default because it seems not to work with some BIOS versions, but there are options to turn it on.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKrhjhhubh)}(hYou can pass options to vesafb using "video=vesafb:option" on the kernel command line. Multiple options should be separated by comma, like this: "video=vesafb:ypan,inverse"h]hYou can pass options to vesafb using “video=vesafb:option” on the kernel command line. Multiple options should be separated by comma, like this: “video=vesafb:ypan,inverse”}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKxhjhhubh)}(hAccepted options:h]hAccepted options:}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK|hjhhubh)}(hinverse use inverse color maph]hinverse use inverse color map}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK~hjhhubj)}(hhh]j)}(hhh](j)}(hhh]h}(h]h ]h"]h$]h&]colwidthK uh1jhj ubj)}(hhh]h}(h]h ]h"]h$]h&]colwidthKFuh1jhj ubj)}(hhh](j )}(hhh](j%)}(hhh]h)}(hypanh]hypan}(hj+ hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhj( ubah}(h]h ]h"]h$]h&]uh1j$hj% ubj%)}(hhh](h)}(henable display panning using the VESA protected mode interface. The visible screen is just a window of the video memory, console scrolling is done by changing the start of the window.h]henable display panning using the VESA protected mode interface. The visible screen is just a window of the video memory, console scrolling is done by changing the start of the window.}(hjB hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhj? ubh)}(hpro:h]hpro:}(hjP hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhj? ubj)}(hR* scrolling (fullscreen) is fast, because there is no need to copy around data. h]j )}(hhh]j)}(hNscrolling (fullscreen) is fast, because there is no need to copy around data. h]h)}(hMscrolling (fullscreen) is fast, because there is no need to copy around data.h]hMscrolling (fullscreen) is fast, because there is no need to copy around data.}(hji hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhje ubah}(h]h ]h"]h$]h&]uh1jhjb ubah}(h]h ]h"]h$]h&]j`jauh1j hhhKhj^ ubah}(h]h ]h"]h$]h&]uh1jhhhKhj? ubh)}(hkontra:h]hkontra:}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhj? ubj)}(hl* scrolling only parts of the screen causes some ugly flicker effects (boot logo flickers for example). h]j )}(hhh]j)}(hfscrolling only parts of the screen causes some ugly flicker effects (boot logo flickers for example). h]h)}(hescrolling only parts of the screen causes some ugly flicker effects (boot logo flickers for example).h]hescrolling only parts of the screen causes some ugly flicker effects (boot logo flickers for example).}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhj ubah}(h]h ]h"]h$]h&]uh1jhj ubah}(h]h ]h"]h$]h&]j`jauh1j hhhKhj ubah}(h]h ]h"]h$]h&]uh1jhhhKhj? ubeh}(h]h ]h"]h$]h&]uh1j$hj% ubeh}(h]h ]h"]h$]h&]uh1jhj" ubj )}(hhh](j%)}(hhh]h)}(hywraph]hywrap}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhj ubah}(h]h ]h"]h$]h&]uh1j$hj ubj%)}(hhh]h)}(hSame as ypan, but assumes your gfx board can wrap-around the video memory (i.e. starts reading from top if it reaches the end of video memory). Faster than ypan.h]hSame as ypan, but assumes your gfx board can wrap-around the video memory (i.e. starts reading from top if it reaches the end of video memory). Faster than ypan.}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhj ubah}(h]h ]h"]h$]h&]uh1j$hj ubeh}(h]h ]h"]h$]h&]uh1jhj" ubj )}(hhh](j%)}(hhh]h)}(hredrawh]hredraw}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhj ubah}(h]h ]h"]h$]h&]uh1j$hj ubj%)}(hhh]h)}(hYScroll by redrawing the affected part of the screen, this is the safe (and slow) default.h]hYScroll by redrawing the affected part of the screen, this is the safe (and slow) default.}(hj" hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhj ubah}(h]h ]h"]h$]h&]uh1j$hj ubeh}(h]h ]h"]h$]h&]uh1jhj" ubj )}(hhh](j%)}(hhh]h)}(hvgapalh]hvgapal}(hjB hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhj? ubah}(h]h ]h"]h$]h&]uh1j$hj< ubj%)}(hhh]h)}(hHUse the standard vga registers for palette changes. This is the default.h]hHUse the standard vga registers for palette changes. This is the default.}(hjY hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjV ubah}(h]h ]h"]h$]h&]uh1j$hj< ubeh}(h]h ]h"]h$]h&]uh1jhj" ubj )}(hhh](j%)}(hhh]h)}(hpmipalh]hpmipal}(hjy hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjv ubah}(h]h ]h"]h$]h&]uh1j$hjs ubj%)}(hhh]h)}(h5Use the protected mode interface for palette changes.h]h5Use the protected mode interface for palette changes.}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhj ubah}(h]h ]h"]h$]h&]uh1j$hjs ubeh}(h]h ]h"]h$]h&]uh1jhj" ubj )}(hhh](j%)}(hhh]h)}(hmtrr:nh]hmtrr:n}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhj ubah}(h]h ]h"]h$]h&]uh1j$hj ubj%)}(hhh](h)}(hESetup memory type range registers for the vesafb framebuffer where n:h]hESetup memory type range registers for the vesafb framebuffer where n:}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhj ubj)}(h|- 0 - disabled (equivalent to nomtrr) (default) - 1 - uncachable - 2 - write-back - 3 - write-combining - 4 - write-through h]j )}(hhh](j)}(h-0 - disabled (equivalent to nomtrr) (default)h]h)}(hj h]h-0 - disabled (equivalent to nomtrr) (default)}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhj ubah}(h]h ]h"]h$]h&]uh1jhj ubj)}(h1 - uncachableh]h)}(hj h]h1 - uncachable}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhj ubah}(h]h ]h"]h$]h&]uh1jhj ubj)}(h2 - write-backh]h)}(hj h]h2 - write-back}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhj ubah}(h]h ]h"]h$]h&]uh1jhj ubj)}(h3 - write-combiningh]h)}(hj# h]h3 - write-combining}(hj% hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhj! ubah}(h]h ]h"]h$]h&]uh1jhj ubj)}(h4 - write-through h]h)}(h4 - write-throughh]h4 - write-through}(hj< hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhj8 ubah}(h]h ]h"]h$]h&]uh1jhj ubeh}(h]h ]h"]h$]h&]j`-uh1j hhhKhj ubah}(h]h ]h"]h$]h&]uh1jhhhKhj ubh)}(hkIf you see the following in dmesg, choose the type that matches the old one. In this example, use "mtrr:2".h]hoIf you see the following in dmesg, choose the type that matches the old one. In this example, use “mtrr:2”.}(hj] hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhj ubeh}(h]h ]h"]h$]h&]uh1j$hj ubeh}(h]h ]h"]h$]h&]uh1jhj" ubj )}(hhh](j%)}(hhh]h)}(h...h]h...}(hj} hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjz ubah}(h]h ]h"]h$]h&]uh1j$hjw ubj%)}(hhh]h}(h]h ]h"]h$]h&]uh1j$hjw ubeh}(h]h ]h"]h$]h&]uh1jhj" ubj )}(hhh](j%)}(hhh]h)}(hmtrr:h]hmtrr:}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhj ubah}(h]h ]h"]h$]h&]uh1j$hj ubj%)}(hhh]h)}(hGtype mismatch for e0000000,8000000 old: write-back new: write-combiningh]hGtype mismatch for e0000000,8000000 old: write-back new: write-combining}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhj ubah}(h]h ]h"]h$]h&]uh1j$hj ubeh}(h]h ]h"]h$]h&]uh1jhj" ubj )}(hhh](j%)}(hhh]h)}(h...h]h...}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhj ubah}(h]h ]h"]h$]h&]uh1j$hj ubj%)}(hhh]h}(h]h ]h"]h$]h&]uh1j$hj ubeh}(h]h ]h"]h$]h&]uh1jhj" ubj )}(hhh](j%)}(hhh]h)}(hnomtrrh]hnomtrr}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhj ubah}(h]h ]h"]h$]h&]uh1j$hj ubj%)}(hhh]h)}(h disable mtrrh]h disable mtrr}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhj ubah}(h]h ]h"]h$]h&]uh1j$hj ubeh}(h]h ]h"]h$]h&]uh1jhj" ubj )}(hhh](j%)}(hhh]h)}(hvremap:nh]hvremap:n}(hj= hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhj: ubah}(h]h ]h"]h$]h&]uh1j$hj7 ubj%)}(hhh]h)}(hRemap 'n' MiB of video RAM. If 0 or not specified, remap memory according to video mode. (2.5.66 patch/idea by Antonino Daplas reversed to give override possibility (allocate more fb memory than the kernel would) to 2.4 by tmb@iki.fi)h](hRemap ‘n’ MiB of video RAM. If 0 or not specified, remap memory according to video mode. (2.5.66 patch/idea by Antonino Daplas reversed to give override possibility (allocate more fb memory than the kernel would) to 2.4 by }(hjT hhhNhNubh reference)}(h tmb@iki.fih]h tmb@iki.fi}(hj^ hhhNhNubah}(h]h ]h"]h$]h&]refurimailto:tmb@iki.fiuh1j\ hjT ubh)}(hjT hhhNhNubeh}(h]h ]h"]h$]h&]uh1hhhhKhjQ ubah}(h]h ]h"]h$]h&]uh1j$hj7 ubeh}(h]h ]h"]h$]h&]uh1jhj" ubj )}(hhh](j%)}(hhh]h)}(hvtotal:nh]hvtotal:n}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhj ubah}(h]h ]h"]h$]h&]uh1j$hj ubj%)}(hhh]h)}(hIf the video BIOS of your card incorrectly determines the total amount of video RAM, use this option to override the BIOS (in MiB).h]hIf the video BIOS of your card incorrectly determines the total amount of video RAM, use this option to override the BIOS (in MiB).}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhj ubah}(h]h ]h"]h$]h&]uh1j$hj ubeh}(h]h ]h"]h$]h&]uh1jhj" ubeh}(h]h ]h"]h$]h&]uh1jhj ubeh}(h]h ]h"]h$]h&]colsKuh1jhj ubah}(h]h ]h"]h$]h&]uh1jhjhhhhhNubh)}(h Have fun!h]h Have fun!}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjhhubh)}(h)Gerd Knorr h](h Gerd Knorr <}(hj hhhNhNubj] )}(hkraxel@goldbach.in-berlin.deh]hkraxel@goldbach.in-berlin.de}(hj hhhNhNubah}(h]h ]h"]h$]h&]refuri#mailto:kraxel@goldbach.in-berlin.deuh1j\ hj ubh>}(hj hhhNhNubeh}(h]h ]h"]h$]h&]uh1hhhhKhjhhubh)}(hMMinor (mostly typo) changes by Nico Schmoigl h](h.Minor (mostly typo) changes by Nico Schmoigl <}(hj hhhNhNubj] )}(hschmoigl@rumms.uni-mannheim.deh]hschmoigl@rumms.uni-mannheim.de}(hj hhhNhNubah}(h]h ]h"]h$]h&]refuri%mailto:schmoigl@rumms.uni-mannheim.deuh1j\ hj ubh>}(hj hhhNhNubeh}(h]h ]h"]h$]h&]uh1hhhhKhjhhubeh}(h] configurationah ]h"] configurationah$]h&]uh1hhhhhhhhKpubeh}(h])vesafb-generic-graphic-framebuffer-driverah ]h"]+vesafb - generic graphic framebuffer driverah$]h&]uh1hhhhhhhhKubeh}(h]h ]h"]h$]h&]sourcehuh1hcurrent_sourceN current_lineNsettingsdocutils.frontendValues)}(hN generatorN datestampN source_linkN source_urlN toc_backlinksj$footnote_backlinksK sectnum_xformKstrip_commentsNstrip_elements_with_classesN strip_classesN report_levelK halt_levelKexit_status_levelKdebugNwarning_streamN tracebackinput_encoding utf-8-siginput_encoding_error_handlerstrictoutput_encodingutf-8output_encoding_error_handlerjR error_encodingutf-8error_encoding_error_handlerbackslashreplace language_codeenrecord_dependenciesNconfigN id_prefixhauto_id_prefixid dump_settingsNdump_internalsNdump_transformsNdump_pseudo_xmlNexpose_internalsNstrict_visitorN_disable_configN_sourcehʌ _destinationN _config_files]7/var/lib/git/docbuild/linux/Documentation/docutils.confafile_insertion_enabled raw_enabledKline_length_limitM'pep_referencesN pep_base_urlhttps://peps.python.org/pep_file_url_templatepep-%04drfc_referencesN rfc_base_url&https://datatracker.ietf.org/doc/html/ tab_widthKtrim_footnote_reference_spacesyntax_highlightlong smart_quotessmartquotes_locales]character_level_inline_markupdoctitle_xform docinfo_xformKsectsubtitle_xform image_loadinglinkembed_stylesheetcloak_email_addressessection_self_linkenvNubreporterNindirect_targets]substitution_defs}substitution_names}refnames}refids}nameids}(j- j* jjj:j7jjj% j" u nametypes}(j- jj:jj% uh}(j* hjjj7jjj=j" ju footnote_refs} citation_refs} autofootnotes]autofootnote_refs]symbol_footnotes]symbol_footnote_refs] footnotes] citations]autofootnote_startKsymbol_footnote_startK id_counter collectionsCounter}Rparse_messages](hsystem_message)}(hhh]h)}(heUnexpected possible title overline or transition. Treating it as ordinary text because it's so short.h]hgUnexpected possible title overline or transition. Treating it as ordinary text because it’s so short.}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj ubah}(h]h ]h"]h$]h&]levelKtypeINFOlineKsourcehuh1j hjz ubj )}(hhh]h)}(heUnexpected possible title overline or transition. Treating it as ordinary text because it's so short.h]hgUnexpected possible title overline or transition. Treating it as ordinary text because it’s so short.}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj ubah}(h]h ]h"]h$]h&]levelKtypej lineKsourcehuh1j hj ubetransform_messages] transformerN include_log] decorationNhhub.