git.cworth.org Git - apitrace-tests/blob - traces/README.markdown

   1 This directory tests various operations of the apitrace command-line
   2 interface (cli) operating on existings.
   3
   4 All files with a .script extension specify a simple script for
   5 testing. The test driver (in ../tool_driver.py) will parse the script
   6 file line-by-line, interpreting each line as arguments to the apitrace
   7 cli interface and invoking the cli with the given arguments. This
   8 continues until the first line of the script beginning with the "dump"
   9 command.
  10
  11 After a "dump" command in the script, the remainder of the script file
  12 provides the expected output of the given dump command. The tool
  13 driver will report a test failure if the actual dump output differs
  14 from that given in the.
  15
  16 Here are descriptions of some of the trace files contained here which
  17 are used by the test scripts:
  18
  19 *   zlib-no-eof.trace:  is a short, zlib compressed trace, with an unexpected end of
  20     file because the application terminated abnormally (which is actual very
  21     normal).
  22
  23     Depending on how zlib handles the unexpected end of file, it may fail to read
  24     any data from it.
  25
  26 *   incomplete-call.trace:  trace with an incomplete call, with missing arguments
  27
  28 *   glxsimple.trace: trace from a simple program showing drawing with
  29     glClear, with GLSL shader, and with texture. See ../cli/src