From owner-freebsd-doc@FreeBSD.ORG Tue Oct 9 02:30:02 2007 Return-Path: Delivered-To: freebsd-doc@hub.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id 2A83816A420 for ; Tue, 9 Oct 2007 02:30:02 +0000 (UTC) (envelope-from gnats@FreeBSD.org) Received: from freefall.freebsd.org (freefall.freebsd.org [IPv6:2001:4f8:fff6::28]) by mx1.freebsd.org (Postfix) with ESMTP id 0EE9B13C44B for ; Tue, 9 Oct 2007 02:30:02 +0000 (UTC) (envelope-from gnats@FreeBSD.org) Received: from freefall.freebsd.org (gnats@localhost [127.0.0.1]) by freefall.freebsd.org (8.14.1/8.14.1) with ESMTP id l992U1vI037759 for ; Tue, 9 Oct 2007 02:30:01 GMT (envelope-from gnats@freefall.freebsd.org) Received: (from gnats@localhost) by freefall.freebsd.org (8.14.1/8.14.1/Submit) id l992U1wR037758; Tue, 9 Oct 2007 02:30:01 GMT (envelope-from gnats) Resent-Date: Tue, 9 Oct 2007 02:30:01 GMT Resent-Message-Id: <200710090230.l992U1wR037758@freefall.freebsd.org> Resent-From: FreeBSD-gnats-submit@FreeBSD.org (GNATS Filer) Resent-To: freebsd-doc@FreeBSD.org Resent-Reply-To: FreeBSD-gnats-submit@FreeBSD.org, Chess Griffin Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id B8FCF16A419 for ; Tue, 9 Oct 2007 02:25:56 +0000 (UTC) (envelope-from nobody@FreeBSD.org) Received: from www.freebsd.org (www.freebsd.org [IPv6:2001:4f8:fff6::21]) by mx1.freebsd.org (Postfix) with ESMTP id 9F41B13C4A8 for ; Tue, 9 Oct 2007 02:25:56 +0000 (UTC) (envelope-from nobody@FreeBSD.org) Received: from www.freebsd.org (localhost [127.0.0.1]) by www.freebsd.org (8.14.1/8.14.1) with ESMTP id l992Pudc085228 for ; Tue, 9 Oct 2007 02:25:56 GMT (envelope-from nobody@www.freebsd.org) Received: (from nobody@localhost) by www.freebsd.org (8.14.1/8.14.1/Submit) id l992Puw9085227; Tue, 9 Oct 2007 02:25:56 GMT (envelope-from nobody) Message-Id: <200710090225.l992Puw9085227@www.freebsd.org> Date: Tue, 9 Oct 2007 02:25:56 GMT From: Chess Griffin To: freebsd-gnats-submit@FreeBSD.org X-Send-Pr-Version: www-3.1 Cc: Subject: docs/117035: [patch] to handbook for info on vidcontrol and console video modes X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Tue, 09 Oct 2007 02:30:02 -0000 >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 @@ Special key combinations have been reserved by FreeBSD for switching consoles - 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. + 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. . You can use AltF1, AltF2, through @@ -290,6 +290,42 @@ booting process and the programs involved. + + + Changing Console Video Modes + + 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: + + OPTIONS VESA +OPTIONS SC_PIXEL_MODE + + 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: + + &prompt.root; vidcontrol -i mode + + 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: + + &prompt.root; vidcontrol MODE_279 + + If the new video mode is acceptable, it can be permanently + set on boot by including the following in your + /etc/rc.conf file, again using the above + example: + + allscreens_flags="MODE_279" + + >How-To-Repeat: >Fix: >Release-Note: >Audit-Trail: >Unformatted: