A short documentation on what frame buffer resolutions are available,

how to change them, and a link to the Sun Frame Buffer FAQ.
Contents partially borrowed from the aforementioned FAQ.

a few tweaks and ok deraadt@

5 files changed, 348 insertions, 12 deletions

diff --git a/share/man/man4/man4.sparc/cgfourteen.4 b/share/man/man4/man4.sparc/cgfourteen.4
index 084d209ffaf..83a37df7980 100644
--- a/share/man/man4/man4.sparc/cgfourteen.4
+++ b/share/man/man4/man4.sparc/cgfourteen.4
@@ -1,4 +1,4 @@
-.\"	$OpenBSD: cgfourteen.4,v 1.16 2002/10/01 21:02:18 miod Exp $
+.\"	$OpenBSD: cgfourteen.4,v 1.17 2003/01/05 02:18:30 miod Exp $
 .\"	$NetBSD: cgfourteen.4,v 1.3 1998/06/11 08:32:20 fair Exp $
 .\"
 .\" Copyright (c) 1996 The President and Fellows of Harvard College.
@@ -41,7 +41,7 @@
 .\" Based on tcx.4,
 .\"	NetBSD: tcx.4,v 1.2 1996/06/21 22:35:06 pk Exp
 .\"
-.Dd June 23, 1996
+.Dd January 5, 2003
 .Dt CGFOURTEEN 4 sparc
 .Os
 .Sh NAME
@@ -74,6 +74,71 @@ to
 or
 .Xr boot_config 8 )
 it can be force to 8 bit mode, resulting in a faster console.
+.Sh DISPLAY RESOLUTION
+If the
+.Nm
+frame buffer is used as the console display, a different resolution than the
+default 1152x900 can be selected by changing the OpenPROM environment.
+To change the default resolution, type the following:
+.Pp
+.Em \   ok
+setenv
+.Ev Em output-device
+screen:r1280x1024x76
+.Pp
+to change to a 76Hz 1280x1024 resolution.
+.Pp
+If the
+.Nm
+frame buffer is a secondary display, or a serial console is used, the
+display resolution can not be changed without using an
+.Ev Em nvramrc
+OpenPROM script.
+Refer to the
+.Em Sun Frame Buffer FAQ
+for details.
+.Pp
+The
+.Nm
+frame buffer accepts the following resolutions:
+.Ss Supported Video Modes
+.Pp
+.Bl -tag -width screen:r1280x1024x76m -compact
+.It screen:r1152x900x66
+Standard 1152x900, with a refresh rate of 66Hz.
+.It screen:r1152x900x76
+Standard 1152x900, with a refresh rate of 76Hz.
+This is the default setting.
+.It screen:r1280x1024x66
+High res 1280x1024, with a refresh rate of 66Hz.
+.El
+.Pp
+.Ss Unsupported Video Modes
+The following video modes are supported by the hardware, but not by
+.Tn Sun .
+.Pp
+.Bl -tag -width screen:r1280x1024x76m -compact
+.It screen:r1024x768x60
+Super VGA 1024x768, with a refresh rate of 60Hz.
+.It screen:r1024x768x66
+Super VGA 1024x768, with a refresh rate of 60Hz.
+.It screen:r1024x768x70
+Super VGA 1024x768, with a refresh rate of 70Hz.
+.It screen:r1024x800x84
+1024x800, with refresh rate of 84Hz.
+.It screen:r1280x1024x76m
+High res 1280x1024, with a refresh rate of 76Hz.
+There is no typo, the
+.Sq m
+suffix is required.
+.It screen:r1600x1280x66
+High res 1600x1280, with a refresh rate of 66Hz.
+.It screen:r1920x1080x72
+1920x1080, with a refresh rate of 72Hz.
+.El
+.Pp
+Resolutions of 1280x1024, 1600x1280 and 1920x1080 are 8-bit only
+with 4MB VSIMM.
 .Sh SEE ALSO
 .Xr bwtwo 4 ,
 .Xr cgeight 4 ,
