import NVIDIA-FreeBSD-x86-180.29
[nvidia.git] / doc / html / chapter-06.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;6.&nbsp;Common Problems</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-05.html" title=
15 "Chapter&nbsp;5.&nbsp;Frequently Asked Questions">
16 <link rel="next" href="chapter-07.html" title=
17 "Chapter&nbsp;7.&nbsp;Known Issues">
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;6.&nbsp;Common
24 Problems</th>
25 </tr>
26 <tr>
27 <td width="20%" align="left"><a accesskey="p" href=
28 "chapter-05.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-07.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="commonproblems" id=
41 "commonproblems"></a>Chapter&nbsp;6.&nbsp;Common Problems</h2>
42 </div>
43 </div>
44 </div>
45 <p>This section provides solutions to common problems associated
46 with the NVIDIA FreeBSD x86 Driver.</p>
47 <div class="qandaset">
48 <table border="0" summary="Q and A Set">
49 <col align="left" width="1%">
50 <tbody>
51 <tr class="question">
52 <td align="left" valign="top"><a name="id2619372" id=
53 "id2619372"></a><a name="id2619374" id="id2619374"></a></td>
54 <td align="left" valign="top">
55 <p><b>My X server fails to start, and my X log file contains the
56 error:</b></p>
57 <pre class="screen">
58 (EE) NVIDIA(0): The NVIDIA kernel module does not appear to
59 (EE) NVIDIA(0):      be receiving interrupts generated by the NVIDIA graphics
60 (EE) NVIDIA(0):      device PCI:x:x:x. Please see the COMMON PROBLEMS
61 (EE) NVIDIA(0):      section in the README for additional information.
62 </pre></td>
63 </tr>
64 <tr class="answer">
65 <td align="left" valign="top"></td>
66 <td align="left" valign="top">
67 <p>This can be caused by a variety of problems, such as PCI IRQ
68 routing errors, I/O APIC problems or conflicts with other devices
69 sharing the IRQ (or their drivers).</p>
70 <p>If possible, configure your system such that your graphics card
71 does not share its IRQ with other devices (try moving the graphics
72 card to another slot if applicable, unload/disable the driver(s)
73 for the device(s) sharing the card's IRQ, or remove/disable the
74 device(s)).</p>
75 </td>
76 </tr>
77 <tr class="question">
78 <td align="left" valign="top"><a name="id2619394" id=
79 "id2619394"></a><a name="id2619396" id="id2619396"></a></td>
80 <td align="left" valign="top">
81 <p><b>My X server fails to start, and my X log file contains the
82 error:</b></p>
83 <pre class="screen">
84 (EE) NVIDIA(0): The interrupt for NVIDIA graphics device PCI:x:x:x
85 (EE) NVIDIA(0):      appears to be edge-triggered. Please see the COMMON
86 (EE) NVIDIA(0):      PROBLEMS section in the README for additional information.
87 </pre></td>
88 </tr>
89 <tr class="answer">
90 <td align="left" valign="top"></td>
91 <td align="left" valign="top">
92 <p>An edge-triggered interrupt means that the kernel has programmed
93 the interrupt as edge-triggered rather than level-triggered in the
94 Advanced Programmable Interrupt Controller (APIC). Edge-triggered
95 interrupts are not intended to be used for sharing an interrupt
96 line between multiple devices; level-triggered interrupts are the
97 intended trigger for such usage. When using edge-triggered
98 interrupts, it is common for device drivers using that interrupt
99 line to stop receiving interrupts. This would appear to the end
100 user as those devices no longer working, and potentially as a full
101 system hang. These problems tend to be more common when multiple
102 devices are sharing that interrupt line.</p>
103 </td>
104 </tr>
105 <tr class="question">
106 <td align="left" valign="top"><a name="id2619412" id=
107 "id2619412"></a><a name="id2619414" id="id2619414"></a></td>
108 <td align="left" valign="top">
109 <p><b>X starts for me, but OpenGL applications terminate
110 immediately.</b></p>
111 </td>
112 </tr>
113 <tr class="answer">
114 <td align="left" valign="top"></td>
115 <td align="left" valign="top">
116 <p>If X starts but you have trouble with OpenGL, you most likely
117 have a problem with other libraries in the way, or there are stale
118 symlinks. See <a href="appendix-b.html" title=
119 "Appendix&nbsp;B.&nbsp;Installed Components">Appendix&nbsp;B,
120 <i>Installed Components</i></a> for details.</p>
121 <p>You should also check that the correct extensions are
122 present;</p>
123 <pre class="screen">
124     % xdpyinfo
125 </pre>
126 <p>should show the &ldquo;<span class="quote">GLX</span>&rdquo; and
127 &ldquo;<span class="quote">NV-GLX</span>&rdquo; extensions present.
128 If these two extensions are not present, then there is most likely
129 a problem loading the glx module, or it is unable to implicitly
130 load GLcore. Check your X config file and make sure that you are
131 loading glx (see <a href="chapter-04.html" title=
132 "Chapter&nbsp;4.&nbsp;Configuring X for the NVIDIA Driver">Chapter&nbsp;4,
133 <i>Configuring X for the NVIDIA Driver</i></a>). If your X config
134 file is correct, then check the X log file for warnings/errors
135 pertaining to GLX. Also check that all of the necessary symlinks
136 are in place (refer to <a href="appendix-b.html" title=
137 "Appendix&nbsp;B.&nbsp;Installed Components">Appendix&nbsp;B,
138 <i>Installed Components</i></a>).</p>
139 </td>
140 </tr>
141 <tr class="question">
142 <td align="left" valign="top"><a name="id2619452" id=
143 "id2619452"></a><a name="id2619454" id="id2619454"></a></td>
144 <td align="left" valign="top">
145 <p><b>When Xinerama is enabled, my stereo glasses are shuttering
146 only when the stereo application is displayed on one specific X
147 screen. When the application is displayed on the other X screens,
148 the stereo glasses stop shuttering.</b></p>
149 </td>
150 </tr>
151 <tr class="answer">
152 <td align="left" valign="top"></td>
153 <td align="left" valign="top">
154 <p>This problem occurs with DDC and "blue line" stereo glasses,
155 that get the stereo signal from one video port of the graphics
156 card. When a X screen does not display any stereo drawable the
157 stereo signal is disabled on the associated video port.</p>
158 <p>Forcing stereo flipping allows the stereo glasses to shutter
159 continuously. This can be done by enabling the OpenGL control
160 "Force Stereo Flipping" in nvidia-settings, or by setting the X
161 configuration option "ForceStereoFlipping" to "1".</p>
162 </td>
163 </tr>
164 <tr class="question">
165 <td align="left" valign="top"><a name="id2621380" id=
166 "id2621380"></a><a name="id2621382" id="id2621382"></a></td>
167 <td align="left" valign="top">
168 <p><b>Stereo is not in sync across multiple displays.</b></p>
169 </td>
170 </tr>
171 <tr class="answer">
172 <td align="left" valign="top"></td>
173 <td align="left" valign="top">
174 <p>There are two cases where this may occur. If the displays are
175 attached to the same GPU, and one of them is out of sync with the
176 stereo glasses, you will need to reconfigure your monitors to drive
177 identical mode timings; see <a href="chapter-16.html" title=
178 "Chapter&nbsp;16.&nbsp;Programming Modes">Chapter&nbsp;16,
179 <i>Programming Modes</i></a> for details.</p>
180 <p>If the displays are attached to different GPUs, the only way to
181 synchronize stereo across the displays is with a G-Sync device,
182 which is only supported by certain Quadro cards. See <a href=
183 "chapter-21.html" title=
184 "Chapter&nbsp;21.&nbsp;Configuring Frame Lock and Genlock">Chapter&nbsp;21,
185 <i>Configuring Frame Lock and Genlock</i></a> for details. This
186 applies to seperate GPUs on seperate cards as well as seperate GPUs
187 on the same card, such as Quadro FX 4500 X2. Note that the Quadro
188 FX 4500 X2 only provides a single DIN connector for stereo, tied to
189 the bottommost GPU. In order to synchronize onboard stereo on the
190 other GPU you must use a G-Sync device.</p>
191 </td>
192 </tr>
193 <tr class="question">
194 <td align="left" valign="top"><a name="id2621413" id=
195 "id2621413"></a><a name="id2621415" id="id2621415"></a></td>
196 <td align="left" valign="top">
197 <p><b>X fails to start, and during boot up time I get error
198 messages</b></p>
199 <pre class="screen">
200 nvidia0: NVRM: NVIDIA REG resource alloc failed.
201 </pre>
202 <p><b>or</b></p>
203 <pre class="screen">
204 nvidia0: NVRM: NVIDIA IRQ resource alloc failed.
205 </pre></td>
206 </tr>
207 <tr class="answer">
208 <td align="left" valign="top"></td>
209 <td align="left" valign="top">
210 <p>The system BIOS has not properly set up your graphics card;
211 FreeBSD can't currently set up PCI devices that the BIOS leaves
212 unconfigured. Uncheck "PNP-OS" in your system BIOS.</p>
213 </td>
214 </tr>
215 <tr class="question">
216 <td align="left" valign="top"><a name="id2621438" id=
217 "id2621438"></a><a name="id2621645" id="id2621645"></a></td>
218 <td align="left" valign="top">
219 <p><b>X fails to start, and during boot up time I get the following
220 error message:</b></p>
221 <pre class="screen">
222 nvidia0: NVRM: NVIDIA MEM resource alloc failed.
223 </pre></td>
224 </tr>
225 <tr class="answer">
226 <td align="left" valign="top"></td>
227 <td align="left" valign="top">
228 <p>On certain FreeBSD kernels, it may be necessary to add the
229 following line to <code class=
230 "filename">/boot/loader.conf</code>:</p>
231 <pre class="screen">
232 hw.pci.allow_unsupported_io_range="1"
233 </pre>
234 <p>This should allow the NVIDIA kernel module to attach.</p>
235 </td>
236 </tr>
237 <tr class="question">
238 <td align="left" valign="top"><a name="id2621674" id=
239 "id2621674"></a><a name="id2621676" id="id2621676"></a></td>
240 <td align="left" valign="top">
241 <p><b>Some OpenGL applications fail to start, and my X log file
242 contains error messages of the form:</b></p>
243 <pre class="screen">
244 (EE) NVIDIA(0): Failed to obtain a shared memory identifier...
245 </pre>
246 <p><b>and/or</b></p>
247 <pre class="screen">
248 (EE) NVIDIA(0): Failed to attach to shared memory segment...
249 </pre></td>
250 </tr>
251 <tr class="answer">
252 <td align="left" valign="top"></td>
253 <td align="left" valign="top">
254 <p>The NVIDIA driver may require more IPC resources than are
255 allocated by default. If this happens, you may be able to work
256 around this problem by increasing your system's resource limits by
257 editing the file <code class="filename">/boot/loader.conf</code>
258 and adding:</p>
259 <pre class="screen">
260 kern.ipc.shmseg=1024
261 kern.ipc.shmmni=1024
262 </pre>
263 <p>The values above were chosen conservatively, you may need to
264 tweak them to meet your requirements.</p>
265 </td>
266 </tr>
267 <tr class="question">
268 <td align="left" valign="top"><a name="id2621710" id=
269 "id2621710"></a><a name="id2622668" id="id2622668"></a></td>
270 <td align="left" valign="top">
271 <p><b>My X server fails to start, and my X log file contains the
272 error:</b></p>
273 <pre class="screen">
274 (EE) NVIDIA(0): Failed to initialize the NVIDIA kernel module!
275 </pre></td>
276 </tr>
277 <tr class="answer">
278 <td align="left" valign="top"></td>
279 <td align="left" valign="top">
280 <p>Nothing will work if the NVIDIA kernel module does not function
281 properly. If you see anything in the X log file like</p>
282 <pre class="screen">
283 (EE) NVIDIA(0): Failed to initialize the NVIDIA kernel module!
284 </pre>
285 <p>then there is most likely a problem with the NVIDIA kernel
286 module.</p>
287 <p>The NVIDIA kernel module may print error messages indicating a
288 problem -- to view these messages check the output of
289 <strong class="userinput"><code>dmesg</code></strong>, <code class=
290 "filename">/var/log/messages</code>, or wherever syslog is directed
291 to place kernel messages. These messages are prepended with
292 "NVRM".</p>
293 </td>
294 </tr>
295 <tr class="question">
296 <td align="left" valign="top"><a name="id2622705" id=
297 "id2622705"></a><a name="id2622707" id="id2622707"></a></td>
298 <td align="left" valign="top">
299 <p><b>When I attempt to start `nvidia-settings`, I get an error
300 message of the form:</b></p>
301 <pre class="screen">
302  Shared object "libgtk-x11-2.0.so.400" not found, required by nvidia-settings
303 </pre></td>
304 </tr>
305 <tr class="answer">
306 <td align="left" valign="top"></td>
307 <td align="left" valign="top">
308 <p>Due to differences between the gtk+-2.x ports packages included
309 with different FreeBSD 5.x releases, the prebuilt nvidia-settings
310 binary shipped with the NVIDIA driver may not work with FreeBSD
311 releases more recent than FreeBSD 5.3.</p>
312 <p>If you have a recent ports package of gtk+-2.x and gmake
313 installed on your system, you can build the nvidia-installer
314 utility from source to solve this problem.</p>
315 <p>Download nvidia-settings-1.0.tar.gz (or the latest version) from
316 <a href="ftp://download.nvidia.com/XFree86/nvidia-settings" target=
317 "_top">ftp://download.nvidia.com/XFree86/nvidia-settings</a> You
318 can then extract, build and install it (to <code class=
319 "filename">/usr/local/bin</code>) with:</p>
320 <pre class="screen">
321     % gmake install
322 </pre>
323 <p></p>
324 </td>
325 </tr>
326 <tr class="question">
327 <td align="left" valign="top"><a name="id2622747" id=
328 "id2622747"></a><a name="id2622749" id="id2622749"></a></td>
329 <td align="left" valign="top">
330 <p><b>When I attempt to run `nvidia-xconfig` after the NVIDIA
331 FreeBSD graphics driver installation, I get an error message of the
332 form:</b></p>
333 <pre class="screen">
334 nvidia-xconfig: Command not found.
335 </pre></td>
336 </tr>
337 <tr class="answer">
338 <td align="left" valign="top"></td>
339 <td align="left" valign="top">
340 <p>Depending on the shell you are using, you may need to force it
341 to recompute its internal table of executable files present in the
342 directories listed in the <code class="envar">$PATH</code>
343 variable. Assuming you are using the FreeBSD default shell you can
344 do so by issuing the command:</p>
345 <pre class="screen">
346     % rehash
347 </pre>
348 <p></p>
349 </td>
350 </tr>
351 <tr class="question">
352 <td align="left" valign="top"><a name="id2622774" id=
353 "id2622774"></a><a name="id2622776" id="id2622776"></a></td>
354 <td align="left" valign="top">
355 <p><b>When I attempt to start a Linux application as 'root', I get
356 the error message:</b></p>
357 <pre class="screen">
358 NVIDIA: failed to execute '/sbin/modprobe': No such file or directory.
359 </pre></td>
360 </tr>
361 <tr class="answer">
362 <td align="left" valign="top"></td>
363 <td align="left" valign="top">
364 <p>When initialized by an application executed with 'root'
365 privileges, the NVIDIA Linux OpenGL library, shipped with the
366 NVIDIA FreeBSD graphics driver for Linux ABI compatibility, will
367 attempt to load the NVIDIA Linux kernel module and fail because
368 /sbin/modprobe is absent. You can work around this problem by
369 creating a symbolic link from <code class=
370 "filename">/usr/bin/true</code> to <code class=
371 "filename">/compat/linux/sbin/modprobe</code>:</p>
372 <pre class="screen">
373     % ln -s /usr/bin/true /compat/linux/sbin/modprobe
374 </pre>
375 <p></p>
376 </td>
377 </tr>
378 <tr class="question">
379 <td align="left" valign="top"><a name="id2621942" id=
380 "id2621942"></a><a name="id2621944" id="id2621944"></a></td>
381 <td align="left" valign="top">
382 <p><b>My system runs, but seems unstable.</b></p>
383 </td>
384 </tr>
385 <tr class="answer">
386 <td align="left" valign="top"></td>
387 <td align="left" valign="top">
388 <p>Your stability problems may be AGP-related. See <a href=
389 "chapter-09.html" title=
390 "Chapter&nbsp;9.&nbsp;Configuring AGP">Chapter&nbsp;9,
391 <i>Configuring AGP</i></a> for details.</p>
392 </td>
393 </tr>
394 <tr class="question">
395 <td align="left" valign="top"><a name="id2621960" id=
396 "id2621960"></a><a name="id2621962" id="id2621962"></a></td>
397 <td align="left" valign="top">
398 <p><b>OpenGL applications are running slowly</b></p>
399 </td>
400 </tr>
401 <tr class="answer">
402 <td align="left" valign="top"></td>
403 <td align="left" valign="top">
404 <p>The application is probably using a different library that still
405 remains on your system, rather than the NVIDIA supplied OpenGL
406 library. See <a href="appendix-b.html" title=
407 "Appendix&nbsp;B.&nbsp;Installed Components">Appendix&nbsp;B,
408 <i>Installed Components</i></a> for details.</p>
409 </td>
410 </tr>
411 <tr class="question">
412 <td align="left" valign="top"><a name="id2621977" id=
413 "id2621977"></a><a name="id2621979" id="id2621979"></a></td>
414 <td align="left" valign="top">
415 <p><b>There are problems running Quake2.</b></p>
416 </td>
417 </tr>
418 <tr class="answer">
419 <td align="left" valign="top"></td>
420 <td align="left" valign="top">
421 <p>Quake2 requires some minor setup to get it going. First, in the
422 Quake2 directory, the install creates a symlink called <code class=
423 "filename">libGL.so</code> that points at <code class=
424 "filename">libMesaGL.so</code>. This symlink should be removed or
425 renamed. Second, in order to run Quake2 in OpenGL mode, you must
426 type</p>
427 <pre class="screen">
428     % quake2 +set vid_ref glx +set gl_driver libGL.so
429 </pre>
430 <p>Quake2 does not seem to support any kind of full-screen mode,
431 but you can run your X server at the same resolution as Quake2 to
432 emulate full-screen mode.</p>
433 </td>
434 </tr>
435 <tr class="question">
436 <td align="left" valign="top"><a name="id2622075" id=
437 "id2622075"></a><a name="id2622077" id="id2622077"></a></td>
438 <td align="left" valign="top">
439 <p><b>I am using either nForce of nForce2 internal graphics, and I
440 see warnings like this in my X log file:</b></p>
441 <pre class="screen">
442 Not using mode "1600x1200" (exceeds valid memory bandwidth usage)
443 </pre></td>
444 </tr>
445 <tr class="answer">
446 <td align="left" valign="top"></td>
447 <td align="left" valign="top">
448 <p>Integrated graphics have more strict memory bandwidth
449 limitations that limit the resolution and refresh rate of the modes
450 you request. To work around this, you can reduce the maximum
451 refresh rate by lowering the upper value of the <code class=
452 "option">VertRefresh</code> range in the <code class=
453 "systemitem">Monitor</code> section of your X config file. Though
454 not recommended, you can disable the memory bandwidth test with the
455 <code class="option">NoBandWidthTest</code> X config file
456 option.</p>
457 </td>
458 </tr>
459 <tr class="question">
460 <td align="left" valign="top"><a name="id2622104" id=
461 "id2622104"></a><a name="id2622106" id="id2622106"></a></td>
462 <td align="left" valign="top">
463 <p><b>X takes a long time to start (possibly several
464 minutes).</b></p>
465 </td>
466 </tr>
467 <tr class="answer">
468 <td align="left" valign="top"></td>
469 <td align="left" valign="top">
470 <p>Most of the X startup delay problems we have found are caused by
471 incorrect data in video BIOSes about what display devices are
472 possibly connected or what i2c port should be used for detection.
473 You can work around these problems with the X config option
474 <code class="option">IgnoreDisplayDevices</code> (see the
475 description in <a href="appendix-f.html" title=
476 "Appendix&nbsp;F.&nbsp;X Config Options">Appendix&nbsp;F, <i>X
477 Config Options</i></a>).</p>
478 </td>
479 </tr>
480 <tr class="question">
481 <td align="left" valign="top"><a name="id2622124" id=
482 "id2622124"></a><a name="id2622126" id="id2622126"></a></td>
483 <td align="left" valign="top">
484 <p><b>Fonts are incorrectly sized after installing the NVIDIA
485 driver.</b></p>
486 </td>
487 </tr>
488 <tr class="answer">
489 <td align="left" valign="top"></td>
490 <td align="left" valign="top">
491 <p>Incorrectly sized fonts are generally caused by incorrect DPI
492 (Dots Per Inch) information. You can check what X thinks the
493 physical size of your monitor is, by running:</p>
494 <pre class="screen">
495  % xdpyinfo | grep dimensions
496 </pre>
497 <p>This will report the size in pixels, and in millimeters.</p>
498 <p>If these numbers are wrong, you can correct them by modifying
499 the X server's DPI setting. See <a href="appendix-i.html" title=
500 "Appendix&nbsp;I.&nbsp;Dots Per Inch">Appendix&nbsp;I, <i>Dots Per
501 Inch</i></a> for details.</p>
502 </td>
503 </tr>
504 <tr class="question">
505 <td align="left" valign="top"><a name="id2622151" id=
506 "id2622151"></a><a name="id2622153" id="id2622153"></a></td>
507 <td align="left" valign="top">
508 <p><b>General problems with ALi chipsets</b></p>
509 </td>
510 </tr>
511 <tr class="answer">
512 <td align="left" valign="top"></td>
513 <td align="left" valign="top">
514 <p>There are some known timing and signal integrity issues on ALi
515 chipsets. The following tips may help stabilize problematic ALI
516 systems:</p>
517 <div class="itemizedlist">
518 <ul type="disc">
519 <li>
520 <p>Disable TURBO AGP MODE in the BIOS.</p>
521 </li>
522 <li>
523 <p>When using a P5A upgrade to BIOS Revision 1002 BETA 2.</p>
524 </li>
525 <li>
526 <p>When using 1007, 1007A or 1009 adjust the IO Recovery Time to 4
527 cycles.</p>
528 </li>
529 <li>
530 <p>AGP is disabled by default on some ALi chipsets (ALi1541,
531 ALi1647) to work around severe system stability problems with these
532 chipsets. See the comments for EnableALiAGP in <code class=
533 "filename">nv-reg.h</code> to force AGP on anyway.</p>
534 </li>
535 </ul>
536 </div>
537 <p></p>
538 </td>
539 </tr>
540 <tr class="question">
541 <td align="left" valign="top"><a name="id2622268" id=
542 "id2622268"></a><a name="id2622270" id="id2622270"></a></td>
543 <td align="left" valign="top">
544 <p><b>Using GNOME configuration utilities, I am unable to get a
545 resolution above 800x600.</b></p>
546 </td>
547 </tr>
548 <tr class="answer">
549 <td align="left" valign="top"></td>
550 <td align="left" valign="top">
551 <p>The installation of GNOME provided in operating systems such as
552 Red Hat Enterprise Linux 4 and Solaris 10 Update 2 contain several
553 competing interfaces for specifying resolution:</p>
554 <pre class="screen">
555     'System Settings' -&gt; 'Display'
556 </pre>
557 <p>which will update the X configuration file, and</p>
558 <pre class="screen">
559     'Applications' -&gt; 'Preferences' -&gt; 'Screen Resolution'
560 </pre>
561 <p>which will update the per-user screen resolution using the
562 XRandR extension. Your desktop resolution will be limited to the
563 smaller of the two settings. Be sure to check the setting of
564 each.</p>
565 </td>
566 </tr>
567 <tr class="question">
568 <td align="left" valign="top"><a name="id2622294" id=
569 "id2622294"></a><a name="id2622296" id="id2622296"></a></td>
570 <td align="left" valign="top">
571 <p><b>X does not restore the VGA console when run on a TV. I get
572 this error message in my X log file:</b></p>
573 <pre class="screen">
574 Unable to initialize the X int10 module; the console may not be
575 restored correctly on your TV.
576 </pre></td>
577 </tr>
578 <tr class="answer">
579 <td align="left" valign="top"></td>
580 <td align="left" valign="top">
581 <p>The NVIDIA X driver uses the X Int10 module to save and restore
582 console state on TV out, and will not be able to restore the
583 console correctly if it cannot use the Int10 module. If you have
584 built the X server yourself, please be sure you have built the
585 Int10 module. If you are using a build of the X server provided by
586 your operating system and are missing the Int10 module, contact
587 your operating system distributor.</p>
588 </td>
589 </tr>
590 <tr class="question">
591 <td align="left" valign="top"><a name="id2622311" id=
592 "id2622311"></a><a name="id2622313" id="id2622313"></a></td>
593 <td align="left" valign="top">
594 <p><b>OpenGL applications don't work, and my X log file contains
595 the error:</b></p>
596 <pre class="screen">
597 (EE) NVIDIA(0): Unable to map device node /dev/zero with read, write, and
598 (EE) NVIDIA(0):     execute privileges.  The GLX extension will be disabled
599 (EE) NVIDIA(0):     on this X screen.  Please see the COMMON PROBLEMS
600 (EE) NVIDIA(0):     section in the README for more information.
601 </pre></td>
602 </tr>
603 <tr class="answer">
604 <td align="left" valign="top"></td>
605 <td align="left" valign="top">
606 <p>The NVIDIA OpenGL driver must be able to map the <code class=
607 "filename">/dev/zero</code> device node with read, write, and
608 execute privileges in order to function correctly. The driver needs
609 this ability to allocate executable memory, which is used for
610 optimizations that require generating code at run-time. Currently,
611 GLX cannot run without these optimizations.</p>
612 <p>Check that your <code class="filename">/dev</code> filesystem is
613 set up correctly. In particular, mounting the <code class=
614 "filename">/dev</code> file system with the 'noexec' option will
615 cause this to happen. If you haven't changed the configuration of
616 your <code class="filename">/dev</code> filesystem, please contact
617 your operating system distributor.</p>
618 </td>
619 </tr>
620 </tbody>
621 </table>
622 </div>
623 </div>
624 <div class="navfooter">
625 <hr>
626 <table width="100%" summary="Navigation footer">
627 <tr>
628 <td width="40%" align="left"><a accesskey="p" href=
629 "chapter-05.html">Prev</a>&nbsp;</td>
630 <td width="20%" align="center"><a accesskey="u" href=
631 "part-01.html">Up</a></td>
632 <td width="40%" align="right">&nbsp;<a accesskey="n" href=
633 "chapter-07.html">Next</a></td>
634 </tr>
635 <tr>
636 <td width="40%" align="left" valign="top">
637 Chapter&nbsp;5.&nbsp;Frequently Asked Questions&nbsp;</td>
638 <td width="20%" align="center"><a accesskey="h" href=
639 "index.html">Home</a></td>
640 <td width="40%" align="right" valign="top">
641 &nbsp;Chapter&nbsp;7.&nbsp;Known Issues</td>
642 </tr>
643 </table>
644 </div>
645 </body>
646 </html>