summaryrefslogtreecommitdiffstats
path: root/include/linux/dma-fence-chain.h
diff options
context:
space:
mode:
authorSuren Baghdasaryan <surenb@google.com>2024-07-03 10:42:25 -0700
committerAndrew Morton <akpm@linux-foundation.org>2024-07-12 15:52:20 -0700
commit3b0ba54d5f8ff60553c01d3ec3c607ab7bb3b452 (patch)
treecf59b04a3a4b987e4305704fc234eb45f47384df /include/linux/dma-fence-chain.h
parentcd1e0dac3a3e57d86085eea95ab0cf3172950156 (diff)
downloadlinux-3b0ba54d5f8ff60553c01d3ec3c607ab7bb3b452.tar.gz
linux-3b0ba54d5f8ff60553c01d3ec3c607ab7bb3b452.tar.bz2
linux-3b0ba54d5f8ff60553c01d3ec3c607ab7bb3b452.zip
mm: add comments for allocation helpers explaining why they are macros
A number of allocation helper functions were converted into macros to account them at the call sites. Add a comment for each converted allocation helper explaining why it has to be a macro and why we typecast the return value wherever required. The patch also moves acpi_os_acquire_object() closer to other allocation helpers to group them together under the same comment. The patch has no functional changes. Link: https://lkml.kernel.org/r/20240703174225.3891393-1-surenb@google.com Fixes: 2c321f3f70bc ("mm: change inlined allocation helpers to account at the call site") Signed-off-by: Suren Baghdasaryan <surenb@google.com> Suggested-by: Andrew Morton <akpm@linux-foundation.org> Cc: Christian König <christian.koenig@amd.com> Cc: Christoph Hellwig <hch@lst.de> Cc: Jan Kara <jack@suse.cz> Cc: Kent Overstreet <kent.overstreet@linux.dev> Cc: Thorsten Blum <thorsten.blum@toblux.com> Signed-off-by: Andrew Morton <akpm@linux-foundation.org>
Diffstat (limited to 'include/linux/dma-fence-chain.h')
-rw-r--r--include/linux/dma-fence-chain.h4
1 files changed, 4 insertions, 0 deletions
diff --git a/include/linux/dma-fence-chain.h b/include/linux/dma-fence-chain.h
index ad9e2506c2f4..68c3c1e41014 100644
--- a/include/linux/dma-fence-chain.h
+++ b/include/linux/dma-fence-chain.h
@@ -85,6 +85,10 @@ dma_fence_chain_contained(struct dma_fence *fence)
* dma_fence_chain_alloc
*
* Returns a new struct dma_fence_chain object or NULL on failure.
+ *
+ * This specialized allocator has to be a macro for its allocations to be
+ * accounted separately (to have a separate alloc_tag). The typecast is
+ * intentional to enforce typesafety.
*/
#define dma_fence_chain_alloc() \
((struct dma_fence_chain *)kmalloc(sizeof(struct dma_fence_chain), GFP_KERNEL))