diff options
| author | Karl Mehltretter <kmehltretter@gmail.com> | 2026-09-05 03:55:09 +0200 |
|---|---|---|
| committer | Jonathan Corbet <corbet@lwn.net> | 2026-09-07 10:35:07 -0600 |
| commit | 12af11ca76c52152defb49b3da5a6971167ecc26 (patch) | |
| tree | 910eda83fe042c51c029186c9c63b9c70894be4d | |
| parent | b31821013b2331fae246fd6e0530174785b7bca3 (diff) | |
| download | linux-next-12af11ca76c52152defb49b3da5a6971167ecc26.tar.gz linux-next-12af11ca76c52152defb49b3da5a6971167ecc26.zip | |
docs: maple_tree: Replace removed bulk insertion API
Commit e3852a1213ff ("maple_tree: Drop bulk insert support") removed
mas_expected_entries() but left the documentation describing it.
Document the current preallocation interface instead.
Fixes: e3852a1213ff ("maple_tree: Drop bulk insert support")
Assisted-by: LLM
Signed-off-by: Karl Mehltretter <kmehltretter@gmail.com>
Acked-by: Nick Huang [sef1548@gmail.com](mailto:sef1548@gmail.com)
Signed-off-by: Jonathan Corbet <corbet@lwn.net>
Message-ID: <20260905015509.76265-1-kmehltretter@gmail.com>
| -rw-r--r-- | Documentation/core-api/maple_tree.rst | 9 |
1 files changed, 4 insertions, 5 deletions
diff --git a/Documentation/core-api/maple_tree.rst b/Documentation/core-api/maple_tree.rst index 12bccfb6aac1..836342fb1eec 100644 --- a/Documentation/core-api/maple_tree.rst +++ b/Documentation/core-api/maple_tree.rst @@ -214,11 +214,10 @@ Advanced Allocating Nodes ------------------------- Allocations are usually handled internally to the tree, however if allocations -need to occur before a write occurs then calling mas_expected_entries() will -allocate the worst-case number of needed nodes to insert the provided number of -ranges. This also causes the tree to enter mass insertion mode. Once -insertions are complete calling mas_destroy() on the maple state will free the -unused allocations. +need to occur before a write occurs then calling mas_preallocate() will +allocate the nodes needed to store the provided entry. The entry is then +stored with mas_store_prealloc(). If the store is abandoned, calling +mas_destroy() on the maple state will free the unused allocations. .. _maple-tree-advanced-locks: |