LCOV - code coverage report
Current view: top level - drivers/gpu/drm/i915 - i915_selftest.h (source / functions) Hit Total Coverage
Test: combined.info Lines: 1 1 100.0 %
Date: 2022-03-28 15:32:58 Functions: 0 0 -
Branches: 1 2 50.0 %

           Branch data     Line data    Source code
       1                 :            : /*
       2                 :            :  * Copyright © 2016 Intel Corporation
       3                 :            :  *
       4                 :            :  * Permission is hereby granted, free of charge, to any person obtaining a
       5                 :            :  * copy of this software and associated documentation files (the "Software"),
       6                 :            :  * to deal in the Software without restriction, including without limitation
       7                 :            :  * the rights to use, copy, modify, merge, publish, distribute, sublicense,
       8                 :            :  * and/or sell copies of the Software, and to permit persons to whom the
       9                 :            :  * Software is furnished to do so, subject to the following conditions:
      10                 :            :  *
      11                 :            :  * The above copyright notice and this permission notice (including the next
      12                 :            :  * paragraph) shall be included in all copies or substantial portions of the
      13                 :            :  * Software.
      14                 :            :  *
      15                 :            :  * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
      16                 :            :  * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
      17                 :            :  * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.  IN NO EVENT SHALL
      18                 :            :  * THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
      19                 :            :  * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
      20                 :            :  * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS
      21                 :            :  * IN THE SOFTWARE.
      22                 :            :  */
      23                 :            : 
      24                 :            : #ifndef __I915_SELFTEST_H__
      25                 :            : #define __I915_SELFTEST_H__
      26                 :            : 
      27                 :            : #include <linux/types.h>
      28                 :            : 
      29                 :            : struct pci_dev;
      30                 :            : struct drm_i915_private;
      31                 :            : 
      32                 :            : struct i915_selftest {
      33                 :            :         unsigned long timeout_jiffies;
      34                 :            :         unsigned int timeout_ms;
      35                 :            :         unsigned int random_seed;
      36                 :            :         char *filter;
      37                 :            :         int mock;
      38                 :            :         int live;
      39                 :            :         int perf;
      40                 :            : };
      41                 :            : 
      42                 :            : #if IS_ENABLED(CONFIG_DRM_I915_SELFTEST)
      43                 :            : #include <linux/fault-inject.h>
      44                 :            : 
      45                 :            : extern struct i915_selftest i915_selftest;
      46                 :            : 
      47                 :            : int i915_mock_selftests(void);
      48                 :            : int i915_live_selftests(struct pci_dev *pdev);
      49                 :            : int i915_perf_selftests(struct pci_dev *pdev);
      50                 :            : 
      51                 :            : /* We extract the function declarations from i915_mock_selftests.h and
      52                 :            :  * i915_live_selftests.h Add your unit test declarations there!
      53                 :            :  *
      54                 :            :  * Mock unit tests are run very early upon module load, before the driver
      55                 :            :  * is probed. All hardware interactions, as well as other subsystems, must
      56                 :            :  * be "mocked".
      57                 :            :  *
      58                 :            :  * Live unit tests are run after the driver is loaded - all hardware
      59                 :            :  * interactions are real.
      60                 :            :  */
      61                 :            : #define selftest(name, func) int func(void);
      62                 :            : #include "selftests/i915_mock_selftests.h"
      63                 :            : #undef selftest
      64                 :            : #define selftest(name, func) int func(struct drm_i915_private *i915);
      65                 :            : #include "selftests/i915_live_selftests.h"
      66                 :            : #include "selftests/i915_perf_selftests.h"
      67                 :            : #undef selftest
      68                 :            : 
      69                 :            : struct i915_subtest {
      70                 :            :         int (*func)(void *data);
      71                 :            :         const char *name;
      72                 :            : };
      73                 :            : 
      74                 :            : int __i915_nop_setup(void *data);
      75                 :            : int __i915_nop_teardown(int err, void *data);
      76                 :            : 
      77                 :            : int __i915_live_setup(void *data);
      78                 :            : int __i915_live_teardown(int err, void *data);
      79                 :            : 
      80                 :            : int __intel_gt_live_setup(void *data);
      81                 :            : int __intel_gt_live_teardown(int err, void *data);
      82                 :            : 
      83                 :            : int __i915_subtests(const char *caller,
      84                 :            :                     int (*setup)(void *data),
      85                 :            :                     int (*teardown)(int err, void *data),
      86                 :            :                     const struct i915_subtest *st,
      87                 :            :                     unsigned int count,
      88                 :            :                     void *data);
      89                 :            : #define i915_subtests(T, data) \
      90                 :            :         __i915_subtests(__func__, \
      91                 :            :                         __i915_nop_setup, __i915_nop_teardown, \
      92                 :            :                         T, ARRAY_SIZE(T), data)
      93                 :            : #define i915_live_subtests(T, data) ({ \
      94                 :            :         typecheck(struct drm_i915_private *, data); \
      95                 :            :         __i915_subtests(__func__, \
      96                 :            :                         __i915_live_setup, __i915_live_teardown, \
      97                 :            :                         T, ARRAY_SIZE(T), data); \
      98                 :            : })
      99                 :            : #define intel_gt_live_subtests(T, data) ({ \
     100                 :            :         typecheck(struct intel_gt *, data); \
     101                 :            :         __i915_subtests(__func__, \
     102                 :            :                         __intel_gt_live_setup, __intel_gt_live_teardown, \
     103                 :            :                         T, ARRAY_SIZE(T), data); \
     104                 :            : })
     105                 :            : 
     106                 :            : #define SUBTEST(x) { x, #x }
     107                 :            : 
     108                 :            : #define I915_SELFTEST_DECLARE(x) x
     109                 :            : #define I915_SELFTEST_ONLY(x) unlikely(x)
     110                 :            : 
     111                 :            : #else /* !IS_ENABLED(CONFIG_DRM_I915_SELFTEST) */
     112                 :            : 
     113         [ -  + ]:         28 : static inline int i915_mock_selftests(void) { return 0; }
     114                 :            : static inline int i915_live_selftests(struct pci_dev *pdev) { return 0; }
     115                 :            : static inline int i915_perf_selftests(struct pci_dev *pdev) { return 0; }
     116                 :            : 
     117                 :            : #define I915_SELFTEST_DECLARE(x)
     118                 :            : #define I915_SELFTEST_ONLY(x) 0
     119                 :            : 
     120                 :            : #endif
     121                 :            : 
     122                 :            : /* Using the i915_selftest_ prefix becomes a little unwieldy with the helpers.
     123                 :            :  * Instead we use the igt_ shorthand, in reference to the intel-gpu-tools
     124                 :            :  * suite of uabi test cases (which includes a test runner for our selftests).
     125                 :            :  */
     126                 :            : 
     127                 :            : #define IGT_TIMEOUT(name__) \
     128                 :            :         unsigned long name__ = jiffies + i915_selftest.timeout_jiffies
     129                 :            : 
     130                 :            : __printf(2, 3)
     131                 :            : bool __igt_timeout(unsigned long timeout, const char *fmt, ...);
     132                 :            : 
     133                 :            : #define igt_timeout(t, fmt, ...) \
     134                 :            :         __igt_timeout((t), KERN_DEBUG pr_fmt(fmt), ##__VA_ARGS__)
     135                 :            : 
     136                 :            : #endif /* !__I915_SELFTEST_H__ */

Generated by: LCOV version 1.14