@@ -90,3 +155,7 @@ it can be force to 8 bit mode, resulting in a faster console.
 .Xr wsdisplay 4
 .Xr boot_config 8 ,
 .Xr config 8
+.Rs
+.%T Sun Frame Buffer FAQ
+.%O http://www.sunhelp.org/faq/FrameBuffer.html
+.Re
diff --git a/share/man/man4/man4.sparc/cgsix.4 b/share/man/man4/man4.sparc/cgsix.4
index 4389829f5ae..6060cedb43a 100644
--- a/share/man/man4/man4.sparc/cgsix.4
+++ b/share/man/man4/man4.sparc/cgsix.4
@@ -1,4 +1,4 @@
-.\"	$OpenBSD: cgsix.4,v 1.16 2002/10/01 21:02:19 miod Exp $
+.\"	$OpenBSD: cgsix.4,v 1.17 2003/01/05 02:18:30 miod Exp $
 .\"	$NetBSD: cgsix.4,v 1.4 1998/06/11 08:32:20 fair Exp $
 .\"
 .\" Copyright 1994
@@ -37,9 +37,8 @@
 .\" SUCH DAMAGE.
 .\"
 .\"	from: @(#)cgsix.4	8.1 (Berkeley) 2/16/94
-.\"	$Id: cgsix.4,v 1.16 2002/10/01 21:02:19 miod Exp $
 .\"
-.Dd February 16, 1994
+.Dd January 5, 2003
 .Dt CGSIX 4 sparc
 .Os
 .Sh NAME
@@ -60,6 +59,96 @@ It does not provide direct device driver entry points
 but makes its functions available via the internal
 .Xr wsdisplay 4
 interface.
+.Pp
+Different models exist, with various memory sizes and capabilities.
+The
+.Nm
+driver supports the four flavours:
+.Pp
+.Bl -item -offset indent -compact
+.It
+GX
+.It
+GX+
+.It
+Turbo GX (or TGX)
+.It
+Turbo GX+ (or TGX+)
+.El
+.Sh DISPLAY RESOLUTION
+If the
+.Nm
+frame buffer is used as the console display, a different resolution than the
+default 1152x900 can be selected by changing the OpenPROM environment.
+To change the default resolution, type the following:
+.Pp
+.Em \   ok
+setenv
+.Ev Em output-device
+screen:r1280x1024x76
+.Pp
+to change to a 76Hz 1280x1024 resolution.
+.Pp
+If the
+.Nm
+frame buffer is a secondary display, or a serial console is used, the
+display resolution can not be changed without using an
+.Ev Em nvramrc
+OpenPROM script.
+Refer to the
+.Em Sun Frame Buffer FAQ
+for details.
+.Pp
+The
+.Nm
+frame buffer accepts the following resolutions:
+.Bl -tag -width screen:r1280x1024x76 -compact
+.It screen:r1022x1000x76
+1022x1000, with a refresh rate of 76Hz.
+Only available on the SPARCstation IPX on-board frame buffer.
+.It screen:r1024x768x60
+Super VGA 1024x768, with a refresh rate of 60Hz.
+Only available on TGX and TGX+.
+.It screen:r1024x768x70
+Super VGA 1024x768, with a refresh rate of 70Hz.
+Only available on TGX and TGX+.
+.It screen:r1024x768x76
+Super VGA 1024x768, with a refresh rate of 76Hz.
+Only available on TGX and TGX+.
+.It screen:r1024x768x77
+Super VGA 1024x768, with a refresh rate of 77Hz.
+Only available on the SPARCstation LX on-board frame buffer.
+.It screen:r1024x800x74
+1024x800, with a refresh rate of 74Hz.
+Only available on TGX and TGX+.
+.It screen:r1024x800x85
+1024x800, with a refresh rate of 85Hz.
+Only available on the SPARCstation IPX on-board frame buffer,
+as well as on GX+, TGX and TGX+.
+.It screen:r1152x900x66
+Standard 1152x900, with a refresh rate of 66Hz.
+This is the default setting on the dual-slot GX models (501-1481 and 501-1645).
+.It screen:r1152x900x76
+Standard 1152x900, with a refresh rate of 76Hz.
+This is the default setting on the on-board or single-slot GX models,
+as well on TGX.
+.It screen:r1280x1024x67
+High res 1280x1024, with a refresh rate of 67Hz.
+Only available on the SPARCstation LX with the VSIMM installed,
+as well as on GX+ and TGX+.
+This is the default on GX+.
+.It screen:r1280x1024x76
+High res 1280x1024, with a refresh rate of 76Hz.
+Only available on TGX+, where this is the default setting.
+.It screen:r1600x1280x76
+High res 1600x1280, with a refresh rate of 76Hz.
+Only available on the SPARCstation LX with the VSIMM installed,
+as well as on GX+ and TGX+.
+.El
+.Pp
+The 1600x1280 resolution is not officially supported by
+.Tn Sun
+on the GX+.
 .Sh SEE ALSO
 .Xr bwtwo 4 ,
 .Xr cgeight 4 ,
