diff options
| author | Philipp Stanner <[email protected]> | 2023-08-21 08:21:29 +0000 |
|---|---|---|
| committer | Matthew Wilcox (Oracle) <[email protected]> | 2023-09-05 23:01:38 +0000 |
| commit | e7716c74e3882405f9eca16faa6cb1bf19995399 (patch) | |
| tree | 13fcc03b9751bd875fb3c67ac1002118a27d1566 /tools/perf/scripts/python/net_dropmonitor.py | |
| parent | XArray: Do not return sibling entries from xa_load() (diff) | |
| download | kernel-e7716c74e3882405f9eca16faa6cb1bf19995399.tar.gz kernel-e7716c74e3882405f9eca16faa6cb1bf19995399.zip | |
xarray: Document necessary flag in alloc functions
Adds a new line to the docstrings of functions wrapping __xa_alloc() and
__xa_alloc_cyclic(), informing about the necessity of flag XA_FLAGS_ALLOC
being set previously.
The documentation so far says that functions wrapping __xa_alloc() and
__xa_alloc_cyclic() are supposed to return either -ENOMEM or -EBUSY in
case of an error. If the xarray has been initialized without the flag
XA_FLAGS_ALLOC, however, they fail with a different, undocumented error
code.
As hinted at in Documentation/core-api/xarray.rst, wrappers around these
functions should only be invoked when the flag has been set. The
functions' documentation should reflect that as well.
Signed-off-by: Philipp Stanner <[email protected]>
Signed-off-by: Matthew Wilcox (Oracle) <[email protected]>
Diffstat (limited to 'tools/perf/scripts/python/net_dropmonitor.py')
0 files changed, 0 insertions, 0 deletions