← Back to branch summary

~sbeattie/ubuntu/lucid/vnc4/lp556147

« back to all changes in this revision

Viewing changes to unix/xc/programs/Xserver/hw/xfree86/drivers/chips/chips.man

  • Committer: Bazaar Package Importer
  • Author(s): Ola Lundqvist
  • Date: 2006-05-15 20:35:17 UTC
  • mfrom: (1.1.2 upstream)
  • Revision ID: james.westby@ubuntu.com-20060515203517-l4lre1ku942mn26k
Tags: 4.1.1+X4.3.0-10
* Correction of critical security issue. Thanks to Martin Kogler
  <e9925248@student.tuwien.ac.at> that informed me about the issue,
  and provided the patch.
  This flaw was originally found by Steve Wiseman of intelliadmin.com.
* Applied patch from Javier Kohen <jkohen@users.sourceforge.net> that
  inform the user that only 8 first characters of the password will
  actually be used when typing more than 8 characters, closes:
  #355619.

Show diffs side-by-side

added added

removed removed

Lines of Context:
unix/xc/programs/Xserver/hw/xfree86/drivers/chips/chips.man
 
1
.\" $XFree86: xc/programs/Xserver/hw/xfree86/drivers/chips/chips.man,v 1.5 2002/01/04 21:22:27 tsi Exp $
 
2
.\" shorthand for double quote that works everywhere.
 
3
.ds q \N'34'
 
4
.TH CHIPS __drivermansuffix__ __vendorversion__
 
5
.SH NAME
 
6
chips \- Chips and Technologies video driver
 
7
.SH SYNOPSIS
 
8
.nf
 
9
.B "Section \*qDevice\*q"
 
10
.BI "  Identifier \*q"  devname \*q
 
11
.B  "  Driver \*qchips\*q"
 
12
\ \ ...
 
13
.B EndSection
 
14
.fi
 
15
.SH DESCRIPTION
 
16
.B chips 
 
17
is an XFree86 driver for Chips and Technologies video processors.  The majority
 
18
of the Chips and Technologies chipsets are supported by this driver. In general
 
19
the limitation on the capabilities of this driver are determined by the 
 
20
chipset on which it is run. Where possible, this driver provides full
 
21
acceleration and supports the following depths: 1, 4, 8, 15, 16, 24 and on
 
22
the latest chipsets an 8+16 overlay mode. All visual types are supported for
 
23
depth 1, 4 and 8 and both TrueColor and DirectColor visuals are supported
 
24
where possible. Multi-head configurations are supported on PCI or AGP buses.
 
25
.SH SUPPORTED HARDWARE
 
26
The
 
27
.B chips
 
28
driver supports video processors on most of the bus types currently available.
 
29
The chipsets supported fall into one of three architectural classes. A
 
30
.B basic
 
31
architecture, the
 
32
.B WinGine
 
33
architecture and the newer
 
34
.B HiQV
 
35
architecture.
 
36
.PP
 
37
.B Basic Architecture
 
38
.PP
 
39
The supported chipsets are
 
40
.B ct65520, ct65525, ct65530, ct65535, ct65540, ct65545, ct65546
 
41
and 
 
42
.B ct65548
 
43
.PP
 
44
Color depths 1, 4 and 8 are supported on all chipsets, while depths 15, 16
 
45
and 24 are supported only on the
 
46
.B 65540, 65545, 65546
 
47
and 
 
48
.B 65548
 
49
chipsets. The driver is accelerated when used with the
 
50
.B 65545, 65546
 
51
or
 
52
.B 65548
 
53
chipsets, however the DirectColor visual is not available.
 
54
.PP
 
55
.B Wingine Architecture
 
56
.PP
 
57
The supported chipsets are
 
58
.B ct64200
 
59
and 
 
60
.B ct64300
 
61
.PP
 
62
Color depths 1, 4 and 8 are supported on both chipsets, while depths 15, 16
 
