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