aboutsummaryrefslogtreecommitdiffstats
path: root/common/recipes-kernel/linux/linux-yocto-4.19.8/0371-drm-amdgpu-Style-fixes-to-PRIME-code-documentation.patch
diff options
context:
space:
mode:
Diffstat (limited to 'common/recipes-kernel/linux/linux-yocto-4.19.8/0371-drm-amdgpu-Style-fixes-to-PRIME-code-documentation.patch')
-rw-r--r--common/recipes-kernel/linux/linux-yocto-4.19.8/0371-drm-amdgpu-Style-fixes-to-PRIME-code-documentation.patch170
1 files changed, 170 insertions, 0 deletions
diff --git a/common/recipes-kernel/linux/linux-yocto-4.19.8/0371-drm-amdgpu-Style-fixes-to-PRIME-code-documentation.patch b/common/recipes-kernel/linux/linux-yocto-4.19.8/0371-drm-amdgpu-Style-fixes-to-PRIME-code-documentation.patch
new file mode 100644
index 00000000..5cd37206
--- /dev/null
+++ b/common/recipes-kernel/linux/linux-yocto-4.19.8/0371-drm-amdgpu-Style-fixes-to-PRIME-code-documentation.patch
@@ -0,0 +1,170 @@
+From f47ea383bbc27e42f1654258a1b673609268264d Mon Sep 17 00:00:00 2001
+From: Vijetha Malkai <vijetha.malkai@amd.com>
+Date: Thu, 13 Sep 2018 14:47:39 -0400
+Subject: [PATCH 0371/2940] drm/amdgpu: Style fixes to PRIME code documentation
+MIME-Version: 1.0
+Content-Type: text/plain; charset=UTF-8
+Content-Transfer-Encoding: 8bit
+
+* Use consistent capitalization in the description of function arguments
+* Define and consistently use the BO acronym for buffer objects
+* Some minor wording improvements
+
+Change-Id: I6083b5e56e9e61868c15de1becfe9ad162c85dc1
+Signed-off-by: Vijetha Malkai <vijetha.malkai@amd.com>
+Signed-off-by: Michel Dänzer <michel.daenzer@amd.com>
+Signed-off-by: Kalyan Alle <kalyan.alle@amd.com>
+---
+ drivers/gpu/drm/amd/amdgpu/amdgpu_prime.c | 46 +++++++++++------------
+ 1 file changed, 23 insertions(+), 23 deletions(-)
+
+diff --git a/drivers/gpu/drm/amd/amdgpu/amdgpu_prime.c b/drivers/gpu/drm/amd/amdgpu/amdgpu_prime.c
+index 2686297e34e0..bc406d06b4a3 100644
+--- a/drivers/gpu/drm/amd/amdgpu/amdgpu_prime.c
++++ b/drivers/gpu/drm/amd/amdgpu/amdgpu_prime.c
+@@ -44,10 +44,10 @@ static const struct dma_buf_ops amdgpu_dmabuf_ops;
+ /**
+ * amdgpu_gem_prime_get_sg_table - &drm_driver.gem_prime_get_sg_table
+ * implementation
+- * @obj: GEM buffer object
++ * @obj: GEM buffer object (BO)
+ *
+ * Returns:
+- * A scatter/gather table for the pinned pages of the buffer object's memory.
++ * A scatter/gather table for the pinned pages of the BO's memory.
+ */
+ struct sg_table *amdgpu_gem_prime_get_sg_table(struct drm_gem_object *obj)
+ {
+@@ -59,9 +59,9 @@ struct sg_table *amdgpu_gem_prime_get_sg_table(struct drm_gem_object *obj)
+
+ /**
+ * amdgpu_gem_prime_vmap - &dma_buf_ops.vmap implementation
+- * @obj: GEM buffer object
++ * @obj: GEM BO
+ *
+- * Sets up an in-kernel virtual mapping of the buffer object's memory.
++ * Sets up an in-kernel virtual mapping of the BO's memory.
+ *
+ * Returns:
+ * The virtual address of the mapping or an error pointer.
+@@ -81,10 +81,10 @@ void *amdgpu_gem_prime_vmap(struct drm_gem_object *obj)
+
+ /**
+ * amdgpu_gem_prime_vunmap - &dma_buf_ops.vunmap implementation
+- * @obj: GEM buffer object
+- * @vaddr: virtual address (unused)
++ * @obj: GEM BO
++ * @vaddr: Virtual address (unused)
+ *
+- * Tears down the in-kernel virtual mapping of the buffer object's memory.
++ * Tears down the in-kernel virtual mapping of the BO's memory.
+ */
+ void amdgpu_gem_prime_vunmap(struct drm_gem_object *obj, void *vaddr)
+ {
+@@ -95,14 +95,14 @@ void amdgpu_gem_prime_vunmap(struct drm_gem_object *obj, void *vaddr)
+
+ /**
+ * amdgpu_gem_prime_mmap - &drm_driver.gem_prime_mmap implementation
+- * @obj: GEM buffer object
+- * @vma: virtual memory area
++ * @obj: GEM BO
++ * @vma: Virtual memory area
+ *
+- * Sets up a userspace mapping of the buffer object's memory in the given
++ * Sets up a userspace mapping of the BO's memory in the given
+ * virtual memory area.
+ *
+ * Returns:
+- * 0 on success or negative error code.
++ * 0 on success or a negative error code on failure.
+ */
+ int amdgpu_gem_prime_mmap(struct drm_gem_object *obj, struct vm_area_struct *vma)
+ {
+@@ -145,10 +145,10 @@ int amdgpu_gem_prime_mmap(struct drm_gem_object *obj, struct vm_area_struct *vma
+ * @attach: DMA-buf attachment
+ * @sg: Scatter/gather table
+ *
+- * Import shared DMA buffer memory exported by another device.
++ * Imports shared DMA buffer memory exported by another device.
+ *
+ * Returns:
+- * A new GEM buffer object of the given DRM device, representing the memory
++ * A new GEM BO of the given DRM device, representing the memory
+ * described by the given DMA-buf attachment and scatter/gather table.
+ */
+ struct drm_gem_object *
+@@ -199,7 +199,7 @@ amdgpu_gem_prime_import_sg_table(struct drm_device *dev,
+ * all DMA devices.
+ *
+ * Returns:
+- * 0 on success or negative error code.
++ * 0 on success or a negative error code on failure.
+ */
+ static int amdgpu_gem_map_attach(struct dma_buf *dma_buf,
+ struct dma_buf_attachment *attach)
+@@ -251,11 +251,11 @@ static int amdgpu_gem_map_attach(struct dma_buf *dma_buf,
+
+ /**
+ * amdgpu_gem_map_detach - &dma_buf_ops.detach implementation
+- * @dma_buf: shared DMA buffer
++ * @dma_buf: Shared DMA buffer
+ * @attach: DMA-buf attachment
+ *
+ * This is called when a shared DMA buffer no longer needs to be accessible by
+- * the other device. For now, simply unpins the buffer from GTT.
++ * another device. For now, simply unpins the buffer from GTT.
+ */
+ static void amdgpu_gem_map_detach(struct dma_buf *dma_buf,
+ struct dma_buf_attachment *attach)
+@@ -280,10 +280,10 @@ static void amdgpu_gem_map_detach(struct dma_buf *dma_buf,
+
+ /**
+ * amdgpu_gem_prime_res_obj - &drm_driver.gem_prime_res_obj implementation
+- * @obj: GEM buffer object
++ * @obj: GEM BO
+ *
+ * Returns:
+- * The buffer object's reservation object.
++ * The BO's reservation object.
+ */
+ struct reservation_object *amdgpu_gem_prime_res_obj(struct drm_gem_object *obj)
+ {
+@@ -302,7 +302,7 @@ struct reservation_object *amdgpu_gem_prime_res_obj(struct drm_gem_object *obj)
+ * CPU read performance.
+ *
+ * Returns:
+- * 0 on success or negative error code.
++ * 0 on success or a negative error code on failure.
+ */
+ static int amdgpu_gem_begin_cpu_access(struct dma_buf *dma_buf,
+ enum dma_data_direction direction)
+@@ -349,14 +349,14 @@ static const struct dma_buf_ops amdgpu_dmabuf_ops = {
+ /**
+ * amdgpu_gem_prime_export - &drm_driver.gem_prime_export implementation
+ * @dev: DRM device
+- * @gobj: GEM buffer object
+- * @flags: flags like DRM_CLOEXEC and DRM_RDWR
++ * @gobj: GEM BO
++ * @flags: Flags such as DRM_CLOEXEC and DRM_RDWR.
+ *
+ * The main work is done by the &drm_gem_prime_export helper, which in turn
+ * uses &amdgpu_gem_prime_res_obj.
+ *
+ * Returns:
+- * Shared DMA buffer representing the GEM buffer object from the given device.
++ * Shared DMA buffer representing the GEM BO from the given device.
+ */
+ struct dma_buf *amdgpu_gem_prime_export(struct drm_device *dev,
+ struct drm_gem_object *gobj,
+@@ -387,7 +387,7 @@ struct dma_buf *amdgpu_gem_prime_export(struct drm_device *dev,
+ * uses &amdgpu_gem_prime_import_sg_table.
+ *
+ * Returns:
+- * GEM buffer object representing the shared DMA buffer for the given device.
++ * GEM BO representing the shared DMA buffer for the given device.
+ */
+ struct drm_gem_object *amdgpu_gem_prime_import(struct drm_device *dev,
+ struct dma_buf *dma_buf)
+--
+2.17.1
+