63
and 24 are supported only on the
 
64
.B 64300
 
65
chipsets. The driver is accelerated when used with the
 
66
.B 64300
 
67
chipsets, however the DirectColor visual is not available.
 
68
.PP
 
69
.B HiQV Architecture
 
70
.PP
 
71
The supported chipsets are
 
72
.B ct65550, ct65554, ct65555, ct68554, ct69000
 
73
and 
 
74
.B ct69030
 
75
.PP
 
76
Color depths 1, 4, 8, 15, 16, 24 and 8+16 are supported on all chipsets.
 
77
The DirectColor visual is supported on all color depths except the 8+16
 
78
overlay mode. Full acceleration is supplied for all chipsets.
 
79
.SH CONFIGURATION DETAILS
 
80
Please refer to XF86Config(__filemansuffix__) for general configuration
 
81
details.  This section only covers configuration details specific to this
 
82
driver.
 
83
.PP
 
84
The driver auto-detects the chipset type, but the following
 
85
.B ChipSet
 
86
names may optionally be specified in the config file
 
87
.B \*qDevice\*q
 
88
section, and will override the auto-detection:
 
89
.PP
 
90
.RS 4
 
91
"ct65520", "ct65525", "ct65530", "ct65535", "ct65540", "ct65545", "ct65546",
 
92
"ct65548", "ct65550", "ct65554", "ct65555", "ct68554", "ct69000", "ct69030",
 
93
"ct64200", "ct64300".
 
94
.RE
 
95
.PP
 
96
The driver will auto-detect the amount of video memory present for all
 
97
chipsets.  But maybe overridden with the
 
98
.B VideoRam
 
99
entry in the config file
 
100
.B \*qDevice\*q
 
101
section.
 
102
.PP
 
103
The following driver
 
104
.B Options
 
105
are supported, on one or more of the supported chipsets:
 
106
.TP
 
107
.BI "Option \*qNoAccel\*q \*q" boolean \*q
 
108
Disable or enable acceleration.  Default: acceleration is enabled.
 
109
.TP
 
110
.BI "Option \*qNoLinear\*q \*q" boolean \*q
 
111
Disables linear addressing in cases where it is enabled by default.
 
112
Default: off
 
113
.TP
 
114
.BI "Option \*qLinear\*q \*q" boolean \*q
 
115
Enables linear addressing in cases where it is disabled by default.
 
116
Default: off
 
117
.TP
 
118
.BI "Option \*qHWCursor\*q \*q" boolean \*q
 
119
Enable or disable the HW cursor.  Default: on.
 
120
.TP
 
121
.BI "Option \*qSWCursor\*q \*q" boolean \*q
 
122
Enable or disable the HW cursor.  Default: off.
 
123
.TP
 
124
.BI "Option \*qSTN\*q \*q" boolean \*q
 
125
Force detection of STN screen type. Default: off.
 
126
.TP
 
127
.BI "Option \*qUseModeline\*q \*q" boolean \*q
 
128
Reprogram flat panel timings with values from the modeline. Default: off
 
129
.TP
 
130
.BI "Option \*qFixPanelSize\*q \*q" boolean \*q
 
131
Reprogram flat panel size with values from the modeline. Default: off
 
132
.TP
 
133
.BI "Option \*qNoStretch\*q \*q" boolean \*q
 
134
This option disables the stretching on a mode on a flat panel to fill the
 
135
screen. Default: off
 
136
.TP
 
137
.BI "Option \*qLcdCenter\*q \*q" boolean \*q
 
138
Center the mode displayed on the flat panel on the screen. Default: off
 
139
.TP
 
140
.BI "Option \*qHWclocks\*q \*q" boolean \*q
 
141
Force the use of fixed hardware clocks on chips that support both fixed
 
142
and programmable clocks. Default: off
 
143
.TP
 
144
.BI "Option \*qUseVclk1\*q \*q" boolean \*q
 
