[PATCH i-g-t v5 00/24] Update test documentation for i915 tests

Katarzyna Piecielska katarzyna.piecielska at intel.com
Thu Mar 21 15:38:23 UTC 2024


There are many warnings about missing test documentation, so let's fix that.
While I am already doing that - let's introduce more subcategories and
functionalities. Additionally adjust categorization for all i915 tests.

Last patch is removing 'Run type' field from all Intel tests - both XE and i915.

v2: Apply review comments: fix commit messages, remove duplicates in Subcategory
and Functionality (Mauro)

v3: Fix duplication of name for Obsolete tests (Kamil)
v4: Make Sub-category/Functionality/Feature unique (Kamil)
v5: Make Sub-category/Functionality/Feature unique - probaly most of remaining
duplicates was removed. (Kamil)

Signed-off-by: Katarzyna Piecielska <katarzyna.piecielska at intel.com>
Cc: Mauro Carvalho Chehab <mauro.chehab at linux.intel.com>
Cc: Kamil Konieczny <kamil.konieczny at linux.intel.com>
Cc: Ashutosh Dixit <ashutosh.dixit at intel.com>
Cc: Chris Wilson <chris at chris-wilson.co.uk>
Cc: Juha-Pekka Heikkila <juhapekka.heikkila at gmail.com>

