0f1bb41bf3
When debugging GPU hangs Mesa developers are finding it useful to replay the captured error state against the simulator. But due various simulator limitations which prevent replicating all hangs, one step further is being able to replay against a real GPU. This is almost doable today with the missing part being able to upload the captured context image into the driver state prior to executing the uploaded hanging batch and all the buffers. To enable this last part we add a new context parameter called I915_CONTEXT_PARAM_CONTEXT_IMAGE. It follows the existing SSEU configuration pattern of being able to select which context to apply against, paired with the actual image and its size. Since this is adding a new concept of debug only uapi, we hide it behind a new kconfig option and also require activation with a module parameter. Together with a warning banner printed at driver load, all those combined should be sufficient to guard against inadvertently enabling the feature. In terms of implementation we allow the legacy context set param to be used since that removes the need to record the per context data in the proto context, while still allowing flexibility of specifying context images for any context. Mesa MR using the uapi can be seen at: https://gitlab.freedesktop.org/mesa/mesa/-/merge_requests/27594 v2: * Fix whitespace alignment as per checkpatch. * Added warning on userspace misuse. * Rebase for extracting ce->default_state shadowing. v3: * Rebase for I915_CONTEXT_PARAM_LOW_LATENCY. Signed-off-by: Tvrtko Ursulin <tvrtko.ursulin@intel.com> Cc: Lionel Landwerlin <lionel.g.landwerlin@intel.com> Cc: Carlos Santa <carlos.santa@intel.com> Cc: Rodrigo Vivi <rodrigo.vivi@intel.com> Reviewed-by: Rodrigo Vivi <rodrigo.vivi@intel.com> Tested-by: Carlos Santa <carlos.santa@intel.com> Signed-off-by: Tvrtko Ursulin <tursulin@igalia.com> Signed-off-by: Tvrtko Ursulin <tursulin@ursulin.net> Link: https://patchwork.freedesktop.org/patch/msgid/20240514145939.87427-2-tursulin@igalia.com
81 lines
3.3 KiB
C
81 lines
3.3 KiB
C
/*
|
|
* Copyright © 2015 Intel Corporation
|
|
*
|
|
* Permission is hereby granted, free of charge, to any person obtaining a
|
|
* copy of this software and associated documentation files (the "Software"),
|
|
* to deal in the Software without restriction, including without limitation
|
|
* the rights to use, copy, modify, merge, publish, distribute, sublicense,
|
|
* and/or sell copies of the Software, and to permit persons to whom the
|
|
* Software is furnished to do so, subject to the following conditions:
|
|
*
|
|
* The above copyright notice and this permission notice (including the next
|
|
* paragraph) shall be included in all copies or substantial portions of the
|
|
* Software.
|
|
*
|
|
* THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
|
|
* IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
|
|
* FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL
|
|
* THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
|
|
* LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
|
|
* FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS
|
|
* IN THE SOFTWARE.
|
|
*
|
|
*/
|
|
|
|
#ifndef _I915_PARAMS_H_
|
|
#define _I915_PARAMS_H_
|
|
|
|
#include <linux/bitops.h>
|
|
#include <linux/cache.h> /* for __read_mostly */
|
|
|
|
struct drm_printer;
|
|
|
|
#define ENABLE_GUC_SUBMISSION BIT(0)
|
|
#define ENABLE_GUC_LOAD_HUC BIT(1)
|
|
#define ENABLE_GUC_MASK GENMASK(1, 0)
|
|
|
|
/*
|
|
* Invoke param, a function-like macro, for each i915 param, with arguments:
|
|
*
|
|
* param(type, name, value, mode)
|
|
*
|
|
* type: parameter type, one of {bool, int, unsigned int, unsigned long, char *}
|
|
* name: name of the parameter
|
|
* value: initial/default value of the parameter
|
|
* mode: debugfs file permissions, one of {0400, 0600, 0}, use 0 to not create
|
|
* debugfs file
|
|
*/
|
|
#define I915_PARAMS_FOR_EACH(param) \
|
|
param(int, modeset, -1, 0400) \
|
|
param(int, enable_guc, -1, 0400) \
|
|
param(int, guc_log_level, -1, 0400) \
|
|
param(char *, guc_firmware_path, NULL, 0400) \
|
|
param(char *, huc_firmware_path, NULL, 0400) \
|
|
param(char *, gsc_firmware_path, NULL, 0400) \
|
|
param(bool, memtest, false, 0400) \
|
|
param(int, mmio_debug, -IS_ENABLED(CONFIG_DRM_I915_DEBUG_MMIO), 0600) \
|
|
param(unsigned int, reset, 3, 0600) \
|
|
param(unsigned int, inject_probe_failure, 0, 0) \
|
|
param(char *, force_probe, CONFIG_DRM_I915_FORCE_PROBE, 0400) \
|
|
param(unsigned int, request_timeout_ms, CONFIG_DRM_I915_REQUEST_TIMEOUT, CONFIG_DRM_I915_REQUEST_TIMEOUT ? 0600 : 0) \
|
|
param(unsigned int, lmem_size, 0, 0400) \
|
|
param(unsigned int, lmem_bar_size, 0, 0400) \
|
|
/* leave bools at the end to not create holes */ \
|
|
param(bool, enable_hangcheck, true, 0600) \
|
|
param(bool, error_capture, true, IS_ENABLED(CONFIG_DRM_I915_CAPTURE_ERROR) ? 0600 : 0) \
|
|
param(bool, enable_gvt, false, IS_ENABLED(CONFIG_DRM_I915_GVT) ? 0400 : 0) \
|
|
param(bool, enable_debug_only_api, false, IS_ENABLED(CONFIG_DRM_I915_REPLAY_GPU_HANGS_API) ? 0400 : 0)
|
|
|
|
#define MEMBER(T, member, ...) T member;
|
|
struct i915_params {
|
|
I915_PARAMS_FOR_EACH(MEMBER);
|
|
};
|
|
#undef MEMBER
|
|
|
|
extern struct i915_params i915_modparams __read_mostly;
|
|
|
|
void i915_params_dump(const struct i915_params *params, struct drm_printer *p);
|
|
void i915_params_copy(struct i915_params *dest, const struct i915_params *src);
|
|
void i915_params_free(struct i915_params *params);
|
|
|
|
#endif
|