mirror of
git://nv-tegra.nvidia.com/linux-nv-oot.git
synced 2025-12-23 01:31:30 +03:00
2bed40f6fe
- dce-os-worker.c/.h module exposes functionality which allows
DCE KMD clients to wait/signal events.
- The current abstraction of this module has following drawbacks
which this change attempts to address:
* Name: dce-os-worker is a misnomer
- Rename to dce-wait-cond.c/.h and make it a dce-kmd core file.
- Rename functions accordingly.
* dce-os-worker module initializes data structures from tegra_dce
which makes it ineligible for re-use.
- dce-client-ipc can re-use this module as it uses exact
same functionality.
- But this module is tied with DCE-KMD core such that it has
functions that operate on fixed known inputs.
- dce_os_work_cond_sw_resource_init/deinit()
Inits/Deinits most but not all condition var resources
from tegra_dce. Eg. dce-client-ipc resources
are not initialized.
- Move this function to new core file:dce-waiters.c
- All other functions require msg_id as input and can only
operate on DCE_WAIT* resources making it ineligible
to be used by other clients like dce-client-ipc.
- Refactor these fucntions to operate on
individual wait conditions so that all DCE-KMD
core modules can reuse them.
- Additionally, this change will also remove unused functions
and macros from dce-os-cond.c/.h
- dce-client-ipc will also switch to use dce-wait-cond interface
for client ipc waits.
- Make dce-os-cond.h a common file and move OS specific impl
to dce-os-cond-internal.h
JIRA TDS-16581
Change-Id: Ie8c6ec724e48cde66917fab4aa43e7da464ef8fb
Signed-off-by: anupamg <anupamg@nvidia.com>
Reviewed-on: https://git-master.nvidia.com/r/c/linux-nv-oot/+/3258562
Reviewed-by: Vinod Gopalakrishnakurup <vinodg@nvidia.com>
Reviewed-by: Arun Swain <arswain@nvidia.com>
83 lines
2.5 KiB
C
83 lines
2.5 KiB
C
/* SPDX-License-Identifier: GPL-2.0-only */
|
|
/*
|
|
* SPDX-FileCopyrightText: Copyright (c) 2024-2025 NVIDIA CORPORATION & AFFILIATES. All rights reserved.
|
|
*/
|
|
|
|
#ifndef DCE_OS_COND_H
|
|
#define DCE_OS_COND_H
|
|
|
|
#include <dce-os-cond-internal.h>
|
|
|
|
/**
|
|
* DCE_OS_COND_WAIT_INTERRUPTIBLE - Wait for a condition to be true
|
|
*
|
|
* @c - The condition variable to sleep on
|
|
* @condition - The condition that needs to be true
|
|
*
|
|
* Wait for a condition to become true. Returns -ERESTARTSYS
|
|
* on signal.
|
|
*/
|
|
#define DCE_OS_COND_WAIT_INTERRUPTIBLE(c, condition) \
|
|
DCE_OS_COND_WAIT_INTERRUPTIBLE_INTERNAL(c, condition)
|
|
|
|
/**
|
|
* DCE_OS_COND_WAIT_INTERRUPTIBLE_TIMEOUT - Wait for a condition to be true
|
|
*
|
|
* @c - The condition variable to sleep on
|
|
* @condition - The condition that needs to be true
|
|
* @timeout_ms - Timeout in milliseconds, or 0 for infinite wait.
|
|
* This parameter must be a u32. Since this is a macro, this is
|
|
* enforced by assigning a typecast NULL pointer to a u32 tmp
|
|
* variable which will generate a compiler warning (or error if
|
|
* the warning is configured as an error).
|
|
*
|
|
* Wait for a condition to become true. Returns -ETIMEOUT if
|
|
* the wait timed out with condition false or -ERESTARTSYS on
|
|
* signal.
|
|
*/
|
|
#define DCE_OS_COND_WAIT_INTERRUPTIBLE_TIMEOUT(c, condition, timeout_ms) \
|
|
DCE_OS_COND_WAIT_INTERRUPTIBLE_TIMEOUT_INTERNAL(c, condition, timeout_ms)
|
|
|
|
/**
|
|
* dce_os_cond_init - Initialize a condition variable
|
|
*
|
|
* @cond - The condition variable to initialize
|
|
*
|
|
* Initialize a condition variable before using it.
|
|
*/
|
|
int dce_os_cond_init(struct dce_os_cond *cond);
|
|
|
|
/**
|
|
* dce_os_cond_destroy - Destroy a condition variable
|
|
*
|
|
* @cond - The condition variable to destroy
|
|
*/
|
|
void dce_os_cond_signal_interruptible(struct dce_os_cond *cond);
|
|
|
|
/**
|
|
* dce_os_cond_signal_interruptible - Signal a condition variable
|
|
*
|
|
* @cond - The condition variable to signal
|
|
*
|
|
* Wake up a waiter for a condition variable to check if its condition has been
|
|
* satisfied.
|
|
*
|
|
* The waiter is using an interruptible wait.
|
|
*/
|
|
int dce_os_cond_broadcast_interruptible(struct dce_os_cond *cond);
|
|
|
|
/**
|
|
* dce_os_cond_broadcast_interruptible - Signal all waiters of a condition
|
|
* variable
|
|
*
|
|
* @cond - The condition variable to signal
|
|
*
|
|
* Wake up all waiters for a condition variable to check if their conditions
|
|
* have been satisfied.
|
|
*
|
|
* The waiters are using an interruptible wait.
|
|
*/
|
|
void dce_os_cond_destroy(struct dce_os_cond *cond);
|
|
|
|
#endif /* DCE_OS_COND_H */
|