145
Use the Vclk1 programmable clock on
 
146
.B HiQV
 
147
chipsets instead of Vclk2. Default: off
 
148
.TP
 
149
.BI "Option \*qFPClock8\*q \*q" float \*q
 
150
.TP
 
151
.BI "Option \*qFPClock16\*q \*q" float \*q
 
152
.TP
 
153
.BI "Option \*qFPClock24\*q \*q" float \*q
 
154
.TP
 
155
.BI "Option \*qFPClock32\*q \*q" float \*q
 
156
Force the use of a particular video clock speed for use with the 
 
157
flat panel at a specified depth
 
158
.TP
 
159
.BI "Option \*qMMIO\*q \*q" boolean \*q
 
160
Force the use of memory mapped IO for acceleration registers. Default: off
 
161
.TP
 
162
.BI "Option \*qFullMMIO\*q \*q" boolean \*q
 
163
Force the use of memory mapped IO where it can be used. Default: off
 
164
.TP
 
165
.BI "Option \*qSuspendHack\*q \*q" boolean \*q
 
166
Force driver to leave centering and stretching registers alone. This
 
167
can fix some laptop suspend/resume problems. Default: off
 
168
.TP
 
169
.BI "Option \*qOverlay\*q"
 
170
Enable 8+24 overlay mode.  Only appropriate for depth 24.  Default: off.
 
171
.TP
 
172
.BI "Option \*qColorKey\*q \*q" integer \*q
 
173
Set the colormap index used for the transparency key for the depth 8 plane
 
174
when operating in 8+16 overlay mode.  The value must be in the range
 
175
2\-255.  Default: 255.
 
176
.TP
 
177
.BI "Option \*qVideoKey\*q \*q" integer \*q
 
178
This sets the default pixel value for the YUV video overlay key.
 
179
Default: undefined.
 
180
.TP
 
181
.BI "Option \*qShadowFB\*q \*q" boolean \*q
 
182
Enable or disable use of the shadow framebuffer layer.  Default: off.
 
183
.TP
 
184
.BI "Option \*qSyncOnGreen\*q \*q" boolean \*q
 
185
Enable or disable combining the sync signals with the green signal.
 
186
Default: off.
 
187
.TP
 
188
.BI "Option \*qShowCache\*q \*q" boolean \*q
 
189
Enable or disable viewing offscreen memory. Used for debugging only
 
190
Default: off.
 
191
.TP
 
192
.BI "Option \*q18bitBus\*q \*q" boolean \*q
 
193
Force the driver to assume that the flat panel has an 18bit data bus.
 
194
Default: off.
 
195
.TP
 
196
.BI "Option \*qCrt2Memory\*q \*q" integer \*q
 
197
In a dual-head mode (69030 only) this option selects the amount of memory
 
198
to set aside for the second head. If not specified, half the memory is used.
 
199
Default: off.
 
200
.TP
 
201
.BI "Option \*qDualRefresh\*q \*q" integer \*q
 
202
The 69030 supports independent refresh rates on its two display channels.
 
203
This mode of operations uses additional memory bandwidth and thus limits
 
204
the maximum colour depth and refresh rate that can be achieved, and so is
 
205
off by default.  Using this option forces the use of an independent refresh
 
206
rate on the two screens.
 
207
Default: off.
 
208
.SH "SEE ALSO"
 
209
XFree86(1), XF86Config(__filemansuffix__), xf86config(1), Xserver(1), X(__miscmansuffix__)
 
210
.PP
 
211
You are also recommended to read the README.chips file that comes with all
 
212
XFree86 distributions, which discusses the
 
213
.B chips
 
214
driver in more detail.
 
215
.SH AUTHORS
 
216
Authors include: Jon Block, Mike Hollick, Regis Cridlig, Nozomi Ytow,
 
217
Egbert Eich, David Bateman and Xavier Ducoin
 
218