@@ -75,6 +164,10 @@ interface.
 .Xr vigra 4 ,
 .Xr wscons 4 ,
 .Xr wsdisplay 4
+.Rs
+.%T Sun Frame Buffer FAQ
+.%O http://www.sunhelp.org/faq/FrameBuffer.html
+.Re
 .Sh BUGS
 Several firmware revisions of the
 .Nm cgsix ,
diff --git a/share/man/man4/man4.sparc/cgthree.4 b/share/man/man4/man4.sparc/cgthree.4
index 1c0d5a268fd..f40f527b218 100644
--- a/share/man/man4/man4.sparc/cgthree.4
+++ b/share/man/man4/man4.sparc/cgthree.4
@@ -1,4 +1,4 @@
-.\"	$OpenBSD: cgthree.4,v 1.14 2002/10/01 21:02:19 miod Exp $
+.\"	$OpenBSD: cgthree.4,v 1.15 2003/01/05 02:18:30 miod Exp $
 .\"	$NetBSD: cgthree.4,v 1.4 1998/06/11 08:32:20 fair Exp $
 .\"
 .\" Copyright (c) 1992, 1993
@@ -38,9 +38,8 @@
 .\"
 .\"	from: Header: cgthree.4,v 1.3 94/02/03 20:49:52 leres Exp
 .\"     from: @(#)cgthree.4	8.2 (Berkeley) 2/16/94
-.\"	$Id: cgthree.4,v 1.14 2002/10/01 21:02:19 miod Exp $
 .\"
-.Dd February 16, 1994
+.Dd January 5, 2003
 .Dt CGTHREE 4 sparc
 .Os
 .Sh NAME
@@ -60,6 +59,48 @@ It does not provide direct device driver entry points
 but makes its functions available via the internal
 .Xr wsdisplay 4
 interface.
+.Sh DISPLAY RESOLUTION
+If the
+.Nm
+frame buffer is used as the console display, it is possible, for some models,
+to select a different resolution than the default 1152x900 or 1024x768
+by changing the OpenPROM environment.
+To change the default resolution, type the following:
+.Pp
+.Em \   ok
+setenv
+.Ev Em output-device
+screen:r1152x1024x66
+.Pp
+to change to a 66Hz 1280x1024 resolution.
+.Pp
+If the
+.Nm
+frame buffer is a secondary display, or a serial console is used, the
+display resolution can not be changed without using an
+.Ev Em nvramrc
+OpenPROM script.
+Refer to the
+.Em Sun Frame Buffer FAQ
+for details.
+.Pp
+The
+.Nm
+frame buffer accepts the following resolutions:
+.Pp
+.Bl -tag -width screen:r1280x1024x76 -compact
+.It screen:r1024x768x77
+Super VGA 1024x768, with a refresh rate of 77Hz.
+This is the default setting on model 501-2691.
+.It screen:r1152x900x66
+Standard 1152x900, with a refresh rate of 66Hz.
+This is the default setting on older models (501-1415 and 501-8044).
+.It screen:r1152x900x76
+Standard 1152x900, with a refresh rate of 76Hz.
+This is the default setting on more recent models (501-1718 and 501-1909).
+.El
+.Pp
+Note that not all models support settings other than their default setting.
 .Sh SEE ALSO
 .Xr bwtwo 4 ,
 .Xr cgeight 4 ,
