import NVIDIA-FreeBSD-x86-180.29
[nvidia.git] / doc / html / chapter-07.html
1 <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
2 <html>
3 <head>
4 <meta name="generator" content=
5 "HTML Tidy for FreeBSD (vers 1 September 2005), see www.w3.org">
6 <meta http-equiv="Content-Type" content=
7 "text/html; charset=us-ascii">
8 <title>Chapter&nbsp;7.&nbsp;Known Issues</title>
9 <meta name="generator" content="DocBook XSL Stylesheets V1.68.1">
10 <link rel="start" href="index.html" title=
11 "NVIDIA Accelerated FreeBSD Graphics Driver README and Installation Guide">
12 <link rel="up" href="part-01.html" title=
13 "Part&nbsp;I.&nbsp;Installation and Configuration Instructions">
14 <link rel="prev" href="chapter-06.html" title=
15 "Chapter&nbsp;6.&nbsp;Common Problems">
16 <link rel="next" href="chapter-08.html" title=
17 "Chapter&nbsp;8.&nbsp;Specifying OpenGL Environment Variable Settings">
18 </head>
19 <body>
20 <div class="navheader">
21 <table width="100%" summary="Navigation header">
22 <tr>
23 <th colspan="3" align="center">Chapter&nbsp;7.&nbsp;Known
24 Issues</th>
25 </tr>
26 <tr>
27 <td width="20%" align="left"><a accesskey="p" href=
28 "chapter-06.html">Prev</a>&nbsp;</td>
29 <th width="60%" align="center">Part&nbsp;I.&nbsp;Installation and
30 Configuration Instructions</th>
31 <td width="20%" align="right">&nbsp;<a accesskey="n" href=
32 "chapter-08.html">Next</a></td>
33 </tr>
34 </table>
35 <hr></div>
36 <div class="chapter" lang="en">
37 <div class="titlepage">
38 <div>
39 <div>
40 <h2 class="title"><a name="knownissues" id=
41 "knownissues"></a>Chapter&nbsp;7.&nbsp;Known Issues</h2>
42 </div>
43 </div>
44 </div>
45 <p>The following problems still exist in this release and are in
46 the process of being resolved.</p>
47 <div class="variablelist">
48 <p class="title"><b>Known Issues</b></p>
49 <dl>
50 <dt><span class="term">Notebooks</span></dt>
51 <dd>
52 <p>If you are using a notebook see the "Known Notebook Issues" in
53 <a href="chapter-15.html" title=
54 "Chapter&nbsp;15.&nbsp;Configuring a Notebook">Chapter&nbsp;15,
55 <i>Configuring a Notebook</i></a>.</p>
56 </dd>
57 <dt><span class="term">FSAA</span></dt>
58 <dd>
59 <p>When FSAA is enabled (the __GL_FSAA_MODE environment variable is
60 set to a value that enables FSAA and a multisample visual is
61 chosen), the rendering may be corrupted when resizing the
62 window.</p>
63 </dd>
64 <dt><span class="term">libGL DSO finalizer and pthreads</span></dt>
65 <dd>
66 <p>When a multithreaded OpenGL application exits, it is possible
67 for libGL's DSO finalizer (also known as the destructor, or
68 "_fini") to be called while other threads are executing OpenGL
69 code. The finalizer needs to free resources allocated by libGL.
70 This can cause problems for threads that are still using these
71 resources. Setting the environment variable "__GL_NO_DSO_FINALIZER"
72 to "1" will work around this problem by forcing libGL's finalizer
73 to leave its resources in place. These resources will still be
74 reclaimed by the operating system when the process exits. Note that
75 the finalizer is also executed as part of dlclose(3), so if you
76 have an application that dlopens(3) and dlcloses(3) libGL
77 repeatedly, "__GL_NO_DSO_FINALIZER" will cause libGL to leak
78 resources until the process exits. Using this option can improve
79 stability in some multithreaded applications, including Java3D
80 applications.</p>
81 </dd>
82 <dt><span class="term">XVideo and the Composite X
83 extension</span></dt>
84 <dd>
85 <p>XVideo will not work correctly when Composite is enabled unless
86 using X.Org 7.1 or later. See <a href="chapter-18.html" title=
87 "Chapter&nbsp;18.&nbsp;Using the X Composite Extension">Chapter&nbsp;18,
88 <i>Using the X Composite Extension</i></a>.</p>
89 </dd>
90 <dt><span class="term">GLX visuals in Xinerama</span></dt>
91 <dd>
92 <p>X servers prior to version 1.5.0 have a limitation in the number
93 of visuals that can be available when Xinerama is enabled.
94 Specifically, visuals with ID values over 255 will cause the server
95 to corrupt memory, leading to incorrect behavior or crashes. In
96 some configurations where many GLX features are enabled at once,
97 the number of GLX visuals will exceed this limit. To avoid a crash,
98 the NVIDIA X driver will discard visuals above the limit. To see
99 which visuals are being discarded, run the X server with the
100 <code class="option">-logverbose 6</code> option and then check the
101 X server log file.</p>
102 </dd>
103 </dl>
104 </div>
105 <p>This section describes problems that will not be fixed. Usually,
106 the source of the problem is beyond the control of NVIDIA.
107 Following is the list of problems:</p>
108 <div class="variablelist">
109 <p class="title"><b>Problems that Will Not Be Fixed</b></p>
110 <dl>
111 <dt><span class="term">Gigabyte GA-6BX Motherboard</span></dt>
112 <dd>
113 <p>This motherboard uses a LinFinity regulator on the 3.3 V rail
114 that is only rated to 5 A -- less than the AGP specification, which
115 requires 6 A. When diagnostics or applications are running, the
116 temperature of the regulator rises, causing the voltage to the
117 NVIDIA GPU to drop as low as 2.2 V. Under these circumstances, the
118 regulator cannot supply the current on the 3.3 V rail that the
119 NVIDIA GPU requires.</p>
120 <p>This problem does not occur when the graphics card has a
121 switching regulator or when an external power supply is connected
122 to the 3.3 V rail.</p>
123 </dd>
124 <dt><span class="term">VIA KX133 and 694X Chip sets with AGP
125 2x</span></dt>
126 <dd>
127 <p>On Athlon motherboards with the VIA KX133 or 694X chip set, such
128 as the ASUS K7V motherboard, NVIDIA drivers default to AGP 2x mode
129 to work around insufficient drive strength on one of the
130 signals.</p>
131 </dd>
132 <dt><span class="term">Irongate Chip sets with AGP 1x</span></dt>
133 <dd>
134 <p>AGP 1x transfers are used on Athlon motherboards with the
135 Irongate chipset to work around a problem with signal
136 integrity.</p>
137 </dd>
138 <dt><span class="term">ALi chipsets, ALi1541 and
139 ALi1647</span></dt>
140 <dd>
141 <p>On ALi1541 and ALi1647 chipsets, NVIDIA drivers disable AGP to
142 work around timing issues and signal integrity issues. See <a href=
143 "chapter-06.html" title=
144 "Chapter&nbsp;6.&nbsp;Common Problems">Chapter&nbsp;6, <i>Common
145 Problems</i></a> for more information on ALi chipsets.</p>
146 </dd>
147 <dt><span class="term">NV-CONTROL versions 1.8 and 1.9</span></dt>
148 <dd>
149 <p>Version 1.8 of the NV-CONTROL X Extension introduced target
150 types for setting and querying attributes as well as receiving
151 event notification on targets. Targets are objects like X Screens,
152 GPUs and G-Sync devices. Previously, all attributes were described
153 relative to an X Screen. These new bits of information (target type
154 and target id) were packed in a non-compatible way in the protocol
155 stream such that addressing X Screen 1 or higher would generate an
156 X protocol error when mixing NV-CONTROL client and server
157 versions.</p>
158 <p>This packing problem has been fixed in the NV-CONTROL 1.10
159 protocol, making it possible for the older (1.7 and prior) clients
160 to communicate with NV-CONTROL 1.10 servers. Furthermore, the
161 NV-CONTROL 1.10 client library has been updated to accommodate the
162 target protocol packing bug when communicating with a 1.8 or 1.9
163 NV-CONTROL server. This means that the NV-CONTROL 1.10 client
164 library should be able to communicate with any version of the
165 NV-CONTROL server.</p>
166 <p>NVIDIA recommends that NV-CONTROL client applications relink
167 with version 1.10 or later of the NV-CONTROL client library
168 (libXNVCtrl.a, in the nvidia-settings-1.0.tar.gz tarball). The
169 version of the client library can be determined by checking the
170 NV_CONTROL_MAJOR and NV_CONTROL_MINOR definitions in the
171 accompanying nv_control.h.</p>
172 <p>The only web released NVIDIA FreeBSD driver that is affected by
173 this problem (i.e., the only driver to use either version 1.8 or
174 1.9 of the NV-CONTROL X extension) is 1.0-8756.</p>
175 </dd>
176 </dl>
177 </div>
178 <p></p>
179 </div>
180 <div class="navfooter">
181 <hr>
182 <table width="100%" summary="Navigation footer">
183 <tr>
184 <td width="40%" align="left"><a accesskey="p" href=
185 "chapter-06.html">Prev</a>&nbsp;</td>
186 <td width="20%" align="center"><a accesskey="u" href=
187 "part-01.html">Up</a></td>
188 <td width="40%" align="right">&nbsp;<a accesskey="n" href=
189 "chapter-08.html">Next</a></td>
190 </tr>
191 <tr>
192 <td width="40%" align="left" valign="top">
193 Chapter&nbsp;6.&nbsp;Common Problems&nbsp;</td>
194 <td width="20%" align="center"><a accesskey="h" href=
195 "index.html">Home</a></td>
196 <td width="40%" align="right" valign="top">
197 &nbsp;Chapter&nbsp;8.&nbsp;Specifying OpenGL Environment Variable
198 Settings</td>
199 </tr>
200 </table>
201 </div>
202 </body>
203 </html>