[PATCH v2 6/7] drm/xe/configfs: Simplify kernel doc
Lucas De Marchi
lucas.demarchi at intel.com
Thu Jul 24 01:04:27 UTC 2025
>From the caller perspective reading the documentation, there's no need
to be so specific about everything the function is doing/checking. Just
document the functionality a caller cares about.
Signed-off-by: Lucas De Marchi <lucas.demarchi at intel.com>
---
drivers/gpu/drm/xe/xe_configfs.c | 17 ++++-------------
1 file changed, 4 insertions(+), 13 deletions(-)
diff --git a/drivers/gpu/drm/xe/xe_configfs.c b/drivers/gpu/drm/xe/xe_configfs.c
index 8ec1ff1e4e808..e5bdfcf6185ff 100644
--- a/drivers/gpu/drm/xe/xe_configfs.c
+++ b/drivers/gpu/drm/xe/xe_configfs.c
@@ -320,13 +320,10 @@ static struct xe_config_device *configfs_find_group(struct pci_dev *pdev)
}
/**
- * xe_configfs_get_survivability_mode - get configfs survivability mode attribute
+ * xe_configfs_get_survivability_mode - get configfs survivability mode
* @pdev: pci device
*
- * find the configfs group that belongs to the pci device and return
- * the survivability mode attribute
- *
- * Return: survivability mode if config group is found, false otherwise
+ * Return: survivability_mode attribute in configfs
*/
bool xe_configfs_get_survivability_mode(struct pci_dev *pdev)
{
@@ -343,11 +340,8 @@ bool xe_configfs_get_survivability_mode(struct pci_dev *pdev)
}
/**
- * xe_configfs_clear_survivability_mode - clear configfs survivability mode attribute
+ * xe_configfs_clear_survivability_mode - clear configfs survivability mode
* @pdev: pci device
- *
- * find the configfs group that belongs to the pci device and clear survivability
- * mode attribute
*/
void xe_configfs_clear_survivability_mode(struct pci_dev *pdev)
{
@@ -367,10 +361,7 @@ void xe_configfs_clear_survivability_mode(struct pci_dev *pdev)
* xe_configfs_get_engines_allowed - get engine allowed mask from configfs
* @pdev: pci device
*
- * Find the configfs group that belongs to the pci device and return
- * the mask of engines allowed to be used.
- *
- * Return: engine mask with allowed engines
+ * Return: engine mask with allowed engines set in configfs
*/
u64 xe_configfs_get_engines_allowed(struct pci_dev *pdev)
{
--
2.50.1
More information about the Intel-xe
mailing list