import NVIDIA-FreeBSD-x86-180.29
[nvidia.git] / doc / html / chapter-05.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;5.&nbsp;Frequently Asked Questions</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-04-section-02.html" title=
15 "Manually Editing the Configuration File">
16 <link rel="next" href="chapter-06.html" title=
17 "Chapter&nbsp;6.&nbsp;Common Problems">
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;5.&nbsp;Frequently
24 Asked Questions</th>
25 </tr>
26 <tr>
27 <td width="20%" align="left"><a accesskey="p" href=
28 "chapter-04-section-02.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-06.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="faq" id=
41 "faq"></a>Chapter&nbsp;5.&nbsp;Frequently Asked Questions</h2>
42 </div>
43 </div>
44 </div>
45 <p>This section provides answers to frequently asked questions
46 associated with the NVIDIA FreeBSD x86 Driver and its installation.
47 Common problem diagnoses can be found in <a href="chapter-06.html"
48 title="Chapter&nbsp;6.&nbsp;Common Problems">Chapter&nbsp;6,
49 <i>Common Problems</i></a> and tips for new users can be found in
50 <a href="appendix-l.html" title=
51 "Appendix&nbsp;L.&nbsp;Tips for New FreeBSD Users">Appendix&nbsp;L,
52 <i>Tips for New FreeBSD Users</i></a>. Also, detailed information
53 for specific setups is provided in the <a href=
54 "part-02.html">Appendices</a>.</p>
55 <div class="qandaset">
56 <table border="0" summary="Q and A Set">
57 <col align="left" width="1%">
58 <tbody>
59 <tr class="qandadiv">
60 <td align="left" valign="top" colspan="2">
61 <h3 class="title"><a name="id2618311" id="id2618311"></a>5.1.
62 NVIDIA Driver</h3>
63 </td>
64 </tr>
65 <tr class="question">
66 <td align="left" valign="top"><a name="id2618316" id=
67 "id2618316"></a><a name="id2618318" id="id2618318"></a></td>
68 <td align="left" valign="top">
69 <p><b>Where should I start when diagnosing display
70 problems?</b></p>
71 </td>
72 </tr>
73 <tr class="answer">
74 <td align="left" valign="top"></td>
75 <td align="left" valign="top">
76 <p>One of the most useful tools for diagnosing problems is the X
77 log file in <code class="filename">/var/log</code>. Lines that
78 begin with <code class="computeroutput">(II)</code> are
79 information, <code class="computeroutput">(WW)</code> are warnings,
80 and <code class="computeroutput">(EE)</code> are errors. You should
81 make sure that the correct config file (i.e. the config file you
82 are editing) is being used; look for the line that begins with:</p>
83 <pre class="screen">
84     (==) Using config file:
85 </pre>
86 <p>Also make sure that the NVIDIA driver is being used, rather than
87 the &ldquo;<span class="quote">nv</span>&rdquo; or
88 &ldquo;<span class="quote">vesa</span>&rdquo; driver. Search
89 for</p>
90 <pre class="screen">
91     (II) LoadModule: "nvidia"
92 </pre>
93 <p>Lines from the driver should begin with:</p>
94 <pre class="screen">
95     (II) NVIDIA(0)
96 </pre>
97 <p></p>
98 </td>
99 </tr>
100 <tr class="question">
101 <td align="left" valign="top"><a name="xverboselog" id=
102 "xverboselog"></a><a name="id2620094" id="id2620094"></a></td>
103 <td align="left" valign="top">
104 <p><b>How can I increase the amount of data printed in the X log
105 file?</b></p>
106 </td>
107 </tr>
108 <tr class="answer">
109 <td align="left" valign="top"></td>
110 <td align="left" valign="top">
111 <p>By default, the NVIDIA X driver prints relatively few messages
112 to stderr and the X log file. If you need to troubleshoot, then it
113 may be helpful to enable more verbose output by using the X command
114 line options <code class="option">-verbose</code> and <code class=
115 "option">-logverbose</code>, which can be used to set the verbosity
116 level for the <code class="filename">stderr</code> and log file
117 messages, respectively. The NVIDIA X driver will output more
118 messages when the verbosity level is at or above 5 (X defaults to
119 verbosity level 1 for <code class="filename">stderr</code> and
120 level 3 for the log file). So, to enable verbose messaging from the
121 NVIDIA X driver to both the log file and <code class=
122 "filename">stderr</code>, you could start X with the verbosity
123 level set to 5, by doing the following</p>
124 <pre class="screen">
125     % startx -- -verbose 5 -logverbose 5
126 </pre>
127 <p></p>
128 </td>
129 </tr>
130 <tr class="question">
131 <td align="left" valign="top"><a name="id2620134" id=
132 "id2620134"></a><a name="id2620136" id="id2620136"></a></td>
133 <td align="left" valign="top">
134 <p><b>I have read that the NVIDIA FreeBSD Driver is not a native
135 driver, but sits on top of the Linux ABI compatibility layer. Is
136 this true?</b></p>
137 </td>
138 </tr>
139 <tr class="answer">
140 <td align="left" valign="top"></td>
141 <td align="left" valign="top">
142 <p>No, the NVIDIA FreeBSD Graphics Driver is a native driver. It
143 does provide Linux OpenGL libraries in addition to the native,
144 FreeBSD libraries to enable users to run Linux OpenGL
145 applications.</p>
146 </td>
147 </tr>
148 <tr class="question">
149 <td align="left" valign="top"><a name="id2620214" id=
150 "id2620214"></a><a name="id2620216" id="id2620216"></a></td>
151 <td align="left" valign="top">
152 <p><b>Is the NVIDIA FreeBSD Accelerated Graphics Driver
153 thread-safe?</b></p>
154 </td>
155 </tr>
156 <tr class="answer">
157 <td align="left" valign="top"></td>
158 <td align="left" valign="top">
159 <p>This release is thread-safe on FreeBSD 5.3 or later systems
160 making use of the libpthread or libthr KSE threading libraries. On
161 these systems, the NVIDIA Linux ABI compatibility libraries are
162 fully thread-safe as well.</p>
163 </td>
164 </tr>
165 <tr class="question">
166 <td align="left" valign="top"><a name="id2620226" id=
167 "id2620226"></a><a name="id2620228" id="id2620228"></a></td>
168 <td align="left" valign="top">
169 <p><b>Why can't the Linux compatibility libraries correctly
170 determine if they are used in a multithreaded application?</b></p>
171 </td>
172 </tr>
173 <tr class="answer">
174 <td align="left" valign="top"></td>
175 <td align="left" valign="top">
176 <p>The Linux compatibility libraries are not able to correctly
177 determine if they are used in a multithreaded application because
178 the %gs segment register is not initialized correctly for Linux
179 compatibility.</p>
180 <p>The <code class="envar">__GL_SINGLE_THREADED</code> environment
181 variable (set to "1") can be used to work around this issue, but at
182 the cost of thread-safeness.</p>
183 </td>
184 </tr>
185 <tr class="question">
186 <td align="left" valign="top"><a name="id2620187" id=
187 "id2620187"></a><a name="id2620189" id="id2620189"></a></td>
188 <td align="left" valign="top">
189 <p><b>Why do applications that use DGA graphics fail?</b></p>
190 </td>
191 </tr>
192 <tr class="answer">
193 <td align="left" valign="top"></td>
194 <td align="left" valign="top">
195 <p>The NVIDIA driver does not support the graphics component of the
196 XFree86-DGA (Direct Graphics Access) extension. Applications can
197 use the XDGASelectInput() function to acquire relative pointer
198 motion, but graphics-related functions such as XDGASetMode() and
199 XDGAOpenFramebuffer() will fail.</p>
200 <p>The graphics component of XFree86-DGA is not supported because
201 it requires a CPU mapping of framebuffer memory. As graphics cards
202 ship with increasing quantities of video memory, the NVIDIA X
203 driver has had to switch to a more dynamic memory mapping scheme
204 that is incompatible with DGA. Furthermore, DGA does not cooperate
205 with other graphics rendering libraries such as Xlib and OpenGL
206 because it accesses GPU resources directly.</p>
207 <p>NVIDIA recommends that applications use OpenGL or Xlib, rather
208 than DGA, for graphics rendering. Using rendering libraries other
209 than DGA will yield better performance and improve interoperability
210 with other X applications.</p>
211 </td>
212 </tr>
213 <tr class="question">
214 <td align="left" valign="top"><a name="id2620208" id=
215 "id2620208"></a><a name="id2620210" id="id2620210"></a></td>
216 <td align="left" valign="top">
217 <p><b>My kernel log contains messages that are prefixed with "Xid";
218 what do these messages mean?</b></p>
219 </td>
220 </tr>
221 <tr class="answer">
222 <td align="left" valign="top"></td>
223 <td align="left" valign="top">
224 <p>"Xid" messages indicate that a general GPU error occurred, most
225 often due to the driver misprogramming the GPU or to corruption of
226 the commands sent to the GPU. These messages provide diagnostic
227 information that can be used by NVIDIA to aid in debugging reported
228 problems.</p>
229 </td>
230 </tr>
231 <tr class="question">
232 <td align="left" valign="top"><a name="id2620698" id=
233 "id2620698"></a><a name="id2620700" id="id2620700"></a></td>
234 <td align="left" valign="top">
235 <p><b>On what NVIDIA hardware is the EXT_framebuffer_object OpenGL
236 extension supported?</b></p>
237 </td>
238 </tr>
239 <tr class="answer">
240 <td align="left" valign="top"></td>
241 <td align="left" valign="top">
242 <p>EXT_framebuffer_object is supported on GeForce FX, Quadro FX,
243 and newer GPUs.</p>
244 </td>
245 </tr>
246 <tr class="question">
247 <td align="left" valign="top"><a name="id2620710" id=
248 "id2620710"></a><a name="id2620712" id="id2620712"></a></td>
249 <td align="left" valign="top">
250 <p><b>I use the Coolbits overclocking interface to adjust my
251 graphics card's clock frequencies, but the defaults are reset
252 whenever X is restarted. How do I make my changes
253 persistent?</b></p>
254 </td>
255 </tr>
256 <tr class="answer">
257 <td align="left" valign="top"></td>
258 <td align="left" valign="top">
259 <p>Clock frequency settings are not saved/restored automatically by
260 default to avoid potential stability and other problems that may be
261 encountered if the chosen frequency settings differ from the
262 defaults qualified by the manufacturer. You can use the command
263 line below in <code class="filename">~/.xinitrc</code> to
264 automatically apply custom clock frequency settings when the X
265 server is started:</p>
266 <pre class="screen">
267     # nvidia-settings -a GPUOverclockingState=1 -a GPU2DClockFreqs=&lt;GPU&gt;,&lt;MEM&gt; -a GPU3DClockFreqs=&lt;GPU&gt;,&lt;MEM&gt;
268 </pre>
269 <p>Here <code class="filename">&lt;GPU&gt;</code> and <code class=
270 "filename">&lt;MEM&gt;</code> are the desired GPU and video memory
271 frequencies (in MHz), respectively.</p>
272 </td>
273 </tr>
274 <tr class="question">
275 <td align="left" valign="top"><a name="id2620744" id=
276 "id2620744"></a><a name="id2620746" id="id2620746"></a></td>
277 <td align="left" valign="top">
278 <p><b>Why is the refresh rate not reported correctly by utilities
279 that use the XRandR X extension (e.g., the GNOME "Screen Resolution
280 Preferences" panel, `xrandr -q`, etc)?</b></p>
281 </td>
282 </tr>
283 <tr class="answer">
284 <td align="left" valign="top"></td>
285 <td align="left" valign="top">
286 <p>The XRandR X extension is not presently aware of multiple
287 display devices on a single X screen; it only sees the MetaMode
288 bounding box, which may contain one or more actual modes. This
289 means that if multiple MetaModes have the same bounding box, XRandR
290 will not be able to distinguish between them.</p>
291 <p>In order to support DynamicTwinView, the NVIDIA X driver must
292 make each MetaMode appear to be unique to XRandR. Presently, the
293 NVIDIA X driver accomplishes this by using the refresh rate as a
294 unique identifier.</p>
295 <p>You can use `nvidia-settings -q RefreshRate` to query the actual
296 refresh rate on each display device.</p>
297 <p>This behavior can be disabled by setting the X configuration
298 option "DynamicTwinView" to FALSE.</p>
299 <p>For details, see <a href="chapter-10.html" title=
300 "Chapter&nbsp;10.&nbsp;Configuring TwinView">Chapter&nbsp;10,
301 <i>Configuring TwinView</i></a>.</p>
302 </td>
303 </tr>
304 <tr class="question">
305 <td align="left" valign="top"><a name="id2620841" id=
306 "id2620841"></a><a name="id2620843" id="id2620843"></a></td>
307 <td align="left" valign="top">
308 <p><b>Why does starting certain applications result in Xlib error
309 messages indicating extensions like "XFree86-VidModeExtension" or
310 "SHAPE" are missing?</b></p>
311 </td>
312 </tr>
313 <tr class="answer">
314 <td align="left" valign="top"></td>
315 <td align="left" valign="top">
316 <p>If your X config file has a <code class=
317 "computeroutput">Module</code> section that does not list the
318 "extmod" module, some X server extensions may be missing, resulting
319 in error messages of the form:</p>
320 <pre class="screen">
321 Xlib: extension "SHAPE" missing on display ":0.0"
322 Xlib: extension "XFree86-VidModeExtension" missing on display ":0.0"
323 Xlib: extension "XFree86-DGA" missing on display ":0.0"
324 </pre>
325 <p>You can solve this problem by adding the line below to your X
326 config file's <code class="computeroutput">Module</code>
327 section:</p>
328 <pre class="screen">
329     Load "extmod"
330 </pre>
331 <p></p>
332 </td>
333 </tr>
334 </tbody>
335 </table>
336 </div>
337 </div>
338 <div class="navfooter">
339 <hr>
340 <table width="100%" summary="Navigation footer">
341 <tr>
342 <td width="40%" align="left"><a accesskey="p" href=
343 "chapter-04-section-02.html">Prev</a>&nbsp;</td>
344 <td width="20%" align="center"><a accesskey="u" href=
345 "part-01.html">Up</a></td>
346 <td width="40%" align="right">&nbsp;<a accesskey="n" href=
347 "chapter-06.html">Next</a></td>
348 </tr>
349 <tr>
350 <td width="40%" align="left" valign="top">Manually Editing the
351 Configuration File&nbsp;</td>
352 <td width="20%" align="center"><a accesskey="h" href=
353 "index.html">Home</a></td>
354 <td width="40%" align="right" valign="top">
355 &nbsp;Chapter&nbsp;6.&nbsp;Common Problems</td>
356 </tr>
357 </table>
358 </div>
359 </body>
360 </html>