Date: Tue, 9 Oct 2007 02:25:56 GMT From: Chess Griffin <chess.griffin@gmail.com> To: freebsd-gnats-submit@FreeBSD.org Subject: docs/117035: [patch] to handbook for info on vidcontrol and console video modes Message-ID: <200710090225.l992Puw9085227@www.freebsd.org> Resent-Message-ID: <200710090230.l992U1wR037758@freefall.freebsd.org>
next in thread | raw e-mail | index | archive | help
>Number: 117035 >Category: docs >Synopsis: [patch] to handbook for info on vidcontrol and console video modes >Confidential: no >Severity: non-critical >Priority: low >Responsible: freebsd-doc >State: open >Quarter: >Keywords: >Date-Required: >Class: change-request >Submitter-Id: current-users >Arrival-Date: Tue Oct 09 02:30:01 GMT 2007 >Closed-Date: >Last-Modified: >Originator: Chess Griffin >Release: 7.0-CURRENT >Organization: >Environment: FreeBSD bsdbob.localdomain 7.0-CURRENT FreeBSD 7.0-CURRENT #0: Sat Oct 6 10:19:22 EDT 2007 root@bsdbob.localdomain:/usr/obj/usr/src/sys/CNG i386 >Description: The following patch adds some brief information to /home/chess/doc/en_US.ISO8859-1/books/handbook/basics/chapter.sgml concerning the default video console mode and how to change it. If patch does not print cleanly in this form, I can resend as an attachment. --- chapter.sgml.orig 2007-09-14 19:56:21.000000000 -0400 +++ chapter.sgml 2007-10-08 22:21:36.000000000 -0400 @@ -200,13 +200,13 @@ <para>Special key combinations have been reserved by FreeBSD for switching consoles<footnote> - <para>A fairly technical and accurate description of all the details - of the FreeBSD console and keyboard drivers can be found in the - manual pages of &man.syscons.4;, &man.atkbd.4;, &man.vidcontrol.1; - and &man.kbdcontrol.1;. We will not expand on the details here, - but the interested reader can always consult the manual pages for - a more detailed and thorough explanation of how things - work.</para> + <para>A fairly technical and accurate description of all the + details of the FreeBSD console and keyboard drivers can be + found in the manual pages of &man.syscons.4;, + &man.atkbd.4;, and &man.kbdcontrol.1;. We will not expand + on the details here, but the interested reader can always + consult the manual pages for a more detailed and thorough + explanation of how things work.</para> </footnote>. You can use <keycombo><keycap>Alt</keycap><keycap>F1</keycap></keycombo>, <keycombo><keycap>Alt</keycap><keycap>F2</keycap></keycombo>, through @@ -290,6 +290,42 @@ booting process and the programs involved.</para> </note> </sect2> + + <sect2 id="consoles-vidcontrol"> + <title>Changing Console Video Modes</title> + + <para>The FreeBSD console default video mode may be adjusted to + 1024x768, 1280x1024, or any other size supported by your + graphics chip and monitor. To use a different video mode, you + first must recompile your kernel and include two additional + options:</para> + + <programlisting>OPTIONS VESA +OPTIONS SC_PIXEL_MODE</programlisting> + + <para>Once the kernel has been recompiled with these two + options, you can then determine what video modes are supported + by your hardware by using the &man.vidcontrol.1; utility. To + get a list of supported video modes, type the following in a + root console:</para> + + <screen>&prompt.root; <userinput>vidcontrol -i mode</userinput></screen> + + <para>The output of this command is a list of video modes that + are supported by your hardware. You can then choose to use a + new video mode by passing it to vidcontrol in a root console, + as in this example:</para> + + <screen>&prompt.root; <userinput>vidcontrol MODE_279</userinput></screen> + + <para>If the new video mode is acceptable, it can be permanently + set on boot by including the following in your + <filename>/etc/rc.conf</filename> file, again using the above + example:</para> + + <programlisting>allscreens_flags="MODE_279"</programlisting> + + </sect2> </sect1> <sect1 id="permissions"> >How-To-Repeat: >Fix: >Release-Note: >Audit-Trail: >Unformatted:
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?200710090225.l992Puw9085227>