doc/html/chapter-09.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;9.&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-08.html" title=
  15 "Chapter&nbsp;8.&nbsp;Common Problems">
  16 <link rel="next" href="chapter-10.html" title=
  17 "Chapter&nbsp;10.&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;9.&nbsp;Known
  24 Issues</th>
  25 </tr>
  26 <tr>
  27 <td width="20%" align="left"><a accesskey="p" href=
  28 "chapter-08.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-10.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;9.&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-17.html" title=
  54 "Chapter&nbsp;17.&nbsp;Configuring a Notebook">Chapter&nbsp;17,
  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-22.html" title=
  87 "Chapter&nbsp;22.&nbsp;Using the X Composite Extension">Chapter&nbsp;22,
  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 <dt><a name="xserver_needs_busids" id=
 104 "xserver_needs_busids"></a><span class="term">Some X servers have
 105 trouble with multiple GPUs</span></dt>
 106 <dd>
 107 <p>Some versions of the X.Org server version 1.5.0 and higher have
 108 a bug that causes X to fail with an error similar to the following
 109 when there is more than one GPU in the computer:</p>
 110 <pre class="screen">
 111 (!!) More than one possible primary device found
 112 (II) Primary Device is:
 113 (EE) No devices detected.
 114
 115 Fatal server error:
 116 no screens found
 117 </pre>
 118 <p>You can work around this problem by specifying the bus ID of the
 119 device you wish to use. For more details, please search the
 120 xorg.conf manual page for "BusID". You can configure the X server
 121 with an X screen on each NVIDIA GPU by running:</p>
 122 <pre class="screen">
 123 nvidia-xconfig --enable-all-gpus
 124 </pre>
 125 <p></p>
 126 <p>Please see <a href=
 127 "http://bugs.freedesktop.org/show_bug.cgi?id=18321" target=
 128 "_top">Bugzilla bug #18321</a> for more details on this X server
 129 problem.</p>
 130 </dd>
 131 </dl>
 132 </div>
 133 <p>This section describes problems that will not be fixed. Usually,
 134 the source of the problem is beyond the control of NVIDIA.
 135 Following is the list of problems:</p>
 136 <div class="variablelist">
 137 <p class="title"><b>Problems that Will Not Be Fixed</b></p>
 138 <dl>
 139 <dt><span class="term">Gigabyte GA-6BX Motherboard</span></dt>
 140 <dd>
 141 <p>This motherboard uses a LinFinity regulator on the 3.3 V rail
 142 that is only rated to 5 A -- less than the AGP specification, which
 143 requires 6 A. When diagnostics or applications are running, the
 144 temperature of the regulator rises, causing the voltage to the
 145 NVIDIA GPU to drop as low as 2.2 V. Under these circumstances, the
 146 regulator cannot supply the current on the 3.3 V rail that the
 147 NVIDIA GPU requires.</p>
 148 <p>This problem does not occur when the graphics card has a
 149 switching regulator or when an external power supply is connected
 150 to the 3.3 V rail.</p>
 151 </dd>
 152 <dt><span class="term">VIA KX133 and 694X Chip sets with AGP
 153 2x</span></dt>
 154 <dd>
 155 <p>On Athlon motherboards with the VIA KX133 or 694X chip set, such
 156 as the ASUS K7V motherboard, NVIDIA drivers default to AGP 2x mode
 157 to work around insufficient drive strength on one of the
 158 signals.</p>
 159 </dd>
 160 <dt><span class="term">Irongate Chip sets with AGP 1x</span></dt>
 161 <dd>
 162 <p>AGP 1x transfers are used on Athlon motherboards with the
 163 Irongate chipset to work around a problem with signal
 164 integrity.</p>
 165 </dd>
 166 <dt><span class="term">ALi chipsets, ALi1541 and
 167 ALi1647</span></dt>
 168 <dd>
 169 <p>On ALi1541 and ALi1647 chipsets, NVIDIA drivers disable AGP to
 170 work around timing issues and signal integrity issues. See <a href=
 171 "chapter-08.html" title=
 172 "Chapter&nbsp;8.&nbsp;Common Problems">Chapter&nbsp;8, <i>Common
 173 Problems</i></a> for more information on ALi chipsets.</p>
 174 </dd>
 175 <dt><span class="term">NV-CONTROL versions 1.8 and 1.9</span></dt>
 176 <dd>
 177 <p>Version 1.8 of the NV-CONTROL X Extension introduced target
 178 types for setting and querying attributes as well as receiving
 179 event notification on targets. Targets are objects like X Screens,
 180 GPUs and G-Sync devices. Previously, all attributes were described
 181 relative to an X Screen. These new bits of information (target type
 182 and target id) were packed in a non-compatible way in the protocol
 183 stream such that addressing X Screen 1 or higher would generate an
 184 X protocol error when mixing NV-CONTROL client and server
 185 versions.</p>
 186 <p>This packing problem has been fixed in the NV-CONTROL 1.10
 187 protocol, making it possible for the older (1.7 and prior) clients
 188 to communicate with NV-CONTROL 1.10 servers. Furthermore, the
 189 NV-CONTROL 1.10 client library has been updated to accommodate the
 190 target protocol packing bug when communicating with a 1.8 or 1.9
 191 NV-CONTROL server. This means that the NV-CONTROL 1.10 client
 192 library should be able to communicate with any version of the
 193 NV-CONTROL server.</p>
 194 <p>NVIDIA recommends that NV-CONTROL client applications relink
 195 with version 1.10 or later of the NV-CONTROL client library
 196 (libXNVCtrl.a, in the nvidia-settings-1.0.tar.gz tarball). The
 197 version of the client library can be determined by checking the
 198 NV_CONTROL_MAJOR and NV_CONTROL_MINOR definitions in the
 199 accompanying nv_control.h.</p>
 200 <p>The only web released NVIDIA FreeBSD driver that is affected by
 201 this problem (i.e., the only driver to use either version 1.8 or
 202 1.9 of the NV-CONTROL X extension) is 1.0-8756.</p>
 203 </dd>
 204 <dt><span class="term">CPU throttling reducing memory bandwidth on
 205 IGP systems</span></dt>
 206 <dd>
 207 <p>For some models of CPU, the CPU throttling technology may affect
 208 not only CPU core frequency, but also memory frequency/bandwidth.
 209 On systems using integrated graphics, any reduction in memory
 210 bandwidth will affect the GPU as well as the CPU. This can
 211 negatively affect applications that use significant memory
 212 bandwidth, such as video decoding using VDPAU, or certain OpenGL
 213 operations. This may cause such applications to run with lower
 214 performance than desired.</p>
 215 <p>To work around this problem, NVIDIA recommends configuring your
 216 CPU throttling implementation to avoid reducing memory bandwidth.
 217 This may be as simple as setting a certain minimum frequency for
 218 the CPU.</p>
 219 <p>Depending on your operating system and/or distribution, this may
 220 be as simple as writing to a configuration file in the /sys or
 221 /proc filesystems, or other system configuration file. Please read,
 222 or search the Internet for, documentation regarding CPU throttling
 223 on your operating system.</p>
 224 </dd>
 225 <dt><span class="term">VDPAU initialization failures on supported
 226 GPUs</span></dt>
 227 <dd>
 228 <p>If VDPAU gives the VDP_STATUS_NO_IMPLEMENTATION error message on
 229 a GPU which was labeled or specified as supporting PureVideo or
 230 PureVideo HD, one possible reason is a hardware defect. After
 231 ruling out any other software problems, NVIDIA recommends returning
 232 the GPU to the manufacturer for a replacement.</p>
 233 </dd>
 234 <dt><a name="extension_string_size" id=
 235 "extension_string_size"></a><span class="term">Some applications,
 236 such as Quake 3, crash after querying the OpenGL extension
 237 string</span></dt>
 238 <dd>
 239 <p>Some applications have bugs that are triggered when the
 240 extension string is longer than a certain size. As more features
 241 are added to the driver, the length of this string increases and
 242 can trigger these sorts of bugs.</p>
 243 <p>You can limit the extensions listed in the OpenGL extension
 244 string to the ones that appeared in a particular version of the
 245 driver by setting the <code class=
 246 "computeroutput">__GL_ExtensionStringVersion</code> environment
 247 variable to a particular version number. For example,</p>
 248 <pre class="screen">
 249 __GL_ExtensionStringVersion=17700 quake3
 250 </pre>
 251 <p>will run Quake 3 with the extension string that appeared in the
 252 177.* driver series. Limiting the size of the extension string can
 253 work around this sort of application bug.</p>
 254 </dd>
 255 </dl>
 256 </div>
 257 <p></p>
 258 </div>
 259 <div class="navfooter">
 260 <hr>
 261 <table width="100%" summary="Navigation footer">
 262 <tr>
 263 <td width="40%" align="left"><a accesskey="p" href=
 264 "chapter-08.html">Prev</a>&nbsp;</td>
 265 <td width="20%" align="center"><a accesskey="u" href=
 266 "part-01.html">Up</a></td>
 267 <td width="40%" align="right">&nbsp;<a accesskey="n" href=
 268 "chapter-10.html">Next</a></td>
 269 </tr>
 270 <tr>
 271 <td width="40%" align="left" valign="top">
 272 Chapter&nbsp;8.&nbsp;Common Problems&nbsp;</td>
 273 <td width="20%" align="center"><a accesskey="h" href=
 274 "index.html">Home</a></td>
 275 <td width="40%" align="right" valign="top">
 276 &nbsp;Chapter&nbsp;10.&nbsp;Specifying OpenGL Environment Variable
 277 Settings</td>
 278 </tr>
 279 </table>
 280 </div>
 281 </body>
 282 </html>