Katarzyna Piecielska (24):
  tests: Introduce uapi subcategory
  tests/intel: Introduce Memory management subcategory
  tests/intel: Introduce CMD submission subcategory
  tests/intel: Let's introduce Workarounds subcategory
  tests/intel: Add tests to Compute subcategory
  tests/intel: Introduce GPGPU subcategory
  tests/intel: Introduce Blitter subcategory
  tests/intel: Introduce FDinfo subcategory
  tests/intel: Introduce Flat-ccs subcategory
  tests/intel: Introduce Firmware subcategory
  tests/intel: Introduce Media subcategory
  tests/intel: Introduce Render copy subcategory
  tests/intel: Introduce Obsolete subcategory
  tests/intel: Introduce Power management subcategory
  tests/intel: Introduce SysMan subcategory
  tests: Introduce Core subcategory
  tests: Introduce Synchronization subcategory
  tests: Introduce intel-nouveau subcategory
  tests/intel: Introduce Debugging subcategory
  tests/intel: Add missing documentation fields in i915_selftest
  tests/intel: Add more tests to Performance subcategory
  tests: Update device_reset functionality
  tests: Add missing documentation fields for SRIOV and Display
  tests: Remove 'Run type' documentation field

 tests/core_auth.c                            |   4 -
 tests/core_getclient.c                       |   1 -
 tests/core_getstats.c                        |   5 +-
 tests/core_getversion.c                      |   1 -
 tests/core_hotunplug.c                       |   2 -
 tests/core_setmaster.c                       |   1 -
 tests/core_setmaster_vs_auth.c               |   1 -
 tests/device_reset.c                         |   3 +-
 tests/dmabuf.c                               |   1 -
 tests/dmabuf_sync_file.c                     |  17 +
 tests/drm_mm.c                               |   3 +-
 tests/drm_read.c                             |  16 +
 tests/dumb_buffer.c                          |   7 +-
 tests/intel/api_intel_allocator.c            |   1 -
 tests/intel/api_intel_bb.c                   |   1 -
 tests/intel/debugfs_test.c                   |   3 -
 tests/intel/drm_fdinfo.c                     |   6 +-
 tests/intel/gem_bad_reloc.c                  |  15 +-
 tests/intel/gem_barrier_race.c               |   4 +-
 tests/intel/gem_basic.c                      |   2 -
 tests/intel/gem_blits.c                      |   1 -
 tests/intel/gem_busy.c                       |   2 -
 tests/intel/gem_caching.c                    |   7 +-
 tests/intel/gem_ccs.c                        |   4 +-
 tests/intel/gem_close.c                      |   3 +-
 tests/intel/gem_close_race.c                 |   5 +-
 tests/intel/gem_compute.c                    |   3 +-
 tests/intel/gem_create.c                     |  16 +-
 tests/intel/gem_cs_tlb.c                     |   5 +-
 tests/intel/gem_ctx_bad_destroy.c            |   7 +-
 tests/intel/gem_ctx_create.c                 |   7 +-
 tests/intel/gem_ctx_engines.c                |   7 +-
 tests/intel/gem_ctx_exec.c                   |   8 +-
 tests/intel/gem_ctx_freq.c                   |   3 +-
 tests/intel/gem_ctx_isolation.c              |   1 -
 tests/intel/gem_ctx_param.c                  |   3 +-
 tests/intel/gem_ctx_persistence.c            |   3 +-
 tests/intel/gem_ctx_shared.c                 |   5 +-
 tests/intel/gem_ctx_sseu.c                   |   4 +-
 tests/intel/gem_ctx_switch.c                 |   6 +-
 tests/intel/gem_eio.c                        |   3 +-
 tests/intel/gem_evict_alignment.c            |   4 +-
 tests/intel/gem_evict_everything.c           |   4 +-
 tests/intel/gem_exec_alignment.c             |   5 +-
 tests/intel/gem_exec_async.c                 |   5 +-
 tests/intel/gem_exec_await.c                 |   5 +-
 tests/intel/gem_exec_balancer.c              |   1 -
 tests/intel/gem_exec_basic.c                 |   1 -
 tests/intel/gem_exec_big.c                   |   1 -
 tests/intel/gem_exec_capture.c               |   3 +-
 tests/intel/gem_exec_create.c                |   2 -
 tests/intel/gem_exec_endless.c               |   7 +-
 tests/intel/gem_exec_fair.c                  |   4 +-
 tests/intel/gem_exec_fence.c                 |  23 +-
 tests/intel/gem_exec_flush.c                 |   4 +-
 tests/intel/gem_exec_gttfill.c               |   2 -
 tests/intel/gem_exec_latency.c               |   4 +-
 tests/intel/gem_exec_lut_handle.c            |   4 +-
 tests/intel/gem_exec_nop.c                   |   5 +-
 tests/intel/gem_exec_parallel.c              |   2 -
 tests/intel/gem_exec_params.c                |   1 -
 tests/intel/gem_exec_reloc.c                 |   4 +-
 tests/intel/gem_exec_schedule.c              |   1 -
 tests/intel/gem_exec_store.c                 |  18 +-
 tests/intel/gem_exec_suspend.c               |   6 +-
 tests/intel/gem_exec_whisper.c               |   5 +-
 tests/intel/gem_exercise_blt.c               |  15 +-
 tests/intel/gem_fd_exhaustion.c              |   4 +-
 tests/intel/gem_fence_thrash.c               |   6 +-
 tests/intel/gem_fence_upload.c               |   4 +-
 tests/intel/gem_fenced_exec_thrash.c         |   6 +-
 tests/intel/gem_flink_basic.c                |   1 -
 tests/intel/gem_flink_race.c                 |   1 -
 tests/intel/gem_gpgpu_fill.c                 |   7 +-
 tests/intel/gem_gtt_cpu_tlb.c                |   4 +-
 tests/intel/gem_gtt_hog.c                    |   4 +-
 tests/intel/gem_gtt_speed.c                  |   4 +-
 tests/intel/gem_huc_copy.c                   |   6 +-
 tests/intel/gem_linear_blits.c               |   8 +-
 tests/intel/gem_lmem_evict.c                 |   4 +-
 tests/intel/gem_lmem_swapping.c              |   6 +-
 tests/intel/gem_lut_handle.c                 |   4 +-
 tests/intel/gem_madvise.c                    |   3 +-
 tests/intel/gem_media_fill.c                 |   6 +-
 tests/intel/gem_media_vme.c                  |   6 +-
 tests/intel/gem_mmap.c                       |   5 +-
 tests/intel/gem_mmap_gtt.c                   |   4 +-
 tests/intel/gem_mmap_offset.c                |   3 +-
 tests/intel/gem_mmap_wc.c                    |   4 +-
 tests/intel/gem_partial_pwrite_pread.c       |   4 +-
 tests/intel/gem_pipe_control_store_loop.c    |   5 +-
 tests/intel/gem_ppgtt.c                      |   1 -
 tests/intel/gem_pread.c                      |   4 +-
 tests/intel/gem_pread_after_blit.c           |   4 +-
 tests/intel/gem_pwrite.c                     |   4 +-
 tests/intel/gem_pwrite_snooped.c             |   4 +-
 tests/intel/gem_pxp.c                        |   4 +-
 tests/intel/gem_read_read_speed.c            |   4 +-
 tests/intel/gem_readwrite.c                  |   4 +-
 tests/intel/gem_reg_read.c                   |   4 +-
 tests/intel/gem_render_copy.c                |   4 +-
 tests/intel/gem_render_copy_redux.c          |   4 +-
 tests/intel/gem_render_linear_blits.c        |   5 +-
 tests/intel/gem_render_tiled_blits.c         |   5 +-
 tests/intel/gem_request_retire.c             |   5 +-
 tests/intel/gem_reset_stats.c                |   4 +-
 tests/intel/gem_ringfill.c                   |   6 +-
 tests/intel/gem_set_tiling_vs_blt.c          |   6 +-
 tests/intel/gem_set_tiling_vs_gtt.c          |   4 +-
 tests/intel/gem_set_tiling_vs_pwrite.c       |   4 +-
 tests/intel/gem_shrink.c                     |   1 -
 tests/intel/gem_softpin.c                    |   3 -
 tests/intel/gem_spin_batch.c                 |   1 -
 tests/intel/gem_streaming_writes.c           |   4 +-
 tests/intel/gem_stress.c                     |   4 +-
 tests/intel/gem_sync.c                       |  32 +-
 tests/intel/gem_tiled_blits.c                |   5 +-
 tests/intel/gem_tiled_fence_blits.c          |   5 +-
 tests/intel/gem_tiled_partial_pwrite_pread.c |   4 +-
 tests/intel/gem_tiled_pread_basic.c          |   4 +-
 tests/intel/gem_tiled_pread_pwrite.c         |   4 +-
 tests/intel/gem_tiled_swapping.c             |   4 +-
 tests/intel/gem_tiled_wb.c                   |   4 +-
 tests/intel/gem_tiled_wc.c                   |   4 +-
 tests/intel/gem_tiling_max_stride.c          |   4 +-
 tests/intel/gem_unfence_active_buffers.c     |   6 +-
 tests/intel/gem_unref_active_buffers.c       |   3 +-
 tests/intel/gem_userptr_blits.c              |   1 -
 tests/intel/gem_vm_create.c                  |   6 +-
 tests/intel/gem_wait.c                       |   9 +-
 tests/intel/gem_watchdog.c                   |   4 +-
 tests/intel/gem_workarounds.c                |  20 +-
 tests/intel/gen3_mixed_blits.c               |   4 +-
 tests/intel/gen3_render_linear_blits.c       |   4 +-
 tests/intel/gen3_render_mixed_blits.c        |   4 +-
 tests/intel/gen3_render_tiledx_blits.c       |   6 +-
 tests/intel/gen3_render_tiledy_blits.c       |   6 +-
 tests/intel/gen7_exec_parse.c                |   4 +-
 tests/intel/gen9_exec_parse.c                |   6 +-
 tests/intel/i915_fb_tiling.c                 |   4 +-
 tests/intel/i915_getparams_basic.c           |   3 +-
 tests/intel/i915_hangman.c                   |  11 +-
 tests/intel/i915_module_load.c               |   3 -
 tests/intel/i915_pciid.c                     |   3 +-
 tests/intel/i915_pipe_stress.c               |  12 +-
 tests/intel/i915_pm_freq_api.c               |   4 +-
 tests/intel/i915_pm_freq_mult.c              |  10 +-
 tests/intel/i915_pm_rc6_residency.c          |   2 +-
 tests/intel/i915_pm_rpm.c                    |   3 +-
 tests/intel/i915_pm_rps.c                    |   7 +-
 tests/intel/i915_pm_sseu.c                   |   4 +-
 tests/intel/i915_power.c                     |   4 +-
 tests/intel/i915_query.c                     |   1 -
 tests/intel/i915_selftest.c                  | 407 ++++++++++---------
 tests/intel/i915_suspend.c                   |  15 +-
 tests/intel/intel_hwmon.c                    |   1 -
 tests/intel/perf.c                           |  34 +-
 tests/intel/perf_pmu.c                       |  20 +-
 tests/intel/prime_busy.c                     |   3 +-
 tests/intel/prime_mmap.c                     |   5 +-
 tests/intel/prime_mmap_coherency.c           |   5 +-
 tests/intel/prime_mmap_kms.c                 |   1 -
 tests/intel/prime_self_import.c              |  10 +-
 tests/intel/sysfs_defaults.c                 |   5 +-
 tests/intel/sysfs_heartbeat_interval.c       |   4 +-
 tests/intel/sysfs_preempt_timeout.c          |   4 +-
 tests/intel/sysfs_timeslice_duration.c       |   4 +-
 tests/intel/xe_drm_fdinfo.c                  |   1 -
 tests/intel/xe_pm.c                          |   1 -
 tests/intel/xe_pm_residency.c                |   1 -
 tests/intel/xe_spin_batch.c                  |   2 -
 tests/intel/xe_waitfence.c                   |   1 -
 tests/prime_nv_api.c                         |  21 +
 tests/prime_nv_pcopy.c                       |  17 +
 tests/prime_nv_test.c                        |  16 +
 tests/prime_vgem.c                           |   7 -
 tests/sriov_basic.c                          |   5 +-
 tests/sw_sync.c                              |   7 +-
 tests/syncobj_basic.c                        |   7 +-
 tests/syncobj_eventfd.c                      |   1 -
 tests/syncobj_timeline.c                     |   7 +-
 tests/syncobj_wait.c                         |   7 +-
 tests/vgem_basic.c                           |  13 +-
 tests/vgem_slow.c                            |   1 -
 184 files changed, 746 insertions(+), 646 deletions(-)

-- 
2.34.1



More information about the igt-dev mailing list