1Running traces on a local machine 2================================= 3 4Prerequisites 5------------- 6- Install `Apitrace <https://apitrace.github.io/>`__ 7- Install `Renderdoc <https://renderdoc.org/>`__ (only needed for some traces) 8- Download and compile `Piglit <https://gitlab.freedesktop.org/mesa/piglit>`__ and install his `dependencies <https://gitlab.freedesktop.org/mesa/piglit#2-setup>`__ 9- Download traces you want to replay from `traces-db <https://gitlab.freedesktop.org/gfx-ci/tracie/traces-db/>`__ 10 11Running single trace 12-------------------- 13A simple run to see the output of the trace can be done with 14 15.. code-block:: sh 16 17 apitrace replay -w name_of_trace.trace 18 19For more information, look into the `Apitrace documentation <https://github.com/apitrace/apitrace/blob/master/docs/USAGE.markdown>`__. 20 21For comparing checksums use: 22 23.. code-block:: sh 24 25 cd piglit/replayer 26 export PIGLIT_SOURCE_DIR="../" 27 ./replayer.py compare trace -d test path/name_of_trace.trace 0 # replace with expected checksum 28 29 30Simulating CI trace job 31----------------------- 32 33Sometimes it's useful to be able to test traces on your local machine instead of the Mesa CI runner. To simulate the CI environment as closely as possible. 34 35Download the YAML file from your driver's ``ci/`` directory and then change the path in the YAML file from local proxy or MinIO to the local directory (URL-like format ``file://``) 36 37.. code-block:: sh 38 39 # The PIGLIT_REPLAY_DEVICE_NAME has to match name in the YAML file. 40 export PIGLIT_REPLAY_DEVICE_NAME='your_device_name' 41 export PIGLIT_REPLAY_DESCRIPTION_FILE='path_to_mesa_traces_file.yml' 42 ./piglit run -l verbose --timeout 300 -j10 replay ~/results/ 43 44 45Note: For replaying traces, you may need to allow higher GL and GLSL versions. You can achieve that by setting ``MESA_GLSL_VERSION_OVERRIDE`` and ``MESA_GL_VERSION_OVERRIDE``. 46