Browse Source

fate: document TARGET_EXEC and its usage

TARGET_EXEC allows running FATE on simulators, remote targets and
memory checkers. Also document a known issue with Wine and mixed
Unix/Windows line ending.
tags/n1.0
Luca Barbato 13 years ago
parent
commit
b0970a69d1
1 changed files with 11 additions and 1 deletions
  1. +11
    -1
      doc/fate.texi

+ 11
- 1
doc/fate.texi View File

@@ -29,6 +29,9 @@ To inform the build system about the testsuite location, pass
@var{SAMPLES} Make variable or the @var{LIBAV_SAMPLES} environment variable @var{SAMPLES} Make variable or the @var{LIBAV_SAMPLES} environment variable
to a suitable value. to a suitable value.


To use a custom wrapper to run the test, pass @option{--target-exec} to
@command{configure} or set the @var{TARGET_EXEC} Make variable.

The dataset is available through @command{rsync}, is possible to fetch The dataset is available through @command{rsync}, is possible to fetch
the current sample using the straight rsync command or through a specific the current sample using the straight rsync command or through a specific
@ref{Makefile target}. @ref{Makefile target}.
@@ -57,7 +60,7 @@ Shortcut to download the fate test samples to the specified testsuite location.
Run the FATE test suite (requires the fate-suite dataset). Run the FATE test suite (requires the fate-suite dataset).
@end table @end table


@section Fate Makefile variables
@section FATE Makefile variables
@table @option @table @option
@item V @item V
Verbosity level, can be set to 0, 1 or 2. Verbosity level, can be set to 0, 1 or 2.
@@ -77,6 +80,8 @@ Specify how many threads to use while running regression tests, it is
quite useful to detect thread-related regressions. quite useful to detect thread-related regressions.
@item CPUFLAGS @item CPUFLAGS
Specify a mask to be applied to autodetected CPU flags. Specify a mask to be applied to autodetected CPU flags.
@item TARGET_EXEC
Specify or override the wrapper used to run the tests.
@end table @end table


@example @example
@@ -131,6 +136,11 @@ makeopts= # extra options passed to 'make'
# stdout, defaults to 'tar c' # stdout, defaults to 'tar c'
@end example @end example


@section Special Instances
The @var{TARGET_EXEC} option provides a way to run FATE wrapped in
@command{valgrind}, @command{qemu-user} or @command{wine} or on remote targets
through @command{ssh}.

@section Submitting Reports @section Submitting Reports
In order to send reports you need to create an @command{ssh} key and send it In order to send reports you need to create an @command{ssh} key and send it
to @email{root@@libav.org}. to @email{root@@libav.org}.


Loading…
Cancel
Save