forked from FFmpeg/FFmpeg
1e76bd2f39
If running tests with "make -j<N> fate", the execution will stop after the first failing test. To get an overview of the whole test suite, one rather would run "make -k -j<N> fate", which then again buries the results about what tests actually failed further up in the console log. Add a target so one can run "make fate-list-failing", to see a list of all tests that failed the last time they were executed. Also add a companion target "fate-clear-reports" which removes all the old test reports. (When executing a subset of tests, the report files of all tests that aren't executed stay untouched. This also allows getting rid of reports for tests that no longer are present in the testsuite.) Co-authored-by: Alexander Strasser <eclipse7@gmx.net> Signed-off-by: Martin Storsjö <martin@martin.st>
73 lines
2 KiB
Text
73 lines
2 KiB
Text
FFmpeg currently uses a custom build system, this text attempts to document
|
||
some of its obscure features and options.
|
||
|
||
Makefile variables:
|
||
|
||
V
|
||
Disable the default terse mode, the full command issued by make and its
|
||
output will be shown on the screen.
|
||
|
||
DBG
|
||
Preprocess x86 external assembler files to a .dbg.asm file in the object
|
||
directory, which then gets compiled. Helps in developing those assembler
|
||
files.
|
||
|
||
DESTDIR
|
||
Destination directory for the install targets, useful to prepare packages
|
||
or install FFmpeg in cross-environments.
|
||
|
||
GEN
|
||
Set to ‘1’ to generate the missing or mismatched references.
|
||
|
||
Makefile targets:
|
||
|
||
all
|
||
Default target, builds all the libraries and the executables.
|
||
|
||
fate
|
||
Run the fate test suite, note that you must have installed it.
|
||
|
||
fate-list
|
||
List all fate/regression test targets.
|
||
|
||
fate-list-failing
|
||
List the fate tests that failed the last time they were executed.
|
||
|
||
fate-clear-reports
|
||
Remove the test reports from previous test executions (getting rid of
|
||
potentially stale results from fate-list-failing).
|
||
|
||
install
|
||
Install headers, libraries and programs.
|
||
|
||
examples
|
||
Build all examples located in doc/examples.
|
||
|
||
checkheaders
|
||
Check headers dependencies.
|
||
|
||
alltools
|
||
Build all tools in tools directory.
|
||
|
||
config
|
||
Reconfigure the project with the current configuration.
|
||
|
||
tools/target_dec_<decoder>_fuzzer
|
||
Build fuzzer to fuzz the specified decoder.
|
||
|
||
tools/target_bsf_<filter>_fuzzer
|
||
Build fuzzer to fuzz the specified bitstream filter.
|
||
|
||
Useful standard make commands:
|
||
make -t <target>
|
||
Touch all files that otherwise would be built, this is useful to reduce
|
||
unneeded rebuilding when changing headers, but note that you must force rebuilds
|
||
of files that actually need it by hand then.
|
||
|
||
make -j<num>
|
||
Rebuild with multiple jobs at the same time. Faster on multi processor systems.
|
||
|
||
make -k
|
||
Continue build in case of errors, this is useful for the regression tests
|
||
sometimes but note that it will still not run all reg tests.
|
||
|