History

bpf: Add comment about helper freeze

Put a comment after the bpf helper list in uapi bpf.h to prevent people from trying to add new helpers there and direct them to kfuncs.

Levi Zim committed 1 year ago

Commit 0abff461 parent 94f53ed1 file · +4 −1Browse files

Showing the changes to include/uapi (1 of 1 file). Show all

Unified · Split

include/uapi/linux/bpf.h+4−1
@@ -6019,7 +6019,10 @@ union bpf_attr { · 6018 unmodified lines
60196019 FN(user_ringbuf_drain, 209, ##ctx) \
60206020 FN(cgrp_storage_get, 210, ##ctx) \
60216021 FN(cgrp_storage_delete, 211, ##ctx) \
6022− /* */
6022+ /* This helper list is effectively frozen. If you are trying to \
6023+ * add a new helper, you should add a kfunc instead which has \
6024+ * less stability guarantees. See Documentation/bpf/kfuncs.rst \
6025+ */
60236026
60246027 /* backwards-compatibility macros for users of __BPF_FUNC_MAPPER that don't
60256028 * know or care about integer value that is now passed as second argument