libkmod: document KMOD_INDEX_MODULES_BUILTIN_ALIAS in kmod_dump_index()

The extra enum was introduced a few years ago, although the (only)
function using it did not have it's documentation updated.

The commit itself has caused an ABI break with kmod v27, since the
KMOD_INDEX_MODULES_BUILTIN value has changed.

A search through Google, Github and Arch packages have shown one user of
kmod_dump_index() - the only API that uses the enum.

In that case and all others, no projects referencing the changed enum
were found. Although since recent and/or supported distros use kmod v27
or later we've decided to only update the documentation.

Cc: Alexey Gladkov <gladkov.alexey@gmail.com>
Fixes: b866b21 ("Lookup aliases in the modules.builtin.modinfo")
Signed-off-by: Emil Velikov <emil.l.velikov@gmail.com>
Reviewed-by: Lucas De Marchi <lucas.demarchi@intel.com>
Link: https://lore.kernel.org/r/20240719-abi-fixes-v1-1-1e6d99a2846b@gmail.com
This commit is contained in:
Emil Velikov 2024-07-19 17:12:41 +01:00 committed by Lucas De Marchi
parent 29cc8c2e70
commit 89596b7518

View File

@ -971,6 +971,7 @@ KMOD_EXPORT void kmod_unload_resources(struct kmod_ctx *ctx)
* KMOD_INDEX_MODULES_DEP: index of module dependencies;
* KMOD_INDEX_MODULES_ALIAS: index of module aliases;
* KMOD_INDEX_MODULES_SYMBOL: index of symbol aliases;
* KMOD_INDEX_MODULES_BUILTIN_ALIAS: index of builtin module aliases.
* KMOD_INDEX_MODULES_BUILTIN: index of builtin module.
* @fd: file descriptor to dump index to
*