mirror of
https://git.kernel.org/pub/scm/linux/kernel/git/stable/linux.git
synced 2025-08-31 05:40:36 +00:00
76eb09c8e5
There is no need to return an error from xe_force_wake_put(), as a failure implicitly indicates that the domain failed to sleep. v3 - Move kernel-doc to this patch (Badal) v5 - change parameter to unsigned int in xe_force_wake_put() v6 - Remove unneccsary wrapping (Michal) - Remove non required header (Michal) - Mention timeout(Michal) v8 - Fix kernel-doc Cc: Michal Wajdeczko <michal.wajdeczko@intel.com> Cc: Badal Nilawar <badal.nilawar@intel.com> Cc: Rodrigo Vivi <rodrigo.vivi@intel.com> Cc: Lucas De Marchi <lucas.demarchi@intel.com> Cc: Nirmoy Das <nirmoy.das@intel.com> Reviewed-by: Badal Nilawar <badal.nilawar@intel.com> Signed-off-by: Himal Prasad Ghimiray <himal.prasad.ghimiray@intel.com> Reviewed-by: Michal Wajdeczko <michal.wajdeczko@intel.com> Reviewed-by: Nirmoy Das <nirmoy.das@intel.com> Link: https://patchwork.freedesktop.org/patch/msgid/20241014075601.2324382-27-himal.prasad.ghimiray@intel.com Signed-off-by: Rodrigo Vivi <rodrigo.vivi@intel.com>
65 lines
1.8 KiB
C
65 lines
1.8 KiB
C
/* SPDX-License-Identifier: MIT */
|
|
/*
|
|
* Copyright © 2022 Intel Corporation
|
|
*/
|
|
|
|
#ifndef _XE_FORCE_WAKE_H_
|
|
#define _XE_FORCE_WAKE_H_
|
|
|
|
#include "xe_assert.h"
|
|
#include "xe_force_wake_types.h"
|
|
|
|
struct xe_gt;
|
|
|
|
void xe_force_wake_init_gt(struct xe_gt *gt,
|
|
struct xe_force_wake *fw);
|
|
void xe_force_wake_init_engines(struct xe_gt *gt,
|
|
struct xe_force_wake *fw);
|
|
unsigned int __must_check xe_force_wake_get(struct xe_force_wake *fw,
|
|
enum xe_force_wake_domains domains);
|
|
void xe_force_wake_put(struct xe_force_wake *fw, unsigned int fw_ref);
|
|
|
|
static inline int
|
|
xe_force_wake_ref(struct xe_force_wake *fw,
|
|
enum xe_force_wake_domains domain)
|
|
{
|
|
xe_gt_assert(fw->gt, domain != XE_FORCEWAKE_ALL);
|
|
return fw->domains[ffs(domain) - 1].ref;
|
|
}
|
|
|
|
/**
|
|
* xe_force_wake_assert_held - asserts domain is awake
|
|
* @fw : xe_force_wake structure
|
|
* @domain: xe_force_wake_domains apart from XE_FORCEWAKE_ALL
|
|
*
|
|
* xe_force_wake_assert_held() is designed to confirm a particular
|
|
* forcewake domain's wakefulness; it doesn't verify the wakefulness of
|
|
* multiple domains. Make sure the caller doesn't input multiple
|
|
* domains(XE_FORCEWAKE_ALL) as a parameter.
|
|
*/
|
|
static inline void
|
|
xe_force_wake_assert_held(struct xe_force_wake *fw,
|
|
enum xe_force_wake_domains domain)
|
|
{
|
|
xe_gt_assert(fw->gt, domain != XE_FORCEWAKE_ALL);
|
|
xe_gt_assert(fw->gt, fw->awake_domains & domain);
|
|
}
|
|
|
|
/**
|
|
* xe_force_wake_ref_has_domain - verifies if the domains are in fw_ref
|
|
* @fw_ref : the force_wake reference
|
|
* @domain : forcewake domain to verify
|
|
*
|
|
* This function confirms whether the @fw_ref includes a reference to the
|
|
* specified @domain.
|
|
*
|
|
* Return: true if domain is refcounted.
|
|
*/
|
|
static inline bool
|
|
xe_force_wake_ref_has_domain(unsigned int fw_ref, enum xe_force_wake_domains domain)
|
|
{
|
|
return fw_ref & domain;
|
|
}
|
|
|
|
#endif
|