drm/debugfs: rework debugfs directory creation v5
authorChristian König <ckoenig.leichtzumerken@gmail.com>
Tue, 29 Aug 2023 11:01:13 +0000 (13:01 +0200)
committerChristian König <christian.koenig@amd.com>
Fri, 1 Sep 2023 06:51:18 +0000 (08:51 +0200)
Instead of the per minor directories only create a single debugfs
directory for the whole device directly when the device is initialized.

For DRM devices each minor gets a symlink to the per device directory
for now until we can be sure that this isn't useful any more in any way.

Accel devices create only the per device directory and also drops the mid
layer callback to create driver specific files.

v2: cleanup accel component as well
v3: fix typo when debugfs is disabled
v4: call drm_debugfs_dev_fini() during release as well,
    some kerneldoc typos fixed
v5: rebased and one more kerneldoc fix

Signed-off-by: Christian König <christian.koenig@amd.com>
Link: https://patchwork.freedesktop.org/patch/msgid/20230829110115.3442-4-christian.koenig@amd.com
Reviewed-by: Andi Shyti <andi.shyti@linux.intel.com>
15 files changed:
drivers/accel/drm_accel.c
drivers/gpu/drm/drm_atomic.c
drivers/gpu/drm/drm_bridge.c
drivers/gpu/drm/drm_client.c
drivers/gpu/drm/drm_crtc_internal.h
drivers/gpu/drm/drm_debugfs.c
drivers/gpu/drm/drm_drv.c
drivers/gpu/drm/drm_framebuffer.c
drivers/gpu/drm/drm_internal.h
include/drm/drm_accel.h
include/drm/drm_bridge.h
include/drm/drm_client.h
include/drm/drm_device.h
include/drm/drm_drv.h
include/drm/drm_file.h

index 01edf2c00b5ad5f3069ec92badc37748ffcc023b..8ba3db2ec5bb92d8b245bed28dae4e5cbd56f936 100644 (file)
@@ -79,26 +79,32 @@ static const struct drm_info_list accel_debugfs_list[] = {
 #define ACCEL_DEBUGFS_ENTRIES ARRAY_SIZE(accel_debugfs_list)
 
 /**
- * accel_debugfs_init() - Initialize debugfs for accel minor
- * @minor: Pointer to the drm_minor instance.
- * @minor_id: The minor's id
+ * accel_debugfs_init() - Initialize debugfs for device
+ * @dev: Pointer to the device instance.
  *
- * This function initializes the drm minor's debugfs members and creates
- * a root directory for the minor in debugfs. It also creates common files
- * for accelerators and calls the driver's debugfs init callback.
+ * This function creates a root directory for the device in debugfs.
  */
-void accel_debugfs_init(struct drm_minor *minor, int minor_id)
+void accel_debugfs_init(struct drm_device *dev)
 {
-       struct drm_device *dev = minor->dev;
-       char name[64];
+       drm_debugfs_dev_init(dev, accel_debugfs_root);
+}
+
+/**
+ * accel_debugfs_register() - Register debugfs for device
+ * @dev: Pointer to the device instance.
+ *
+ * Creates common files for accelerators.
+ */
+void accel_debugfs_register(struct drm_device *dev)
+{
+       struct drm_minor *minor = dev->accel;
 
        INIT_LIST_HEAD(&minor->debugfs_list);
        mutex_init(&minor->debugfs_lock);
-       sprintf(name, "%d", minor_id);
-       minor->debugfs_root = debugfs_create_dir(name, accel_debugfs_root);
+       minor->debugfs_root = dev->debugfs_root;
 
        drm_debugfs_create_files(accel_debugfs_list, ACCEL_DEBUGFS_ENTRIES,
-                                minor->debugfs_root, minor);
+                                dev->debugfs_root, minor);
 }
 
 /**
index 2c454568a607c367fd5ed9c3eb8ba3eaaf60529d..affce6a8851f9c32c4c0044f37b34c3662109dc9 100644 (file)
@@ -1832,9 +1832,9 @@ static const struct drm_debugfs_info drm_atomic_debugfs_list[] = {
        {"state", drm_state_info, 0},
 };
 
-void drm_atomic_debugfs_init(struct drm_minor *minor)
+void drm_atomic_debugfs_init(struct drm_device *dev)
 {
-       drm_debugfs_add_files(minor->dev, drm_atomic_debugfs_list,
+       drm_debugfs_add_files(dev, drm_atomic_debugfs_list,
                              ARRAY_SIZE(drm_atomic_debugfs_list));
 }
 #endif
index 39e68e45bb124bbf21b3a1caceea488a2fdd12de..30d66bee0ec6a9d750947dd92256ad7ee5168a42 100644 (file)
@@ -1384,9 +1384,9 @@ static const struct drm_debugfs_info drm_bridge_debugfs_list[] = {
        { "bridge_chains", drm_bridge_chains_info, 0 },
 };
 
-void drm_bridge_debugfs_init(struct drm_minor *minor)
+void drm_bridge_debugfs_init(struct drm_device *dev)
 {
-       drm_debugfs_add_files(minor->dev, drm_bridge_debugfs_list,
+       drm_debugfs_add_files(dev, drm_bridge_debugfs_list,
                              ARRAY_SIZE(drm_bridge_debugfs_list));
 }
 #endif
index 037e36f2049c1793d287ca6cbeff7d7a8870a610..2762572f286e7b2e89b2252c7b28c39ad3806a05 100644 (file)
@@ -535,9 +535,9 @@ static const struct drm_debugfs_info drm_client_debugfs_list[] = {
        { "internal_clients", drm_client_debugfs_internal_clients, 0 },
 };
 
-void drm_client_debugfs_init(struct drm_minor *minor)
+void drm_client_debugfs_init(struct drm_device *dev)
 {
-       drm_debugfs_add_files(minor->dev, drm_client_debugfs_list,
+       drm_debugfs_add_files(dev, drm_client_debugfs_list,
                              ARRAY_SIZE(drm_client_debugfs_list));
 }
 #endif
index 501a10edd0e1dc5949f5f99b802d219f64f9d1ec..8556c3b3ff88ac2052b6461bce683b96472164ae 100644 (file)
@@ -232,7 +232,7 @@ int drm_mode_dirtyfb_ioctl(struct drm_device *dev,
 /* drm_atomic.c */
 #ifdef CONFIG_DEBUG_FS
 struct drm_minor;
