From 857fbd765c65bb7de018f7bf44f565e6125d785e Mon Sep 17 00:00:00 2001 From: Sven Eckelmann Date: Tue, 1 Sep 2026 20:36:15 +0200 Subject: [PATCH] batman-adv: tt: clarify kernel doc for batadv_tt_local_set_pending_event() The function batadv_tt_local_set_pending_event() is no longer setting the BATADV_TT_CLIENT_PENDING because it must be done with the flags_lock held. The kernel-doc must therefore correctly state that the flag must already be set. Reported-by: Sashiko Closes: https://netdev-ai.bots.linux.dev/sashiko/#/patchset/20260831135117.574836-1-sw%40simonwunderlich.de?part=12 Signed-off-by: Sven Eckelmann --- net/batman-adv/translation-table.c | 7 +++---- 1 file changed, 3 insertions(+), 4 deletions(-) diff --git a/net/batman-adv/translation-table.c b/net/batman-adv/translation-table.c index 6c65d195f375..12ea557cb803 100644 --- a/net/batman-adv/translation-table.c +++ b/net/batman-adv/translation-table.c @@ -1422,13 +1422,12 @@ int batadv_tt_local_dump(struct sk_buff *msg, struct netlink_callback *cb) /** * batadv_tt_local_set_pending_event() - trigger events for TT pending removal * @bat_priv: the bat priv with all the mesh interface information - * @tt_local_entry: local TT entry to mark + * @tt_local_entry: local TT entry which was marked as BATADV_TT_CLIENT_PENDING * @flags: TT change flags to announce together with the pending removal * @message: debug message describing the reason for the change * - * Schedule the TT change announcement for the entry. The entry is kept in the - * local table until the next TTVN increment so that a consistency-check - * response can still be answered. + * Schedule the TT change announcement for the entry. The caller must already + * have added BATADV_TT_CLIENT_PENDING to the @tt_local_entry */ static void batadv_tt_local_set_pending_event(struct batadv_priv *bat_priv,