import NVIDIA-FreeBSD-x86-180.29
[nvidia.git] / doc / html / appendix-k-section-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>Debugging and Tracing</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="appendix-k.html" title=
13 "Appendix&nbsp;K.&nbsp;VDPAU Support">
14 <link rel="prev" href="appendix-k-section-04.html" title=
15 "Additional Notes">
16 <link rel="next" href="appendix-l.html" title=
17 "Appendix&nbsp;L.&nbsp;Tips for New FreeBSD Users">
18 </head>
19 <body>
20 <div class="navheader">
21 <table width="100%" summary="Navigation header">
22 <tr>
23 <th colspan="3" align="center">Debugging and Tracing</th>
24 </tr>
25 <tr>
26 <td width="20%" align="left"><a accesskey="p" href=
27 "appendix-k-section-04.html">Prev</a>&nbsp;</td>
28 <th width="60%" align="center">Appendix&nbsp;K.&nbsp;VDPAU
29 Support</th>
30 <td width="20%" align="right">&nbsp;<a accesskey="n" href=
31 "appendix-l.html">Next</a></td>
32 </tr>
33 </table>
34 <hr></div>
35 <div class="section" lang="en">
36 <div class="titlepage">
37 <div>
38 <div>
39 <h2 class="title" style="clear: both"><a name="id2654584" id=
40 "id2654584"></a>Debugging and Tracing</h2>
41 </div>
42 </div>
43 </div>
44 <p>The VDPAU wrapper library supports tracing VDPAU function calls,
45 and their parameters. This tracing is controlled by the following
46 environment variables:</p>
47 <div class="variablelist">
48 <dl>
49 <dt><span class="term">VDPAU_TRACE</span></dt>
50 <dd>
51 <p>Enables tracing. Set to 1 to trace function calls. Set to 2 to
52 trace all arguments passed to the function.</p>
53 </dd>
54 <dt><span class="term">VDPAU_TRACE_FILE</span></dt>
55 <dd>
56 <p>Filename to write traces to. By default, traces are sent to
57 stderr. This variable may either contain a plain filename, or a
58 reference to an existing open file-descriptor in the format
59 "&amp;N" where N is the file descriptor number.</p>
60 </dd>
61 </dl>
62 </div>
63 <p></p>
64 <p>The VDPAU wrapper library is responsible for determining which
65 vendor-specific driver to load for a given X11 display/screen. At
66 present, it hard-codes "nvidia" as the driver. The environment
67 variable VDPAU_DRIVER may be set to override this default. The
68 actual library loaded will be libvdpau_${VDPAU_DRIVER}.so. Setting
69 VDPAU_DRIVER to "trace" is not advised.</p>
70 <p>The NVIDIA VDPAU driver can emit some diagnostic information
71 when an error occurs. To enable this, set the environment variable
72 VDPAU_NVIDIA_DEBUG. A value of 1 will request a small diagnostic
73 that will enable NVIDIA engineers to locate the source of the
74 problem. A value of 3 will request that a complete stack backtrace
75 be printed, which provide NVIDIA engineers with more detailed
76 information, which may be needed to diagnose some problems.</p>
77 </div>
78 <div class="navfooter">
79 <hr>
80 <table width="100%" summary="Navigation footer">
81 <tr>
82 <td width="40%" align="left"><a accesskey="p" href=
83 "appendix-k-section-04.html">Prev</a>&nbsp;</td>
84 <td width="20%" align="center"><a accesskey="u" href=
85 "appendix-k.html">Up</a></td>
86 <td width="40%" align="right">&nbsp;<a accesskey="n" href=
87 "appendix-l.html">Next</a></td>
88 </tr>
89 <tr>
90 <td width="40%" align="left" valign="top">Additional
91 Notes&nbsp;</td>
92 <td width="20%" align="center"><a accesskey="h" href=
93 "index.html">Home</a></td>
94 <td width="40%" align="right" valign="top">
95 &nbsp;Appendix&nbsp;L.&nbsp;Tips for New FreeBSD Users</td>
96 </tr>
97 </table>
98 </div>
99 </body>
100 </html>