@@ -75,3 +116,7 @@ interface.
 .Xr vigra 4 ,
 .Xr wscons 4 ,
 .Xr wsdisplay 4
+.Rs
+.%T Sun Frame Buffer FAQ
+.%O http://www.sunhelp.org/faq/FrameBuffer.html
+.Re
diff --git a/share/man/man4/man4.sparc64/cgsix.4 b/share/man/man4/man4.sparc64/cgsix.4
index fcbc96b3c34..b2d1e29ddb8 100644
--- a/share/man/man4/man4.sparc64/cgsix.4
+++ b/share/man/man4/man4.sparc64/cgsix.4
@@ -1,4 +1,4 @@
-.\"	$OpenBSD: cgsix.4,v 1.6 2002/10/01 21:03:27 miod Exp $
+.\"	$OpenBSD: cgsix.4,v 1.7 2003/01/05 02:18:33 miod Exp $
 .\"
 .\" Copyright (c) 2001 Jason L. Wright (jason@thought.net)
 .\" All rights reserved.
@@ -29,7 +29,7 @@
 .\" ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
 .\" POSSIBILITY OF SUCH DAMAGE.
 .\"
-.Dd December 4, 2001
+.Dd January 5, 2003
 .Dt CGSIX 4 sparc64
 .Os
 .Sh NAME
@@ -49,6 +49,21 @@ but makes its functions available via the internal
 .Xr wsdisplay 4
 interface.
 .Pp
+Different models exist, with various memory sizes and capabilities.
+The
+.Nm
+driver supports the four flavours:
+.Bl -item -offset indent -compact
+.It
+GX
+.It
+GX+
+.It
+Turbo GX (or TGX)
+.It
+Turbo GX+ (or TGX+)
+.El
+.Pp
 By default hardware acceleration is used to erase the screen and
 scroll text.
 By setting
@@ -60,6 +75,70 @@ to
 or
 .Xr boot_config 8 )
 this acceleration can be disabled.
+.Sh DISPLAY RESOLUTION
+If the
+.Nm
+frame buffer is used as the console display, a different resolution than the
+default 1152x900 can be selected by changing the OpenPROM environment.
+To change the default resolution, type the following:
+.Pp
+.Em \   ok
+setenv
+.Ev Em output-device
+screen:r1280x1024x76
+.Pp
+to change to a 76Hz 1280x1024 resolution.
+.Pp
+If the
+.Nm
+frame buffer is a secondary display, or a serial console is used, the
+display resolution can not be changed without using an
+.Ev Em nvramrc
+OpenPROM script.
+Refer to the
+.Em Sun Frame Buffer FAQ
+for details.
+.Pp
+The
+.Nm
+frame buffer accepts the following resolutions:
+.Pp
+.Bl -tag -width screen:r1280x1024x76 -compact
+.It screen:r1024x768x60
+Super VGA 1024x768, with a refresh rate of 60Hz.
+Only available on TGX and TGX+.
+.It screen:r1024x768x70
+Super VGA 1024x768, with a refresh rate of 70Hz.
+Only available on TGX and TGX+.
+.It screen:r1024x768x76
+Super VGA 1024x768, with a refresh rate of 76Hz.
+Only available on TGX and TGX+.
+.It screen:r1024x800x74
+1024x800, with a refresh rate of 74Hz.
+Only available on TGX and TGX+.
+.It screen:r1024x800x85
+1024x800, with a refresh rate of 85Hz.
+Only available on GX+, TGX and TGX+.
+.It screen:r1152x900x66
+Standard 1152x900, with a refresh rate of 66Hz.
+.It screen:r1152x900x76
+Standard 1152x900, with a refresh rate of 76Hz.
+This is the default setting on GX and TGX.
+.It screen:r1280x1024x67
+High res 1280x1024, with a refresh rate of 67Hz.
+Only available on GX+ and TGX+.
+This is the default on GX+.
+.It screen:r1280x1024x76
+High res 1280x1024, with a refresh rate of 76Hz.
+Only available on TGX+, where this is the default setting.
+.It screen:r1600x1280x76
+High res 1600x1280, with a refresh rate of 76Hz.
+Only available on GX+ and TGX+.
+.El
+.Pp
+The 1600x1280 resolution is not officially supported by
+.Tn Sun
+on the GX+.
 .Sh SEE ALSO
 .Xr bwtwo 4 ,
 .Xr cgthree 4 ,
