summaryrefslogtreecommitdiff
path: root/include/linux/xarray.h
diff options
context:
space:
mode:
authorMatthew Wilcox (Oracle) <willy@infradead.org>2020-08-06 17:07:24 +0300
committerMatthew Wilcox (Oracle) <willy@infradead.org>2020-10-08 17:07:48 +0300
commit8446466c9dd645da4c1848f35ffd0fc1df3524ee (patch)
treed6d7215581844bb541406159f0a0287a9e55be51 /include/linux/xarray.h
parent04e9e9bb8470bea74eafad1cafd552f3f06c32d9 (diff)
downloadlinux-8446466c9dd645da4c1848f35ffd0fc1df3524ee.tar.xz
XArray: Fix xas_for_each_conflict documentation
At one point, xas_for_each_conflict() was going to work this way, and I forgot to update the documentation when I changed my mind. Signed-off-by: Matthew Wilcox (Oracle) <willy@infradead.org>
Diffstat (limited to 'include/linux/xarray.h')
-rw-r--r--include/linux/xarray.h13
1 files changed, 6 insertions, 7 deletions
diff --git a/include/linux/xarray.h b/include/linux/xarray.h
index b4d70e7568b2..6b336098fca7 100644
--- a/include/linux/xarray.h
+++ b/include/linux/xarray.h
@@ -1714,13 +1714,12 @@ enum {
* @xas: XArray operation state.
* @entry: Entry retrieved from the array.
*
- * The loop body will be executed for each entry in the XArray that lies
- * within the range specified by @xas. If the loop completes successfully,
- * any entries that lie in this range will be replaced by @entry. The caller
- * may break out of the loop; if they do so, the contents of the XArray will
- * be unchanged. The operation may fail due to an out of memory condition.
- * The caller may also call xa_set_err() to exit the loop while setting an
- * error to record the reason.
+ * The loop body will be executed for each entry in the XArray that
+ * lies within the range specified by @xas. If the loop terminates
+ * normally, @entry will be %NULL. The user may break out of the loop,
+ * which will leave @entry set to the conflicting entry. The caller
+ * may also call xa_set_err() to exit the loop while setting an error
+ * to record the reason.
*/
#define xas_for_each_conflict(xas, entry) \
while ((entry = xas_find_conflict(xas)))