diff options
author | Daniel Vetter <daniel.vetter@ffwll.ch> | 2015-02-07 12:45:49 +0100 |
---|---|---|
committer | Daniel Vetter <daniel.vetter@ffwll.ch> | 2015-02-13 09:35:36 +0100 |
commit | 25c4347078f181a938eaaefbed7e2e27c9dc1a3f (patch) | |
tree | 1a5095fbc432935578b40548f43415c93b4c7364 | |
parent | 14185f04bd7c5fb2052a3e6454ceda5b46c37a61 (diff) |
doc: Consolidate naming conventions into docbook
Duplication just means it gets out of sync.
Also update they keyword list in the Makefile, not everything was listed.
And add a new "invalid" keyword.
While at it update NEWS.
Signed-off-by: Daniel Vetter <daniel.vetter@ffwll.ch>
-rw-r--r-- | CONTRIBUTING | 2 | ||||
-rw-r--r-- | NEWS | 12 | ||||
-rw-r--r-- | docs/reference/intel-gpu-tools/Makefile.am | 2 | ||||
-rw-r--r-- | docs/reference/intel-gpu-tools/igt_test_programs.xml | 7 | ||||
-rw-r--r-- | tests/NAMING-CONVENTION | 71 |
5 files changed, 21 insertions, 73 deletions
diff --git a/CONTRIBUTING b/CONTRIBUTING index 7c20fdb7..e2c352e7 100644 --- a/CONTRIBUTING +++ b/CONTRIBUTING @@ -22,7 +22,7 @@ A short list of contribution guidelines: developer's certificate of origin: http://developercertificate.org/ - When submitting new testcases please follow the naming conventions documented - in tests/NAMING-CONVENTION. Also please make full use of all the helpers and + in the generated documentation. Also please make full use of all the helpers and convenience macros provided by the igt library. The semantic patch lib/igt.cocci can help with the more automatic conversions. @@ -3,6 +3,18 @@ Release 1.10 (XXXX-XX-XX) - New frequency manipulation tool (intel_gpu_frequency) +- Adjustments for the Solaris port (Alan Coopersmith). + +- Remove tests/NAMING-CONVENTION since it's all in the docbook now, to avoid + divergent conventions. + +- New CRITICAL log level for really serious stuff (Thomas Wood). + +- Interactive test mode can now be enabled by the shared cmdline option + --interactive-debug=$var (Rodrigo Vivi). + +- Piles of new testcases and improvements to existing ones as usual. + Release 1.9 (2014-12-12) ------------------------ diff --git a/docs/reference/intel-gpu-tools/Makefile.am b/docs/reference/intel-gpu-tools/Makefile.am index 0a47764d..0f10eaab 100644 --- a/docs/reference/intel-gpu-tools/Makefile.am +++ b/docs/reference/intel-gpu-tools/Makefile.am @@ -1,7 +1,7 @@ ## Process this file with automake to produce Makefile.in TESTLISTS = $(top_builddir)/tests/single-tests.txt $(top_builddir)/tests/multi-tests.txt -KEYWORDS = (hang|swap|thrash|crc|tiled|tiling|rte|ctx|exec|rpm) +KEYWORDS = (invalid|hang|swap|thrash|crc|tiled|tiling|rte|ctx|render|blt|bsd|vebox|exec|rpm) xml/igt_test_programs_%_programs.xml: $(TESTLISTS) mkdir -p `dirname $@` diff --git a/docs/reference/intel-gpu-tools/igt_test_programs.xml b/docs/reference/intel-gpu-tools/igt_test_programs.xml index 36ad1f35..bf8a939d 100644 --- a/docs/reference/intel-gpu-tools/igt_test_programs.xml +++ b/docs/reference/intel-gpu-tools/igt_test_programs.xml @@ -197,6 +197,13 @@ various features of the test and can be used to filter and select particular tests.</para> + <glossentry id="invalid"> + <glossterm>invalid</glossterm> + <glossdef> + <para>Negative tests to validate kernel interface input validation.</para> + </glossdef> + </glossentry> + <glossentry id="hang"> <glossterm>hang</glossterm> <glossdef> diff --git a/tests/NAMING-CONVENTION b/tests/NAMING-CONVENTION deleted file mode 100644 index 7c27fdbb..00000000 --- a/tests/NAMING-CONVENTION +++ /dev/null @@ -1,71 +0,0 @@ -Naming Convention of i-g-t Tests and Subtests -============================================= - -To facilitate easy test selection with piglit we need a somewhat consistent -naming scheme for tests and subtests. - -Test Prefixes -------------- - -core_: Test for core drm ioctls and behaviour. - -kms_: Used for modesetting tests. - -drm_: Tests for libdrm behaviour, currently just testing the buffer cache -reaping. - -gem_: Used for all kinds of GEM tests. - -prime_: Used for buffer sharing tests, both for self-importing (used by -dri3/wayland) and actual multi-gpu tests. - -drv_: Tests for overall driver behaviour like module reload, s/r, debugfs files. - -pm_: Tests for power management features like runtime PM, tuning knobs in sysfs -and also performance tuning features. - -gen3_: Used by Chris' gen3 specific tiling/fencing tests. Generally tests that -only run on some platforms don't have a specific prefix but just skip on -platforms where the test doesn't apply. - -debugfs_/sysfs_: Mostly for tests that use sysfs/debugfs but tend to tests all -sorts of things. Please consider using a more appropriate prefix from above if -the main point isn't to test sysfs/debugfs, but a driver subsystem/feature. - -igt_: Testcase which test the i-g-t infrastructure itself and which are all run -through "make check" while building i-g-t. - -(Sub-)Test patterns -------------------- - -Much more powerful for filtering sets of tests are patterns anywhere in either -the test or subtest name. - -hang: Tests that provoke gpu hangs - -swap: Tests that force their full working sets through swap. Dreadfully slow on -machines with spinning rust and tons of memory. - -thrash: Tests that tend to have really slow forward progress due to -gtt/memory/.. thrashing. Mostly used to stress-test error-handling corner-cases. - -crc: Tests that use the display CRC infrastructure to check the results. - -tiled/tiling: Tests that exercise behaviour on tiled buffers. - -normal/uncached/snoop: Usual 3 variants for tests that use different coherency -modes for the buffer objects they're using. - -rte: _R_un_t_ime _e_nviroment checks. For testcases which will fail if the -machine isn't configured properly there should be a first subtest to just check -for that. - -ctx: Tests that exercise the hw context support. - -render/blt/bsd/vebox: Tests which apply to individual rings should use these -suffixes. They're a bit inconsistent and historically grown, but they new Bspec -names (RCS, BCS, VCS and VECS) aren't really clearer. - -exec: Tests that exercise the execbuf code in various ways. - -rpm: Runtime PM tests. |