@@ -71,3 +150,7 @@ this acceleration can be disabled.
 .Xr wsdisplay 4 ,
 .Xr boot_config 8 ,
 .Xr config 8
+.Rs
+.%T Sun Frame Buffer FAQ
+.%O http://www.sunhelp.org/faq/FrameBuffer.html
+.Re
diff --git a/share/man/man4/man4.sparc64/cgthree.4 b/share/man/man4/man4.sparc64/cgthree.4
index 11ea8836f57..0617ba99443 100644
--- a/share/man/man4/man4.sparc64/cgthree.4
+++ b/share/man/man4/man4.sparc64/cgthree.4
@@ -1,4 +1,4 @@
-.\"	$OpenBSD: cgthree.4,v 1.5 2002/10/01 21:03:27 miod Exp $
+.\"	$OpenBSD: cgthree.4,v 1.6 2003/01/05 02:18:33 miod Exp $
 .\"
 .\" Copyright (c) 2001 Jason L. Wright (jason@thought.net)
 .\" All rights reserved.
@@ -29,7 +29,7 @@
 .\" ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
 .\" POSSIBILITY OF SUCH DAMAGE.
 .\"
-.Dd December 4, 2001
+.Dd January 5, 2003
 .Dt CGTHREE 4 sparc64
 .Os
 .Sh NAME
@@ -48,6 +48,48 @@ It does not provide direct device driver entry points
 but makes its functions available via the internal
 .Xr wsdisplay 4
 interface.
+.Sh DISPLAY RESOLUTION
+If the
+.Nm
+frame buffer is used as the console display, it is possible, for some models,
+to select a different resolution than the default 1152x900 or 1024x768
+by changing the OpenPROM environment.
+To change the default resolution, type the following:
+.Pp
+.Em \   ok
+setenv
+.Ev Em output-device
+screen:r1152x1024x66
+.Pp
+to change to a 66Hz 1280x1024 resolution.
+.Pp
+If the
+.Nm
+frame buffer is a secondary display, or a serial console is used, the
+display resolution can not be changed without using an
+.Ev Em nvramrc
+OpenPROM script.
+Refer to the
+.Em Sun Frame Buffer FAQ
+for details.
+.Pp
+The
+.Nm
+frame buffer accepts the following resolutions:
+.Pp
+.Bl -tag -width screen:r1280x1024x76 -compact
+.It screen:r1024x768x77
+Super VGA 1024x768, with a refresh rate of 77Hz.
+This is the default setting on model 501-2691.
+.It screen:r1152x900x66
+Standard 1152x900, with a refresh rate of 66Hz.
+This is the default setting on older models (501-1415 and 501-8044).
+.It screen:r1152x900x76
+Standard 1152x900, with a refresh rate of 76Hz.
+This is the default setting on more recent models (501-1718 and 501-1909).
+.El
+.Pp
+Note that not all models support settings other than their default setting.
 .Sh SEE ALSO
 .Xr bwtwo 4 ,
 .Xr cgsix 4 ,
@@ -57,3 +99,7 @@ interface.
 .Xr vgafb 4 ,
 .Xr wscons 4 ,
 .Xr wsdisplay 4
+.Rs
+.%T Sun Frame Buffer FAQ
+.%O http://www.sunhelp.org/faq/FrameBuffer.html
+.Re