[igt-dev] [PATCH i-g-t v2 0/6] Better document i915 tests

Mauro Carvalho Chehab mauro.chehab at linux.intel.com
Mon May 8 12:41:10 UTC 2023


From: Mauro Carvalho Chehab <mchehab at kernel.org>

The i915 test documentation has several gaps. Convert them
to use igt_doc.py tool, adding information from existing
sources.

Please notice that the last two patches on this series were generated
by a script which collects data from several different sources.

This is the first step to have a more comprehensive documentation
for i915 tests. Manual work will be needed in order to do some
additional cleanups.

---

v2:
- add support to expand testlist fields, as i915 may have
  the same test on multiple test lists;
- do some test_list.py cleanups based on Ruff warnings;
- rebased to be applied after KMS test documentation;
- feature names are now alphabetically sorted;
- some minor improvements at the igt doc comments, due to
  some improvements at the generation script.

Mauro Carvalho Chehab (6):
  scripts/test_list.py: expand testlist fields
  scripts/test_list.py: add support to exclude files
  scripts/test_list.py: fix some hints pointed by Ruff
  testplan/meson.build: add i915 support for a testplan document
  tests/i915: Improve test documentation
  tests/i915: Enhance test documentation

 docs/testplan/conf.py                       |    2 +-
 docs/testplan/meson.build                   |    6 +-
 scripts/test_list.py                        |   38 +-
 tests/core_auth.c                           |   25 +
 tests/core_getclient.c                      |   12 +
 tests/core_getstats.c                       |   12 +
 tests/core_getversion.c                     |   12 +
 tests/core_hotunplug.c                      |   50 +
 tests/core_setmaster.c                      |   19 +
 tests/core_setmaster_vs_auth.c              |   13 +
 tests/debugfs_test.c                        |   38 +
 tests/device_reset.c                        |   25 +
 tests/dmabuf.c                              |    8 +
 tests/drm_mm.c                              |    8 +
 tests/dumb_buffer.c                         |   37 +
 tests/i915/api_intel_allocator.c            |   77 +
 tests/i915/api_intel_bb.c                   |  111 ++
 tests/i915/drm_fdinfo.c                     |   44 +
 tests/i915/gem_bad_reloc.c                  |   19 +
 tests/i915/gem_barrier_race.c               |   14 +
 tests/i915/gem_basic.c                      |   37 +
 tests/i915/gem_blits.c                      |   11 +
 tests/i915/gem_busy.c                       |   46 +
 tests/i915/gem_caching.c                    |   20 +
 tests/i915/gem_ccs.c                        |   33 +
 tests/i915/gem_close.c                      |   13 +
 tests/i915/gem_close_race.c                 |   53 +
 tests/i915/gem_create.c                     |   89 ++
 tests/i915/gem_cs_tlb.c                     |   12 +
 tests/i915/gem_ctx_bad_destroy.c            |   18 +
 tests/i915/gem_ctx_create.c                 |   77 +
 tests/i915/gem_ctx_engines.c                |   26 +
 tests/i915/gem_ctx_exec.c                   |   53 +
 tests/i915/gem_ctx_freq.c                   |   11 +
 tests/i915/gem_ctx_isolation.c              |   53 +
 tests/i915/gem_ctx_param.c                  |  146 ++
 tests/i915/gem_ctx_persistence.c            |  154 ++
 tests/i915/gem_ctx_shared.c                 |   56 +
 tests/i915/gem_ctx_sseu.c                   |   14 +
 tests/i915/gem_ctx_switch.c                 |  365 +++++
 tests/i915/gem_eio.c                        |  178 +++
 tests/i915/gem_evict_alignment.c            |   17 +
 tests/i915/gem_evict_everything.c           |   61 +
 tests/i915/gem_exec_alignment.c             |   27 +
 tests/i915/gem_exec_async.c                 |   14 +
 tests/i915/gem_exec_await.c                 |   16 +
 tests/i915/gem_exec_balancer.c              |  218 +++
 tests/i915/gem_exec_basic.c                 |   16 +
 tests/i915/gem_exec_big.c                   |   14 +
 tests/i915/gem_exec_capture.c               |   40 +
 tests/i915/gem_exec_create.c                |   44 +
 tests/i915/gem_exec_endless.c               |   11 +
 tests/i915/gem_exec_fair.c                  |   92 ++
 tests/i915/gem_exec_fence.c                 |  369 +++++
 tests/i915/gem_exec_flush.c                 | 1496 +++++++++++++++++++
 tests/i915/gem_exec_gttfill.c               |   35 +
 tests/i915/gem_exec_latency.c               |   30 +
 tests/i915/gem_exec_lut_handle.c            |    7 +
 tests/i915/gem_exec_nop.c                   |   63 +
 tests/i915/gem_exec_parallel.c              |   43 +
 tests/i915/gem_exec_params.c                |  179 +++
 tests/i915/gem_exec_reloc.c                 |  593 ++++++++
 tests/i915/gem_exec_schedule.c              |  336 +++++
 tests/i915/gem_exec_store.c                 |   33 +
 tests/i915/gem_exec_suspend.c               |   81 +
 tests/i915/gem_exec_whisper.c               |  256 ++++
 tests/i915/gem_exercise_blt.c               |   17 +
 tests/i915/gem_fd_exhaustion.c              |    6 +
 tests/i915/gem_fence_thrash.c               |   19 +
 tests/i915/gem_fence_upload.c               |   16 +
 tests/i915/gem_fenced_exec_thrash.c         |   18 +
 tests/i915/gem_flink_basic.c                |   39 +
 tests/i915/gem_flink_race.c                 |   17 +
 tests/i915/gem_gpgpu_fill.c                 |   11 +
 tests/i915/gem_gtt_cpu_tlb.c                |    8 +
 tests/i915/gem_gtt_hog.c                    |    6 +
 tests/i915/gem_gtt_speed.c                  |    6 +
 tests/i915/gem_huc_copy.c                   |   11 +
 tests/i915/gem_linear_blits.c               |   25 +
 tests/i915/gem_lmem_evict.c                 |   10 +
 tests/i915/gem_lmem_swapping.c              |  121 ++
 tests/i915/gem_lut_handle.c                 |    7 +
 tests/i915/gem_madvise.c                    |   31 +
 tests/i915/gem_media_fill.c                 |    8 +
 tests/i915/gem_media_vme.c                  |    8 +
 tests/i915/gem_mmap.c                       |   57 +
 tests/i915/gem_mmap_gtt.c                   |  488 ++++++
 tests/i915/gem_mmap_offset.c                |   76 +
 tests/i915/gem_mmap_wc.c                    |   67 +
 tests/i915/gem_partial_pwrite_pread.c       |   62 +
 tests/i915/gem_pipe_control_store_loop.c    |   17 +
 tests/i915/gem_ppgtt.c                      |   29 +
 tests/i915/gem_pread.c                      |   17 +
 tests/i915/gem_pread_after_blit.c           |   29 +
 tests/i915/gem_pwrite.c                     |   67 +
 tests/i915/gem_pwrite_snooped.c             |    8 +
 tests/i915/gem_pxp.c                        |   79 +
 tests/i915/gem_read_read_speed.c            |   61 +
 tests/i915/gem_readwrite.c                  |   15 +
 tests/i915/gem_reg_read.c                   |   11 +
 tests/i915/gem_render_copy.c                |  120 ++
 tests/i915/gem_render_copy_redux.c          |   17 +
 tests/i915/gem_render_linear_blits.c        |   16 +
 tests/i915/gem_render_tiled_blits.c         |   27 +
 tests/i915/gem_request_retire.c             |   12 +
 tests/i915/gem_reset_stats.c                |  178 +++
 tests/i915/gem_ringfill.c                   |  123 ++
 tests/i915/gem_set_tiling_vs_blt.c          |   15 +
 tests/i915/gem_set_tiling_vs_gtt.c          |    8 +
 tests/i915/gem_set_tiling_vs_pwrite.c       |    8 +
 tests/i915/gem_shrink.c                     |  111 ++
 tests/i915/gem_softpin.c                    |  203 +++
 tests/i915/gem_spin_batch.c                 |   66 +
 tests/i915/gem_streaming_writes.c           |   29 +
 tests/i915/gem_stress.c                     |    7 +
 tests/i915/gem_sync.c                       |  247 +++
 tests/i915/gem_tiled_blits.c                |   17 +
 tests/i915/gem_tiled_fence_blits.c          |   15 +
 tests/i915/gem_tiled_partial_pwrite_pread.c |   12 +
 tests/i915/gem_tiled_pread_basic.c          |    8 +
 tests/i915/gem_tiled_pread_pwrite.c         |    8 +
 tests/i915/gem_tiled_swapping.c             |   10 +
 tests/i915/gem_tiled_wb.c                   |   10 +
 tests/i915/gem_tiled_wc.c                   |    7 +
 tests/i915/gem_tiling_max_stride.c          |    8 +
 tests/i915/gem_unfence_active_buffers.c     |    8 +
 tests/i915/gem_unref_active_buffers.c       |   12 +
 tests/i915/gem_userptr_blits.c              |  356 +++++
 tests/i915/gem_vm_create.c                  |   39 +
 tests/i915/gem_wait.c                       |   71 +
 tests/i915/gem_watchdog.c                   |   11 +
 tests/i915/gem_workarounds.c                |   71 +
 tests/i915/gen3_mixed_blits.c               |    7 +
 tests/i915/gen3_render_linear_blits.c       |    7 +
 tests/i915/gen3_render_mixed_blits.c        |    7 +
 tests/i915/gen3_render_tiledx_blits.c       |    7 +
 tests/i915/gen3_render_tiledy_blits.c       |    7 +
 tests/i915/gen7_exec_parse.c                |   31 +
 tests/i915/gen9_exec_parse.c                |   47 +
 tests/i915/i915_fb_tiling.c                 |    8 +
 tests/i915/i915_getparams_basic.c           |   19 +
 tests/i915/i915_hangman.c                   |   83 +
 tests/i915/i915_hwmon.c                     |   13 +
 tests/i915/i915_module_load.c               |   40 +
 tests/i915/i915_pciid.c                     |   13 +
 tests/i915/i915_pipe_stress.c               |   17 +
 tests/i915/i915_pm_backlight.c              |   25 +
 tests/i915/i915_pm_dc.c                     |   41 +
 tests/i915/i915_pm_freq_api.c               |   11 +
 tests/i915/i915_pm_freq_mult.c              |   10 +
 tests/i915/i915_pm_lpsp.c                   |   12 +
 tests/i915/i915_pm_rc6_residency.c          |   16 +
 tests/i915/i915_pm_rpm.c                    |  190 +++
 tests/i915/i915_pm_rps.c                    |   42 +
 tests/i915/i915_pm_sseu.c                   |    8 +
 tests/i915/i915_power.c                     |   12 +
 tests/i915/i915_query.c                     |   97 ++
 tests/i915/i915_selftest.c                  |   16 +
 tests/i915/i915_suspend.c                   |   79 +
 tests/i915/i915_test_config.json            |   88 ++
 tests/i915/perf.c                           |  266 ++++
 tests/i915/perf_pmu.c                       |  250 ++++
 tests/i915/sysfs_defaults.c                 |   12 +
 tests/i915/sysfs_heartbeat_interval.c       |   25 +
 tests/i915/sysfs_preempt_timeout.c          |   18 +
 tests/i915/sysfs_timeslice_duration.c       |   24 +
 tests/prime_busy.c                          |   27 +
 tests/prime_mmap.c                          |   33 +
 tests/prime_mmap_coherency.c                |   20 +
 tests/prime_self_import.c                   |   50 +
 tests/prime_vgem.c                          |  110 ++
 tests/sw_sync.c                             |   46 +
 tests/syncobj_basic.c                       |   34 +
 tests/syncobj_timeline.c                    |  398 +++++
 tests/syncobj_wait.c                        |  284 ++++
 tests/vgem_basic.c                          |  117 ++
 tests/vgem_slow.c                           |   13 +
 177 files changed, 12110 insertions(+), 13 deletions(-)
 create mode 100644 tests/i915/i915_test_config.json

-- 
2.40.1



More information about the igt-dev mailing list