-void drm_atomic_debugfs_init(struct drm_minor *minor);
+void drm_atomic_debugfs_init(struct drm_device *dev);
 #endif
 
 int __drm_atomic_helper_disable_plane(struct drm_plane *plane,
index 8a4c90fd9f0293d74794bd70b078c636267ac49b..5ec28c0e12d9b21207db86c19fb1f0a11f762b85 100644 (file)
@@ -266,8 +266,46 @@ void drm_debugfs_create_files(const struct drm_info_list *files, int count,
 }
 EXPORT_SYMBOL(drm_debugfs_create_files);
 
-int drm_debugfs_init(struct drm_minor *minor, int minor_id,
-                    struct dentry *root)
+/**
+ * drm_debugfs_dev_init - create debugfs directory for the device
+ * @dev: the device which we want to create the directory for
+ * @root: the parent directory depending on the device type
+ *
+ * Creates the debugfs directory for the device under the given root directory.
+ */
+void drm_debugfs_dev_init(struct drm_device *dev, struct dentry *root)
+{
+       dev->debugfs_root = debugfs_create_dir(dev->unique, root);
+}
+
+/**
+ * drm_debugfs_dev_fini - cleanup debugfs directory
+ * @dev: the device to cleanup the debugfs stuff
+ *
+ * Remove the debugfs directory, might be called multiple times.
+ */
+void drm_debugfs_dev_fini(struct drm_device *dev)
+{
+       debugfs_remove_recursive(dev->debugfs_root);
+       dev->debugfs_root = NULL;
+}
+
+void drm_debugfs_dev_register(struct drm_device *dev)
+{
+       drm_debugfs_add_files(dev, drm_debugfs_list, DRM_DEBUGFS_ENTRIES);
+
+       if (drm_core_check_feature(dev, DRIVER_MODESET)) {
+               drm_framebuffer_debugfs_init(dev);
+               drm_client_debugfs_init(dev);
+       }
+       if (drm_drv_uses_atomic_modeset(dev)) {
+               drm_atomic_debugfs_init(dev);
+               drm_bridge_debugfs_init(dev);
+       }
+}
+
+int drm_debugfs_register(struct drm_minor *minor, int minor_id,
+                        struct dentry *root)
 {
        struct drm_device *dev = minor->dev;
        struct drm_debugfs_entry *entry, *tmp;
@@ -276,20 +314,11 @@ int drm_debugfs_init(struct drm_minor *minor, int minor_id,
        INIT_LIST_HEAD(&minor->debugfs_list);
        mutex_init(&minor->debugfs_lock);
        sprintf(name, "%d", minor_id);
-       minor->debugfs_root = debugfs_create_dir(name, root);
-
-       drm_debugfs_add_files(minor->dev, drm_debugfs_list, DRM_DEBUGFS_ENTRIES);
+       minor->debugfs_symlink = debugfs_create_symlink(name, root,
+                                                       dev->unique);
 
-       if (drm_drv_uses_atomic_modeset(dev)) {
-               drm_atomic_debugfs_init(minor);
-               drm_bridge_debugfs_init(minor);
-       }
-
-       if (drm_core_check_feature(dev, DRIVER_MODESET)) {
-               drm_framebuffer_debugfs_init(minor);
-
-               drm_client_debugfs_init(minor);
-       }
+       /* TODO: Only for compatibility with drivers */
+       minor->debugfs_root = dev->debugfs_root;
 
        if (dev->driver->debugfs_init && dev->render != minor)
                dev->driver->debugfs_init(minor);
@@ -356,13 +385,12 @@ static void drm_debugfs_remove_all_files(struct drm_minor *minor)
 
 void drm_debugfs_cleanup(struct drm_minor *minor)
 {
-       if (!minor->debugfs_root)
+       if (!minor->debugfs_symlink)
                return;
 
        drm_debugfs_remove_all_files(minor);
-
-       debugfs_remove_recursive(minor->debugfs_root);
-       minor->debugfs_root = NULL;
+       debugfs_remove(minor->debugfs_symlink);
+       minor->debugfs_symlink = NULL;
 }
 
 /**
@@ -547,13 +575,13 @@ static const struct file_operations drm_connector_fops = {
 
 void drm_debugfs_connector_add(struct drm_connector *connector)
 {
-       struct drm_minor *minor = connector->dev->primary;
+       struct drm_device *dev = connector->dev;
        struct dentry *root;
 
-       if (!minor->debugfs_root)
+       if (!dev->debugfs_root)
                return;
 
-       root = debugfs_create_dir(connector->name, minor->debugfs_root);
+       root = debugfs_create_dir(connector->name, dev->debugfs_root);
        connector->debugfs_entry = root;
 
        /* force */
@@ -588,7 +616,7 @@ void drm_debugfs_connector_remove(struct drm_connector *connector)
 
 void drm_debugfs_crtc_add(struct drm_crtc *crtc)
 {
-       struct drm_minor *minor = crtc->dev->primary;
+       struct drm_device *dev = crtc->dev;
        struct dentry *root;
        char *name;
 
@@ -596,7 +624,7 @@ void drm_debugfs_crtc_add(struct drm_crtc *crtc)
        if (!name)
                return;
 
-       root = debugfs_create_dir(name, minor->debugfs_root);
+       root = debugfs_create_dir(name, dev->debugfs_root);
        kfree(name);
 
        crtc->debugfs_entry = root;
index 3eda026ffac6a9e654dd7def6e34eca8b7e34676..d28f415cd733f95d4ea4b49599b5f042703f4ac0 100644 (file)
@@ -172,10 +172,9 @@ static int drm_minor_register(struct drm_device *dev, enum drm_minor_type type)
        if (!minor)
                return 0;
 
-       if (minor->type == DRM_MINOR_ACCEL) {
-               accel_debugfs_init(minor, minor->index);
-       } else {
-               ret = drm_debugfs_init(minor, minor->index, drm_debugfs_root);
+       if (minor->type != DRM_MINOR_ACCEL) {
+               ret = drm_debugfs_register(minor, minor->index,
+                                          drm_debugfs_root);
                if (ret) {
                        DRM_ERROR("DRM: Failed to initialize /sys/kernel/debug/dri.\n");
                        goto err_debugfs;
@@ -697,6 +696,11 @@ static int drm_dev_init(struct drm_device *dev,
                goto err;
        }
 
+       if (drm_core_check_feature(dev, DRIVER_COMPUTE_ACCEL))
+               accel_debugfs_init(dev);
+       else
+               drm_debugfs_dev_init(dev, drm_debugfs_root);
+
        return 0;
 
 err:
@@ -786,6 +790,9 @@ static void drm_dev_release(struct kref *ref)
 {
        struct drm_device *dev = container_of(ref, struct drm_device, ref);
 
+       /* Just in case register/unregister was never called */
+       drm_debugfs_dev_fini(dev);
+
        if (dev->driver->release)
                dev->driver->release(dev);
 
@@ -916,6 +923,11 @@ int drm_dev_register(struct drm_device *dev, unsigned long flags)
        if (drm_dev_needs_global_mutex(dev))
                mutex_lock(&drm_global_mutex);
 
+       if (drm_core_check_feature(dev, DRIVER_COMPUTE_ACCEL))
+               accel_debugfs_register(dev);
+       else
+               drm_debugfs_dev_register(dev);
+
        ret = drm_minor_register(dev, DRM_MINOR_RENDER);
        if (ret)
                goto err_minors;
@@ -1001,6 +1013,7 @@ void drm_dev_unregister(struct drm_device *dev)
        drm_minor_unregister(dev, DRM_MINOR_ACCEL);
        drm_minor_unregister(dev, DRM_MINOR_PRIMARY);
        drm_minor_unregister(dev, DRM_MINOR_RENDER);
+       drm_debugfs_dev_fini(dev);
 }
 EXPORT_SYMBOL(drm_dev_unregister);
 
index aff3746dedfb48af4403d70afda35e5a0f85147c..ba51deb6d04247cb65c67b9ab72a86827d2320fd 100644 (file)
@@ -1222,9 +1222,9 @@ static const struct drm_debugfs_info drm_framebuffer_debugfs_list[] = {
        { "framebuffer", drm_framebuffer_info, 0 },
 };
 
-void drm_framebuffer_debugfs_init(struct drm_minor *minor)
+void drm_framebuffer_debugfs_init(struct drm_device *dev)
 {
-       drm_debugfs_add_files(minor->dev, drm_framebuffer_debugfs_list,
+       drm_debugfs_add_files(dev, drm_framebuffer_debugfs_list,
                              ARRAY_SIZE(drm_framebuffer_debugfs_list));
 }
 #endif
index ba12acd551390b8e96151139f786487d95e02a95..dee75a9cc59e9e61ed96a796a331d35b534fe6dd 100644 (file)
@@ -180,8 +180,10 @@ void drm_gem_vunmap(struct drm_gem_object *obj, struct iosys_map *map);
 
 /* drm_debugfs.c drm_debugfs_crc.c */
 #if defined(CONFIG_DEBUG_FS)
-int drm_debugfs_init(struct drm_minor *minor, int minor_id,
-                    struct dentry *root);
+void drm_debugfs_dev_fini(struct drm_device *dev);
+void drm_debugfs_dev_register(struct drm_device *dev);
+int drm_debugfs_register(struct drm_minor *minor, int minor_id,
+                        struct dentry *root);
 void drm_debugfs_cleanup(struct drm_minor *minor);
 void drm_debugfs_late_register(struct drm_device *dev);
 void drm_debugfs_connector_add(struct drm_connector *connector);
@@ -190,8 +192,16 @@ void drm_debugfs_crtc_add(struct drm_crtc *crtc);
 void drm_debugfs_crtc_remove(struct drm_crtc *crtc);
 void drm_debugfs_crtc_crc_add(struct drm_crtc *crtc);
 #else
-static inline int drm_debugfs_init(struct drm_minor *minor, int minor_id,
-                                  struct dentry *root)
+static inline void drm_debugfs_dev_fini(struct drm_device *dev)
+{
+}
+
+static inline void drm_debugfs_dev_register(struct drm_device *dev)
+{
+}
+
+static inline int drm_debugfs_register(struct drm_minor *minor, int minor_id,
+                                      struct dentry *root)
 {
        return 0;
 }
@@ -259,4 +269,4 @@ int drm_syncobj_query_ioctl(struct drm_device *dev, void *data,
 /* drm_framebuffer.c */
 void drm_framebuffer_print_info(struct drm_printer *p, unsigned int indent,
                                const struct drm_framebuffer *fb);
-void drm_framebuffer_debugfs_init(struct drm_minor *minor);
+void drm_framebuffer_debugfs_init(struct drm_device *dev);
index d4955062c77e3988cdf2d032a39c99d810318811..f4d3784b1dce0572a974e3924c31b90db4540ad8 100644 (file)
@@ -58,7 +58,8 @@ int accel_minor_alloc(void);
 void accel_minor_replace(struct drm_minor *minor, int index);
 void accel_set_device_instance_params(struct device *kdev, int index);
 int accel_open(struct inode *inode, struct file *filp);
-void accel_debugfs_init(struct drm_minor *minor, int minor_id);
+void accel_debugfs_init(struct drm_device *dev);
+void accel_debugfs_register(struct drm_device *dev);
 
 #else
 
@@ -89,7 +90,11 @@ static inline void accel_set_device_instance_params(struct device *kdev, int ind
 {
 }
 
-static inline void accel_debugfs_init(struct drm_minor *minor, int minor_id)
+static inline void accel_debugfs_init(struct drm_device *dev)
+{
+}
+
+static inline void accel_debugfs_register(struct drm_device *dev)
 {
 }
 
index c339fc85fd076dd20f06d0f72397023c36fa50d5..2dd94224f17e8b907e46bb63bb0f93bb5090887c 100644 (file)
@@ -950,6 +950,6 @@ static inline struct drm_bridge *drmm_of_get_bridge(struct drm_device *drm,
 }
 #endif
 
-void drm_bridge_debugfs_init(struct drm_minor *minor);
+void drm_bridge_debugfs_init(struct drm_device *dev);
 
 #endif
index c0a14b40c039fcff90848d5f3d068452ed070d3a..d47458ecdac462d1a3119db6e7efe9b7107cc017 100644 (file)
@@ -195,6 +195,6 @@ int drm_client_modeset_dpms(struct drm_client_dev *client, int mode);
        drm_for_each_connector_iter(connector, iter) \
                if (connector->connector_type != DRM_MODE_CONNECTOR_WRITEBACK)
 
-void drm_client_debugfs_init(struct drm_minor *minor);
+void drm_client_debugfs_init(struct drm_device *dev);
 
 #endif
index 7cf4afae2e790e71d58fa654194831564e24570b..3cf12b14232dd4acd45d12e10491f5114cb2f15f 100644 (file)
@@ -311,6 +311,13 @@ struct drm_device {
         */
        struct drm_fb_helper *fb_helper;
 
+       /**
+        * @debugfs_root:
+        *
+        * Root directory for debugfs files.
+        */
+       struct dentry *debugfs_root;
+
        /**
         * @debugfs_mutex:
         *
index 9813fa759b75d4dd39350a6eb687fbf455a64aed..9850fe73b7395afddf6181f8b40701553013df49 100644 (file)
@@ -581,4 +581,12 @@ static inline bool drm_firmware_drivers_only(void)
        return video_firmware_drivers_only();
 }
 
+#if defined(CONFIG_DEBUG_FS)
+void drm_debugfs_dev_init(struct drm_device *dev, struct dentry *root);
+#else
+static void drm_debugfs_dev_init(struct drm_device *dev, struct dentry *root)
+{
+}
+#endif
+
 #endif
index 010239392adfb92477edfe12a95a1275e9b0b1bb..12930a08368ccc97faba670cb7178dacf34e9457 100644 (file)
@@ -79,6 +79,7 @@ struct drm_minor {
        struct device *kdev;            /* Linux device */
        struct drm_device *dev;
 
+       struct dentry *debugfs_symlink;
        struct dentry *debugfs_root;
 
        struct list_head debugfs_list;