xref: /openbsd/share/man/man4/man4.sparc64/cgthree.4 (revision 7b36286a)
1.\"	$OpenBSD: cgthree.4,v 1.21 2008/03/31 08:12:22 jmc Exp $
2.\"
3.\" Copyright (c) 2001 Jason L. Wright (jason@thought.net)
4.\" All rights reserved.
5.\"
6.\" Redistribution and use in source and binary forms, with or without
7.\" modification, are permitted provided that the following conditions
8.\" are met:
9.\" 1. Redistributions of source code must retain the above copyright
10.\"    notice, this list of conditions and the following disclaimer.
11.\" 2. Redistributions in binary form must reproduce the above copyright
12.\"    notice, this list of conditions and the following disclaimer in the
13.\"    documentation and/or other materials provided with the distribution.
14.\"
15.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR
16.\" IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
17.\" WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
18.\" DISCLAIMED.  IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT,
19.\" INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
20.\" (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
21.\" SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
22.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT,
23.\" STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN
24.\" ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
25.\" POSSIBILITY OF SUCH DAMAGE.
26.\"
27.Dd $Mdocdate: March 31 2008 $
28.Dt CGTHREE 4 sparc64
29.Os
30.Sh NAME
31.Nm cgthree
32.Nd 8-bit color frame buffer
33.Sh SYNOPSIS
34.Cd "cgthree* at sbus?"
35.Cd "wsdisplay* at cgthree?"
36.Sh DESCRIPTION
37The
38.Nm
39is an SBus color frame buffer.
40.Pp
41The
42.Nm
43driver interfaces the frame buffer with the
44.Xr wscons 4
45console framework.
46It does not provide direct device driver entry points
47but makes its functions available via the internal
48.Xr wsdisplay 4
49interface.
50.Sh DISPLAY RESOLUTION
51If the
52.Nm
53frame buffer is used as the console display, it is possible, for some models,
54to select a different resolution than the default 1152x900 or 1024x768
55by changing the OpenPROM environment.
56To change the default resolution, type the following:
57.Pp
58.Em \   ok
59setenv
60.Em output-device
61screen:r1152x900x66
62.Pp
63to change to a 66Hz 1152x900 resolution.
64.Pp
65If the
66.Nm
67frame buffer is a secondary display, or a serial console is used, the
68display resolution can not be changed without using an
69.Em nvramrc
70OpenPROM script.
71Refer to the
72.Em Sun Frame Buffer FAQ
73for details.
74.Pp
75The
76.Nm
77frame buffer accepts the following resolutions:
78.Pp
79.Bl -tag -width screen:r1280x1024x76 -compact
80.It screen:r1024x768x77
81Super VGA 1024x768, with a refresh rate of 77Hz.
82This is the default setting on model 501-2691.
83.It screen:r1152x900x66
84Standard 1152x900, with a refresh rate of 66Hz.
85This is the default setting on older models (501-1415 and 501-8044).
86.It screen:r1152x900x76
87Standard 1152x900, with a refresh rate of 76Hz.
88This is the default setting on more recent models (501-1718 and 501-1909).
89.El
90.Pp
91Note that not all models support settings other than their default setting.
92.Sh SEE ALSO
93.Xr intro 4 ,
94.Xr sbus 4 ,
95.Xr wscons 4 ,
96.Xr wsdisplay 4
97.Rs
98.%T Sun Frame Buffer FAQ
99.%O http://www.sunhelp.org/faq/FrameBuffer.html
100.Re
101