Skip to contentSkip to conversation

driver core: Add __alloc_size hint to devm allocators

PATCH Superseded Kees Cook 2 participants 4 messages Oct 18, 2022 Driver core

v1 of 2 Superseded Latest is v2 →

lore
Share & tools
lore

Kees Cook

author
#0 lore raw

PATCH 1/1 driver core: Add __alloc_size hint to devm allocators

Mark the devm_*alloc()-family of allocations with appropriate __alloc_size() hints so the compiler can attempt to reason about buffer lengths from allocations.

Cc Greg Kroah-Hartman <[email protected]>
Cc Thomas Gleixner <[email protected]>
Cc Jason Gunthorpe <[email protected]>
Cc Nishanth Menon <[email protected]>
Cc Michael Kelley <[email protected]>
Cc Dan Williams <[email protected]>
Cc Won Chung <[email protected]>
---
 include/linux/device.h | 7 ++++---
 1 file changed, 4 insertions(+), 3 deletions(-)
include/linux/device.h +4 -3
index 424b55df0272..a1cbbab9a57a 100644
@@ -197,9 +197,9 @@ void devres_remove_group(struct device *dev, void *id);
 int devres_release_group(struct device *dev, void *id);
 
 /* managed devm_k.alloc/kfree for device drivers */
-void *devm_kmalloc(struct device *dev, size_t size, gfp_t gfp) __malloc;
+void *devm_kmalloc(struct device *dev, size_t size, gfp_t gfp) __alloc_size(2);
 void *devm_krealloc(struct device *dev, void *ptr, size_t size,
-		    gfp_t gfp) __must_check;
+		    gfp_t gfp) __must_check __realloc_size(3);
 __printf(3, 0) char *devm_kvasprintf(struct device *dev, gfp_t gfp,
 				     const char *fmt, va_list ap) __malloc;
 __printf(3, 4) char *devm_kasprintf(struct device *dev, gfp_t gfp,
@@ -226,7 +226,8 @@ static inline void *devm_kcalloc(struct device *dev,
 void devm_kfree(struct device *dev, const void *p);
 char *devm_kstrdup(struct device *dev, const char *s, gfp_t gfp) __malloc;
 const char *devm_kstrdup_const(struct device *dev, const char *s, gfp_t gfp);
-void *devm_kmemdup(struct device *dev, const void *src, size_t len, gfp_t gfp);
+void *devm_kmemdup(struct device *dev, const void *src, size_t len, gfp_t gfp)
+	__alloc_size(3);
 
 unsigned long devm_get_free_pages(struct device *dev,
 				  gfp_t gfp_mask, unsigned int order);
Signature · 1 line
2.34.1
#1 lore raw

include/linux/device.h static inline void *devm_kcalloc(struct device *dev, · line 230

Quoted 12 lines · Kees Cook

Mark the devm_*alloc()-family of allocations with appropriate __alloc_size() hints so the compiler can attempt to reason about buffer lengths from allocations.

include/linux/device.h +2 -1
@@ -226,7 +226,8 @@ static inline void *devm_kcalloc(struct device *dev,
 void devm_kfree(struct device *dev, const void *p);
 char *devm_kstrdup(struct device *dev, const char *s, gfp_t gfp) __malloc;
 const char *devm_kstrdup_const(struct device *dev, const char *s, gfp_t gfp);
-void *devm_kmemdup(struct device *dev, const void *src, size_t len, gfp_t gfp);
+void *devm_kmemdup(struct device *dev, const void *src, size_t len, gfp_t gfp)
+	__alloc_size(3);

I think it's wrong to apply the __malloc attribute to kmemdup() and variants.

'malloc'
This tells the compiler that a function is 'malloc'-like, i.e., that the pointer P returned by the function cannot alias any other pointer valid when the function returns, and moreover no pointers to valid objects occur in any storage addressed by P.

See also commit d64e85d3e1c5, introducing __malloc in the first place. Maybe worth lifting some of that to a comment somewhere.

Rasmus

author
#2 lore raw
Quoted 17 lines · Rasmus Villemoes

include/linux/device.h static inline void *devm_kcalloc(struct device *dev, · line 230

Quoted 12 lines · Kees Cook

Mark the devm_*alloc()-family of allocations with appropriate __alloc_size() hints so the compiler can attempt to reason about buffer lengths from allocations.

include/linux/device.h +2 -1
@@ -226,7 +226,8 @@ static inline void *devm_kcalloc(struct device *dev,
 void devm_kfree(struct device *dev, const void *p);
 char *devm_kstrdup(struct device *dev, const char *s, gfp_t gfp) __malloc;
 const char *devm_kstrdup_const(struct device *dev, const char *s, gfp_t gfp);
-void *devm_kmemdup(struct device *dev, const void *src, size_t len, gfp_t gfp);
+void *devm_kmemdup(struct device *dev, const void *src, size_t len, gfp_t gfp)
+	__alloc_size(3);

I think it's wrong to apply the __malloc attribute to kmemdup() and variants.

Quoted 5 lines

'malloc'
This tells the compiler that a function is 'malloc'-like, i.e., that the pointer P returned by the function cannot alias any other pointer valid when the function returns, and moreover no pointers to valid objects occur in any storage addressed by P.

Oh, ew, it defines rules about _contents_ as well. Thank you for pointing that out!

I suppose we can use __realloc_size for these cases then?

Signature · 1 line
Kees Cook
#3 lore raw
Quoted 24 lines · Kees Cook
Quoted 17 lines · Rasmus Villemoes

include/linux/device.h static inline void *devm_kcalloc(struct device *dev, · line 230

Quoted 12 lines · Kees Cook

Mark the devm_*alloc()-family of allocations with appropriate __alloc_size() hints so the compiler can attempt to reason about buffer lengths from allocations.

include/linux/device.h +2 -1
@@ -226,7 +226,8 @@ static inline void *devm_kcalloc(struct device *dev,
 void devm_kfree(struct device *dev, const void *p);
 char *devm_kstrdup(struct device *dev, const char *s, gfp_t gfp) __malloc;
 const char *devm_kstrdup_const(struct device *dev, const char *s, gfp_t gfp);
-void *devm_kmemdup(struct device *dev, const void *src, size_t len, gfp_t gfp);
+void *devm_kmemdup(struct device *dev, const void *src, size_t len, gfp_t gfp)
+	__alloc_size(3);

I think it's wrong to apply the __malloc attribute to kmemdup() and variants.

Quoted 5 lines

'malloc'
This tells the compiler that a function is 'malloc'-like, i.e., that the pointer P returned by the function cannot alias any other pointer valid when the function returns, and moreover no pointers to valid objects occur in any storage addressed by P.

Quoted 4 lines

Oh, ew, it defines rules about _contents_ as well. Thank you for pointing that out!

I suppose we can use __realloc_size for these cases then?

Probably, but it's gonna be mighty confusing for people reading the code.

I was never really a fan of including __malloc in __alloc_size in the first place, this is the kind of confusion that comes from having one attribute include another without having the developer forced to think about whether both actually apply in a given situation.

And that malloc documentation (both the old and the fixed) even came up in what I assume is the thread that led up to that

Since anything marked with __alloc_size would also qualify for marking with __malloc, just include __malloc along with it to avoid redundant markings. (Suggested by Linus Torvalds.)

in commit 86cffecd, namely
https://lore.kernel.org/mm-commits/202109101138.53FCADF5C@keescook/ .

Rasmus