aboutsummaryrefslogtreecommitdiffstats
path: root/common/recipes-kernel/linux/linux-yocto-4.14.71/5417-drm-amdgpu-Style-fixes-to-PRIME-code-documentation.patch
diff options
context:
space:
mode:
Diffstat (limited to 'common/recipes-kernel/linux/linux-yocto-4.14.71/5417-drm-amdgpu-Style-fixes-to-PRIME-code-documentation.patch')
-rw-r--r--common/recipes-kernel/linux/linux-yocto-4.14.71/5417-drm-amdgpu-Style-fixes-to-PRIME-code-documentation.patch189
1 files changed, 189 insertions, 0 deletions
diff --git a/common/recipes-kernel/linux/linux-yocto-4.14.71/5417-drm-amdgpu-Style-fixes-to-PRIME-code-documentation.patch b/common/recipes-kernel/linux/linux-yocto-4.14.71/5417-drm-amdgpu-Style-fixes-to-PRIME-code-documentation.patch
new file mode 100644
index 00000000..e1b4a63d
--- /dev/null
+++ b/common/recipes-kernel/linux/linux-yocto-4.14.71/5417-drm-amdgpu-Style-fixes-to-PRIME-code-documentation.patch
@@ -0,0 +1,189 @@
+From 4e963b77c4568c5bf6222c24178112467dae6813 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 5417/5725] 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: Raveendra Talabattula <raveendra.talabattula@amd.com>
+---
+ drivers/gpu/drm/amd/amdgpu/amdgpu_prime.c | 52 +++++++++++++++----------------
+ 1 file changed, 26 insertions(+), 26 deletions(-)
+
+diff --git a/drivers/gpu/drm/amd/amdgpu/amdgpu_prime.c b/drivers/gpu/drm/amd/amdgpu/amdgpu_prime.c
+index 8c93c9e..2a34639 100644
+--- a/drivers/gpu/drm/amd/amdgpu/amdgpu_prime.c
++++ b/drivers/gpu/drm/amd/amdgpu/amdgpu_prime.c
+@@ -42,10 +42,10 @@
+ /**
+ * 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)
+ {
+@@ -57,9 +57,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.
+@@ -79,10 +79,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)
+ {
+@@ -93,14 +93,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)
+ {
+@@ -143,10 +143,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 *
+@@ -191,7 +191,7 @@ amdgpu_gem_prime_import_sg_table(struct drm_device *dev,
+ #if LINUX_VERSION_CODE >= KERNEL_VERSION(4, 17, 0) || !defined(BUILD_AS_DKMS)
+ /**
+ * amdgpu_gem_map_attach - &dma_buf_ops.attach implementation
+- * @dma_buf: shared DMA buffer
++ * @dma_buf: Shared DMA buffer
+ * @attach: DMA-buf attachment
+ *
+ * Makes sure that the shared DMA buffer can be accessed by the target device.
+@@ -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 negative error code on failure.
+ */
+ static int amdgpu_gem_map_attach(struct dma_buf *dma_buf,
+ struct device *target_dev,
+@@ -252,11 +252,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)
+@@ -281,10 +281,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)
+ {
+@@ -296,15 +296,15 @@ struct reservation_object *amdgpu_gem_prime_res_obj(struct drm_gem_object *obj)
+ #if LINUX_VERSION_CODE >= KERNEL_VERSION(4, 17, 0) || !defined(BUILD_AS_DKMS)
+ /**
+ * amdgpu_gem_begin_cpu_access - &dma_buf_ops.begin_cpu_access implementation
+- * @dma_buf: shared DMA buffer
+- * @direction: direction of DMA transfer
++ * @dma_buf: Shared DMA buffer
++ * @direction: Direction of DMA transfer
+ *
+ * This is called before CPU access to the shared DMA buffer's memory. If it's
+ * a read access, the buffer is moved to the GTT domain if possible, for optimal
+ * CPU read performance.
+ *
+ * Returns:
+- * 0 on success or negative error code.
++ * 0 on success or negative error code on failure.
+ */
+ static int amdgpu_gem_begin_cpu_access(struct dma_buf *dma_buf,
+ enum dma_data_direction direction)
+@@ -354,14 +354,14 @@ 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,
+@@ -394,7 +394,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.7.4
+