net: document inet[6]_lookup_reuseport sk_state requirements
The current implementation was extracted from inet[6]_lhash2_lookup in commit80b373f74f
("inet: Extract helper for selecting socket from reuseport group") and commit5df6531292
("inet6: Extract helper for selecting socket from reuseport group"). In the original context, sk is always in TCP_LISTEN state and so did not have a separate check. Add documentation that specifies which sk_state are valid to pass to the function. Reviewed-by: Kuniyuki Iwashima <kuniyu@amazon.com> Signed-off-by: Lorenz Bauer <lmb@isovalent.com> Link: https://lore.kernel.org/r/20230720-so-reuseport-v6-5-7021b683cdae@isovalent.com Signed-off-by: Martin KaFai Lau <martin.lau@kernel.org>
This commit is contained in:
parent
0f495f7617
commit
2a61776366
|
@ -335,6 +335,21 @@ static inline int compute_score(struct sock *sk, struct net *net,
|
|||
|
||||
INDIRECT_CALLABLE_DECLARE(inet_ehashfn_t udp_ehashfn);
|
||||
|
||||
/**
|
||||
* inet_lookup_reuseport() - execute reuseport logic on AF_INET socket if necessary.
|
||||
* @net: network namespace.
|
||||
* @sk: AF_INET socket, must be in TCP_LISTEN state for TCP or TCP_CLOSE for UDP.
|
||||
* @skb: context for a potential SK_REUSEPORT program.
|
||||
* @doff: header offset.
|
||||
* @saddr: source address.
|
||||
* @sport: source port.
|
||||
* @daddr: destination address.
|
||||
* @hnum: destination port in host byte order.
|
||||
* @ehashfn: hash function used to generate the fallback hash.
|
||||
*
|
||||
* Return: NULL if sk doesn't have SO_REUSEPORT set, otherwise a pointer to
|
||||
* the selected sock or an error.
|
||||
*/
|
||||
struct sock *inet_lookup_reuseport(struct net *net, struct sock *sk,
|
||||
struct sk_buff *skb, int doff,
|
||||
__be32 saddr, __be16 sport,
|
||||
|
|
|
@ -114,6 +114,21 @@ static inline int compute_score(struct sock *sk, struct net *net,
|
|||
|
||||
INDIRECT_CALLABLE_DECLARE(inet6_ehashfn_t udp6_ehashfn);
|
||||
|
||||
/**
|
||||
* inet6_lookup_reuseport() - execute reuseport logic on AF_INET6 socket if necessary.
|
||||
* @net: network namespace.
|
||||
* @sk: AF_INET6 socket, must be in TCP_LISTEN state for TCP or TCP_CLOSE for UDP.
|
||||
* @skb: context for a potential SK_REUSEPORT program.
|
||||
* @doff: header offset.
|
||||
* @saddr: source address.
|
||||
* @sport: source port.
|
||||
* @daddr: destination address.
|
||||
* @hnum: destination port in host byte order.
|
||||
* @ehashfn: hash function used to generate the fallback hash.
|
||||
*
|
||||
* Return: NULL if sk doesn't have SO_REUSEPORT set, otherwise a pointer to
|
||||
* the selected sock or an error.
|
||||
*/
|
||||
struct sock *inet6_lookup_reuseport(struct net *net, struct sock *sk,
|
||||
struct sk_buff *skb, int doff,
|
||||
const struct in6_addr *saddr,
|
||||
|
|
Loading…
Reference in New Issue