The patch titled
Subject: lib/idr.c: document that ida_simple_{get,remove}() are deprecated
has been added to the -mm tree. Its filename is
idr-document-that-ida_simple_getremove-are-deprecated.patch
This patch should soon appear at
https://ozlabs.org/~akpm/mmots/broken-out/idr-document-that-ida_simple_getremove-are-deprecated.patch
and later at
https://ozlabs.org/~akpm/mmotm/broken-out/idr-document-that-ida_simple_getremove-are-deprecated.patch
Before you just go and hit "reply", please:
a) Consider who else should be cc'ed
b) Prefer to cc a suitable mailing list as well
c) Ideally: find the original patch on the mailing list and do a
reply-to-all to that, adding suitable additional cc's
*** Remember to use Documentation/process/submit-checklist.rst when testing your code ***
The -mm tree is included into linux-next and is updated
there every 3-4 working days
------------------------------------------------------
From: Stephen Boyd <swboyd@xxxxxxxxxxxx>
Subject: lib/idr.c: document that ida_simple_{get,remove}() are deprecated
These two functions are deprecated. Users should call ida_alloc() or
ida_free() respectively instead. Add documentation to this effect until
the macro can be removed.
Link: https://lkml.kernel.org/r/20200910055246.2297797-2-swboyd@xxxxxxxxxxxx
Signed-off-by: Stephen Boyd <swboyd@xxxxxxxxxxxx>
Reviewed-by: Tri Vo <trong@xxxxxxxxxxx>
Cc: Greg KH <gregkh@xxxxxxxxxxxxxxxxxxx>
Cc: Jonathan Corbet <corbet@xxxxxxx>
Cc: Matthew Wilcox <willy@xxxxxxxxxxxxx>
Signed-off-by: Andrew Morton <akpm@xxxxxxxxxxxxxxxxxxxx>
---
include/linux/idr.h | 4 ++++
1 file changed, 4 insertions(+)
--- a/include/linux/idr.h~idr-document-that-ida_simple_getremove-are-deprecated
+++ a/include/linux/idr.h
@@ -314,6 +314,10 @@ static inline void ida_init(struct ida *
xa_init_flags(&ida->xa, IDA_INIT_FLAGS);
}
+/*
+ * ida_simple_get() and ida_simple_remove() are deprecated. Use
+ * ida_alloc() and ida_free() instead respectively.
+ */
#define ida_simple_get(ida, start, end, gfp) \
ida_alloc_range(ida, start, (end) - 1, gfp)
#define ida_simple_remove(ida, id) ida_free(ida, id)
_
Patches currently in -mm which might be from swboyd@xxxxxxxxxxxx are
idr-document-calling-context-for-ida-apis-mustnt-use-locks.patch
idr-document-that-ida_simple_getremove-are-deprecated.patch
