diff options
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.patch | 170 |
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 + |