drm/ioctl: Add a ioctl to label GEM objects
Subsystems (2)
PATCH v3 1/1 drm/ioctl: Add a ioctl to label GEM objects
DRM_IOCTL_BO_SET_LABEL lets you label GEM objects, making it easier to debug issues in userspace applications.
Changes in v2:
- Hoist the IOCTL up into the drm_driver framework
Changes in v3:
- Introduce a drm_gem_set_label for drivers to use internally in order to label a GEM object
- Hoist string copying up into the IOCTL
- Fix documentation
- Move actual gem labeling into drm_gem_adopt_label
--- drivers/gpu/drm/drm_gem.c | 69 ++++++++++++++++++++++++++++++++++ drivers/gpu/drm/drm_internal.h | 3 ++ drivers/gpu/drm/drm_ioctl.c | 1 + include/drm/drm_drv.h | 13 +++++++ include/drm/drm_gem.h | 7 ++++ include/uapi/drm/drm.h | 20 ++++++++++ 6 files changed, 113 insertions(+)
drivers/gpu/drm/drm_gem.c +69 -0
@@ -941,6 +941,70 @@ drm_gem_release(struct drm_device *dev, struct drm_file *file_private)idr_destroy (&file_private->object_idr); } +int drm_gem_set_label_ioctl (struct drm_device *dev,void *data, +struct drm_file *file_priv) +{ +struct drm_gem_set_label_object *args = data; +struct drm_gem_object *gem_obj; +int ret =0 ; +char *label =NULL ; + +if (!args->len || !args->name) +return -EINVAL ; + +if (!dev->driver->label) +return -EOPNOTSUPP ; + +if (args->len >0 ) + label =strndup_user (u64_to_user_ptr (args->name), args->len); + +if (IS_ERR (label)) { + ret =PTR_ERR (label); + goto err; + } + + gem_obj =drm_gem_object_lookup (file_priv, args->handle); +if (!gem_obj) { +DRM_DEBUG ("Failed to look up GEM BO %d\n" , args->handle); + ret = -ENOENT ; + goto err; + } + + dev->driver->label (gem_obj, label, args->len); +drm_gem_object_put_unlocked (gem_obj); + +return 0 ; +err: +kfree (label); +return ret; +} + +static void drm_gem_adopt_label (struct drm_gem_object *gem_obj,char *label,int len) +{ +if ((len ==0 && label ==NULL ) || gem_obj->label) { +kfree (gem_obj->label); + gem_obj->label =NULL ; + } + + gem_obj->label = label; +} +EXPORT_SYMBOL (drm_gem_adopt_label); + +int drm_gem_set_label (struct drm_gem_object *gem_obj,const char *label,int len) +{ +char *new_label =NULL ; + +if (label) { + new_label =kstrndup (label, len,GFP_KERNEL ); +if (IS_ERR (new_label)) +return PTR_ERR (new_label); + } + +drm_gem_adopt_label (gem_obj, new_label, len); +return 0 ; +} +EXPORT_SYMBOL (drm_gem_set_label); +/** * drm_gem_object_release - release GEM buffer object resources * @obj: GEM buffer object
@@ -958,6 +1022,11 @@ drm_gem_object_release(struct drm_gem_object *obj)dma_resv_fini (&obj->_resv);drm_gem_free_mmap_offset (obj); + +if (obj->label) { +kfree (obj->label); + obj->label =NULL ; + } }EXPORT_SYMBOL (drm_gem_object_release);
drivers/gpu/drm/drm_internal.h +3 -0
@@ -137,6 +137,9 @@ int drm_gem_pin(struct drm_gem_object *obj);void drm_gem_unpin (struct drm_gem_object *obj);void *drm_gem_vmap (struct drm_gem_object *obj);void drm_gem_vunmap (struct drm_gem_object *obj,void *vaddr); +int drm_gem_set_label_ioctl (struct drm_device *dev,void *data, +struct drm_file *file_priv); +int drm_gem_set_label (struct drm_gem_object *gem_obj,const char *label,int len);/* drm_debugfs.c drm_debugfs_crc.c */ #if defined(CONFIG_DEBUG_FS )
drivers/gpu/drm/drm_ioctl.c +1 -0
@@ -709,6 +709,7 @@ static const struct drm_ioctl_desc drm_ioctls[] = {DRM_IOCTL_DEF (DRM_IOCTL_MODE_LIST_LESSEES , drm_mode_list_lessees_ioctl,DRM_MASTER ),DRM_IOCTL_DEF (DRM_IOCTL_MODE_GET_LEASE , drm_mode_get_lease_ioctl,DRM_MASTER ),DRM_IOCTL_DEF (DRM_IOCTL_MODE_REVOKE_LEASE , drm_mode_revoke_lease_ioctl,DRM_MASTER ), + DRM_IOCTL_DEF(DRM_IOCTL_GEM_SET_LABEL, drm_gem_set_label_ioctl, DRM_RENDER_ALLOW), };#define DRM_CORE_IOCTL_COUNT ARRAY_SIZE( drm_ioctls )
include/drm/drm_drv.h +13 -0
@@ -715,6 +715,19 @@ struct drm_driver {struct drm_device *dev, uint32_t handle); +/** +* @label: +* +* This label's a buffer object. +* +* Called by the user via ioctl. +* +* Returns: +* +* Zero on success, negative errno on failure. +*/ +int (*label)(struct drm_gem_object *gem_obj,const char *label,int len); +/** * @gem_vm_ops: Driver private ops for this object *
include/drm/drm_gem.h +7 -0
@@ -237,6 +237,13 @@ struct drm_gem_object {*/ int name; +/** +* @label: +* +* Label for this object, should be a human readable string. +*/ +char *label; +/** * @dma_buf: *
include/uapi/drm/drm.h +20 -0
@@ -626,6 +626,25 @@ struct drm_gem_open {__u64 size; }; +/** struct drm_gem_set_label_object - ioctl argument for labelling BOs. +* +* This label's a BO with a userspace label +* +*/ +struct drm_gem_set_label_object { +/** Handle for the object being labelled. */ +__u32 handle; + +/** Label and label length. +* len includes the trailing NUL. +*/ +__u32 len; +__u64 name; + +/** Flags */ +int flags; +}; +#define DRM_CAP_DUMB_BUFFER 0x1#define DRM_CAP_VBLANK_HIGH_CRTC 0x2#define DRM_CAP_DUMB_PREFERRED_DEPTH 0x3
@@ -946,6 +965,7 @@ extern "C" {#define DRM_IOCTL_SYNCOBJ_QUERY DRM_IOWR(0xCB, struct drm_syncobj_timeline_array)#define DRM_IOCTL_SYNCOBJ_TRANSFER DRM_IOWR(0xCC, struct drm_syncobj_transfer)#define DRM_IOCTL_SYNCOBJ_TIMELINE_SIGNAL DRM_IOWR(0xCD, struct drm_syncobj_timeline_array) +#define DRM_IOCTL_GEM_SET_LABEL DRM_IOWR(0xCE, struct drm_gem_set_label_object)/** * Device specific ioctls should only be in their respective headers
Signature · 6 lines
2.17.1 _______________________________________________ dri-devel mailing list [email protected] https://lists.freedesktop.org/mailman/listinfo/dri-devel
Thomas Zimmermann
maintainerHi Rohan
First of all, I'm not in a position to merge new ioctls, so take my review with a grain of salt. You should get a review from one of the DRM maintainers. If no one shows up, ping danvet on IRC.
Am 26.09.19 um 17:36 schrieb Rohan Garg:
Quoted 1 line
DRM_IOCTL_BO_SET_LABELlets you label GEM objects, making it
The code says DRM_IOCTL_GEM_SET_LABEL.
Quoted 1 line
easier to debug issues in userspace applications.
I'd appreciate pointers to an actual user-space application that makes use of this functionality; or at least a prototype. We should not merge ioctls that have no users. You should also wire-up at least one driver, so that the code has an internal user.
Quoted 26 lines
Changes in v2:
- Hoist the IOCTL up into thedrm_driverframeworkChanges in v3:
- Introduce adrm_gem_set_labelfor drivers to use internally in order to label a GEM object
- Hoist string copying up into the IOCTL
- Fix documentation
- Move actual gem labeling intodrm_gem_adopt_labelSigned-off-by Rohan Garg <[email protected]>--- drivers/gpu/drm/drm_gem.c | 69 ++++++++++++++++++++++++++++++++++ drivers/gpu/drm/drm_internal.h | 3 ++ drivers/gpu/drm/drm_ioctl.c | 1 + include/drm/drm_drv.h | 13 +++++++ include/drm/drm_gem.h | 7 ++++ include/uapi/drm/drm.h | 20 ++++++++++ 6 files changed, 113 insertions(+)drivers/gpu/drm/drm_gem.c +0
-0
drivers/gpu/drm/drm_gem.c drm_gem_release(struct drm_device *dev, struct drm_file *file_private) · line 942
Quoted 2 lines
drivers/gpu/drm/drm_gem.c +0
-0@@ -941,6 +941,70 @@ drm_gem_release(struct drm_device *dev, struct drm_file *file_private)idr_destroy (&file_private->object_idr); }
There's no generic ioctl interface for creating BOs in DRM. The closes thing is dumb buffers, which return plain, unaccelerated framebuffers. Drivers that want more have to provide their own ioctls.
Therefore, I don't think that this ioctl should be specific to GEM buffer objects. Maybe make it a dump-buffer interface that defaults to the GEM implementation, see drm_mode_mmap_dumb_ioctl [1] for an example. Drivers with more sophisticated buffer objects can add their own ioctls for labeling.
drivers/gpu/drm/drm_gem.c drm_gem_release(struct drm_device *dev, struct drm_file *file_private) · line 945
Quoted 2 lines
drivers/gpu/drm/drm_gem.c +2
-0+int drm_gem_set_label_ioctl (struct drm_device *dev,void *data, +struct drm_file *file_priv)
This function should be the default for dev->driver->label; similar to [1].
Quoted 18 lines
drivers/gpu/drm/drm_gem.c +18
-0+{ +struct drm_gem_set_label_object *args = data; +struct drm_gem_object *gem_obj; +int ret =0 ; +char *label =NULL ; + +if (!args->len || !args->name) +return -EINVAL ; + +if (!dev->driver->label) +return -EOPNOTSUPP ; + +if (args->len >0 ) + label =strndup_user (u64_to_user_ptr (args->name), args->len); + +if (IS_ERR (label)) { + ret =PTR_ERR (label); + goto err;
drivers/gpu/drm/drm_gem.c drm_gem_release(struct drm_device *dev, struct drm_file *file_private) · line 973
Quoted 10 lines
drivers/gpu/drm/drm_gem.c +10
-0+ } + + gem_obj =drm_gem_object_lookup (file_priv, args->handle); +if (!gem_obj) { +DRM_DEBUG ("Failed to look up GEM BO %d\n" , args->handle); + ret = -ENOENT ; + goto err; + } + + dev->driver->label (gem_obj, label, args->len);
Call drm_gem_adopt_label() directly here. Using a callback from struct drm_driver is not the right level of abstraction at this point.
drivers/gpu/drm/drm_gem.c drm_gem_release(struct drm_device *dev, struct drm_file *file_private) · line 982
Quoted 9 lines
drivers/gpu/drm/drm_gem.c +9
-0+drm_gem_object_put_unlocked (gem_obj); + +return 0 ; +err: +kfree (label); +return ret; +} + +static void drm_gem_adopt_label (struct drm_gem_object *gem_obj,char *label,int len)
The adopt function doesn't really need len, so please leave it out. The value of label is NULL or the new label string. That should be all that this function needs.
drivers/gpu/drm/drm_gem.c drm_gem_release(struct drm_device *dev, struct drm_file *file_private) · line 987
Quoted 5 lines
drivers/gpu/drm/drm_gem.c +5
-0+{ +if ((len ==0 && label ==NULL ) || gem_obj->label) { +kfree (gem_obj->label); + gem_obj->label =NULL ; + }
Please split this branch into two. If gem_obj->label is set, you always want to kfree the memory. Afterwards, assign the label's new value. How can a caller clear the label.
drivers/gpu/drm/drm_gem.c drm_gem_release(struct drm_device *dev, struct drm_file *file_private) · line 991
Quoted 4 lines
drivers/gpu/drm/drm_gem.c +4
-0+ + gem_obj->label = label; +} +EXPORT_SYMBOL (drm_gem_adopt_label);
You're exporting a static function.
drivers/gpu/drm/drm_gem.c drm_gem_release(struct drm_device *dev, struct drm_file *file_private) · line 998
Quoted 7 lines
drivers/gpu/drm/drm_gem.c +7
-0+ +int drm_gem_set_label (struct drm_gem_object *gem_obj,const char *label,int len) +{ +char *new_label =NULL ; + +if (label) { + new_label =kstrndup (label, len,GFP_KERNEL );
Please also don't use len and simply call kstrdup().
Quoted 43 lines
drivers/gpu/drm/drm_gem.c +14
-0+if (IS_ERR (new_label)) +return PTR_ERR (new_label); + } + +drm_gem_adopt_label (gem_obj, new_label, len); +return 0 ; +} +EXPORT_SYMBOL (drm_gem_set_label); +/** * drm_gem_object_release - release GEM buffer object resources * @obj: GEM buffer object @@ -958,6 +1022,11 @@ drm_gem_object_release(struct drm_gem_object *obj)dma_resv_fini (&obj->_resv);drm_gem_free_mmap_offset (obj); + +if (obj->label) { +kfree (obj->label); + obj->label =NULL ; + } }EXPORT_SYMBOL (drm_gem_object_release);drivers/gpu/drm/drm_internal.h +3
-0@@ -137,6 +137,9 @@ int drm_gem_pin(struct drm_gem_object *obj);void drm_gem_unpin (struct drm_gem_object *obj);void *drm_gem_vmap (struct drm_gem_object *obj);void drm_gem_vunmap (struct drm_gem_object *obj,void *vaddr); +int drm_gem_set_label_ioctl (struct drm_device *dev,void *data, +struct drm_file *file_priv); +int drm_gem_set_label (struct drm_gem_object *gem_obj,const char *label,int len);/* drm_debugfs.c drm_debugfs_crc.c */ #if defined(CONFIG_DEBUG_FS )drivers/gpu/drm/drm_ioctl.c +0
-0
drivers/gpu/drm/drm_ioctl.c static const struct drm_ioctl_desc drm_ioctls[] = { · line 712
Quoted 4 lines
drivers/gpu/drm/drm_ioctl.c +1
-0@@ -709,6 +709,7 @@ static const struct drm_ioctl_desc drm_ioctls[] = {DRM_IOCTL_DEF (DRM_IOCTL_MODE_LIST_LESSEES , drm_mode_list_lessees_ioctl,DRM_MASTER ),DRM_IOCTL_DEF (DRM_IOCTL_MODE_GET_LEASE , drm_mode_get_lease_ioctl,DRM_MASTER ),DRM_IOCTL_DEF (DRM_IOCTL_MODE_REVOKE_LEASE , drm_mode_revoke_lease_ioctl,DRM_MASTER ), + DRM_IOCTL_DEF(DRM_IOCTL_GEM_SET_LABEL, drm_gem_set_label_ioctl, DRM_RENDER_ALLOW),
As mentioned, I'd rather use DRM_IOCTL_MODE_LABEL_DUMP that labels a dumb buffer.
Best regards
Thomas
Quoted 84 lines
drivers/gpu/drm/drm_ioctl.c +0
-0};#define DRM_CORE_IOCTL_COUNT ARRAY_SIZE( drm_ioctls )include/drm/drm_drv.h +13
-0@@ -715,6 +715,19 @@ struct drm_driver {struct drm_device *dev, uint32_t handle); +/** +* @label: +* +* This label's a buffer object. +* +* Called by the user via ioctl. +* +* Returns: +* +* Zero on success, negative errno on failure. +*/ +int (*label)(struct drm_gem_object *gem_obj,const char *label,int len); +/** * @gem_vm_ops: Driver private ops for this object * include/drm/drm_gem.h +7
-0@@ -237,6 +237,13 @@ struct drm_gem_object {*/ int name; +/** +* @label: +* +* Label for this object, should be a human readable string. +*/ +char *label; +/** * @dma_buf: * include/uapi/drm/drm.h +20
-0@@ -626,6 +626,25 @@ struct drm_gem_open {__u64 size; }; +/** struct drm_gem_set_label_object - ioctl argument for labelling BOs. +* +* This label's a BO with a userspace label +* +*/ +struct drm_gem_set_label_object { +/** Handle for the object being labelled. */ +__u32 handle; + +/** Label and label length. +* len includes the trailing NUL. +*/ +__u32 len; +__u64 name; + +/** Flags */ +int flags; +}; +#define DRM_CAP_DUMB_BUFFER 0x1#define DRM_CAP_VBLANK_HIGH_CRTC 0x2#define DRM_CAP_DUMB_PREFERRED_DEPTH 0x3@@ -946,6 +965,7 @@ extern "C" {#define DRM_IOCTL_SYNCOBJ_QUERY DRM_IOWR(0xCB, struct drm_syncobj_timeline_array)#define DRM_IOCTL_SYNCOBJ_TRANSFER DRM_IOWR(0xCC, struct drm_syncobj_transfer)#define DRM_IOCTL_SYNCOBJ_TIMELINE_SIGNAL DRM_IOWR(0xCD, struct drm_syncobj_timeline_array) +#define DRM_IOCTL_GEM_SET_LABEL DRM_IOWR(0xCE, struct drm_gem_set_label_object)/** * Device specific ioctls should only be in their respective headers
Signature · 9 lines
Thomas Zimmermann Graphics Driver Developer SUSE Linux GmbH, Maxfeldstrasse 5, 90409 Nuernberg, Germany GF: Felix Imendörffer, Mary Higgins, Sri Rasiah HRB 21284 (AG Nürnberg) _______________________________________________ dri-devel mailing list [email protected] https://lists.freedesktop.org/mailman/listinfo/dri-devel