summaryrefslogtreecommitdiffstats
path: root/src/gallium/drivers/trace/README
blob: 4b763f2488c569f9c7247ea1508d72054c824461 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
This directory contains a Gallium3D pipe driver which traces all incoming calls.

To build, invoke scons on the top dir as
 
 scons statetrackers=mesa drivers=softpipe,i915simple,trace winsys=xlib

To use do

 ln -s libGL.so build/linux-x86-debug/gallium/winsys/xlib/libGL.so.1
 export LD_LIBRARY_PATH=$PWD/build/linux-x86-debug/gallium/winsys/xlib
 export GALLIUM_TRACE=y

ensure the right libGL.so is being picked by doing

 ldd `which glxinfo` 

and then try running

 glxinfo

which should create a gallium.*.trace file, which is an XML file. You can view 
copying trace.xsl and trace.css to the same directory, and opening with a 
XSLT capable browser like Firefox or Internet Explorer. It often happens that 
the trace file was not properly terminated, and a

 </trace>
 
closing tag is missing from the file end. Add it before try to open or 
further transform it by doing

  echo '</trace>' >> gallium.??.trace


This is still work in progress, namely:
- surface writes are not traced
- no way to know the start/end of a frame

--
Jose Fonseca <jrfonseca@tungstengraphics.com>