1 // SPDX-License-Identifier: GPL-2.0-only
3 * INET An implementation of the TCP/IP protocol suite for the LINUX
4 * operating system. INET is implemented using the BSD Socket
5 * interface as the means of communication with the user level.
7 * Generic TIME_WAIT sockets functions
9 * From code orinally in TCP
12 #include <linux/kernel.h>
13 #include <linux/slab.h>
14 #include <linux/module.h>
15 #include <net/inet_hashtables.h>
16 #include <net/inet_timewait_sock.h>
21 * inet_twsk_bind_unhash - unhash a timewait socket from bind hash
22 * @tw: timewait socket
23 * @hashinfo: hashinfo pointer
25 * unhash a timewait socket from bind hash, if hashed.
26 * bind hash lock must be held by caller.
27 * Returns 1 if caller should call inet_twsk_put() after lock release.
29 void inet_twsk_bind_unhash(struct inet_timewait_sock
*tw
,
30 struct inet_hashinfo
*hashinfo
)
32 struct inet_bind2_bucket
*tb2
= tw
->tw_tb2
;
33 struct inet_bind_bucket
*tb
= tw
->tw_tb
;
38 __sk_del_bind_node((struct sock
*)tw
);
41 inet_bind2_bucket_destroy(hashinfo
->bind2_bucket_cachep
, tb2
);
42 inet_bind_bucket_destroy(hashinfo
->bind_bucket_cachep
, tb
);
44 __sock_put((struct sock
*)tw
);
47 /* Must be called with locally disabled BHs. */
48 static void inet_twsk_kill(struct inet_timewait_sock
*tw
)
50 struct inet_hashinfo
*hashinfo
= tw
->tw_dr
->hashinfo
;
51 spinlock_t
*lock
= inet_ehash_lockp(hashinfo
, tw
->tw_hash
);
52 struct inet_bind_hashbucket
*bhead
, *bhead2
;
55 sk_nulls_del_node_init_rcu((struct sock
*)tw
);
58 /* Disassociate with bind bucket. */
59 bhead
= &hashinfo
->bhash
[inet_bhashfn(twsk_net(tw
), tw
->tw_num
,
60 hashinfo
->bhash_size
)];
61 bhead2
= inet_bhashfn_portaddr(hashinfo
, (struct sock
*)tw
,
62 twsk_net(tw
), tw
->tw_num
);
64 spin_lock(&bhead
->lock
);
65 spin_lock(&bhead2
->lock
);
66 inet_twsk_bind_unhash(tw
, hashinfo
);
67 spin_unlock(&bhead2
->lock
);
68 spin_unlock(&bhead
->lock
);
70 refcount_dec(&tw
->tw_dr
->tw_refcount
);
74 void inet_twsk_free(struct inet_timewait_sock
*tw
)
76 struct module
*owner
= tw
->tw_prot
->owner
;
77 twsk_destructor((struct sock
*)tw
);
78 kmem_cache_free(tw
->tw_prot
->twsk_prot
->twsk_slab
, tw
);
82 void inet_twsk_put(struct inet_timewait_sock
*tw
)
84 if (refcount_dec_and_test(&tw
->tw_refcnt
))
87 EXPORT_SYMBOL_GPL(inet_twsk_put
);
89 static void inet_twsk_add_node_rcu(struct inet_timewait_sock
*tw
,
90 struct hlist_nulls_head
*list
)
92 hlist_nulls_add_head_rcu(&tw
->tw_node
, list
);
95 static void inet_twsk_schedule(struct inet_timewait_sock
*tw
, int timeo
)
97 __inet_twsk_schedule(tw
, timeo
, false);
101 * Enter the time wait state.
102 * Essentially we whip up a timewait bucket, copy the relevant info into it
103 * from the SK, and mess with hash chains and list linkage.
105 * The caller must not access @tw anymore after this function returns.
107 void inet_twsk_hashdance_schedule(struct inet_timewait_sock
*tw
,
109 struct inet_hashinfo
*hashinfo
,
112 const struct inet_sock
*inet
= inet_sk(sk
);
113 const struct inet_connection_sock
*icsk
= inet_csk(sk
);
114 struct inet_ehash_bucket
*ehead
= inet_ehash_bucket(hashinfo
, sk
->sk_hash
);
115 spinlock_t
*lock
= inet_ehash_lockp(hashinfo
, sk
->sk_hash
);
116 struct inet_bind_hashbucket
*bhead
, *bhead2
;
118 /* Step 1: Put TW into bind hash. Original socket stays there too.
119 Note, that any socket with inet->num != 0 MUST be bound in
120 binding cache, even if it is closed.
122 bhead
= &hashinfo
->bhash
[inet_bhashfn(twsk_net(tw
), inet
->inet_num
,
123 hashinfo
->bhash_size
)];
124 bhead2
= inet_bhashfn_portaddr(hashinfo
, sk
, twsk_net(tw
), inet
->inet_num
);
127 spin_lock(&bhead
->lock
);
128 spin_lock(&bhead2
->lock
);
130 tw
->tw_tb
= icsk
->icsk_bind_hash
;
131 WARN_ON(!icsk
->icsk_bind_hash
);
133 tw
->tw_tb2
= icsk
->icsk_bind2_hash
;
134 WARN_ON(!icsk
->icsk_bind2_hash
);
135 sk_add_bind_node((struct sock
*)tw
, &tw
->tw_tb2
->owners
);
137 spin_unlock(&bhead2
->lock
);
138 spin_unlock(&bhead
->lock
);
142 /* Step 2: Hash TW into tcp ehash chain */
143 inet_twsk_add_node_rcu(tw
, &ehead
->chain
);
145 /* Step 3: Remove SK from hash chain */
146 if (__sk_nulls_del_node_init_rcu(sk
))
147 sock_prot_inuse_add(sock_net(sk
), sk
->sk_prot
, -1);
150 /* Ensure above writes are committed into memory before updating the
152 * Provides ordering vs later refcount_inc().
155 /* tw_refcnt is set to 3 because we have :
156 * - one reference for bhash chain.
157 * - one reference for ehash chain.
158 * - one reference for timer.
159 * Also note that after this point, we lost our implicit reference
160 * so we are not allowed to use tw anymore.
162 refcount_set(&tw
->tw_refcnt
, 3);
164 inet_twsk_schedule(tw
, timeo
);
169 EXPORT_SYMBOL_GPL(inet_twsk_hashdance_schedule
);
171 static void tw_timer_handler(struct timer_list
*t
)
173 struct inet_timewait_sock
*tw
= from_timer(tw
, t
, tw_timer
);
178 struct inet_timewait_sock
*inet_twsk_alloc(const struct sock
*sk
,
179 struct inet_timewait_death_row
*dr
,
182 struct inet_timewait_sock
*tw
;
184 if (refcount_read(&dr
->tw_refcount
) - 1 >=
185 READ_ONCE(dr
->sysctl_max_tw_buckets
))
188 tw
= kmem_cache_alloc(sk
->sk_prot_creator
->twsk_prot
->twsk_slab
,
191 const struct inet_sock
*inet
= inet_sk(sk
);
194 /* Give us an identity. */
195 tw
->tw_daddr
= inet
->inet_daddr
;
196 tw
->tw_rcv_saddr
= inet
->inet_rcv_saddr
;
197 tw
->tw_bound_dev_if
= sk
->sk_bound_dev_if
;
198 tw
->tw_tos
= inet
->tos
;
199 tw
->tw_num
= inet
->inet_num
;
200 tw
->tw_state
= TCP_TIME_WAIT
;
201 tw
->tw_substate
= state
;
202 tw
->tw_sport
= inet
->inet_sport
;
203 tw
->tw_dport
= inet
->inet_dport
;
204 tw
->tw_family
= sk
->sk_family
;
205 tw
->tw_reuse
= sk
->sk_reuse
;
206 tw
->tw_reuseport
= sk
->sk_reuseport
;
207 tw
->tw_hash
= sk
->sk_hash
;
209 tw
->tw_transparent
= inet_test_bit(TRANSPARENT
, sk
);
210 tw
->tw_prot
= sk
->sk_prot_creator
;
211 atomic64_set(&tw
->tw_cookie
, atomic64_read(&sk
->sk_cookie
));
212 twsk_net_set(tw
, sock_net(sk
));
213 timer_setup(&tw
->tw_timer
, tw_timer_handler
, 0);
215 * Because we use RCU lookups, we should not set tw_refcnt
216 * to a non null value before everything is setup for this
219 refcount_set(&tw
->tw_refcnt
, 0);
221 __module_get(tw
->tw_prot
->owner
);
226 EXPORT_SYMBOL_GPL(inet_twsk_alloc
);
228 /* These are always called from BH context. See callers in
229 * tcp_input.c to verify this.
232 /* This is for handling early-kills of TIME_WAIT sockets.
233 * Warning : consume reference.
234 * Caller should not access tw anymore.
236 void inet_twsk_deschedule_put(struct inet_timewait_sock
*tw
)
238 struct inet_hashinfo
*hashinfo
= tw
->tw_dr
->hashinfo
;
239 spinlock_t
*lock
= inet_ehash_lockp(hashinfo
, tw
->tw_hash
);
241 /* inet_twsk_purge() walks over all sockets, including tw ones,
242 * and removes them via inet_twsk_deschedule_put() after a
243 * refcount_inc_not_zero().
245 * inet_twsk_hashdance_schedule() must (re)init the refcount before
246 * arming the timer, i.e. inet_twsk_purge can obtain a reference to
247 * a twsk that did not yet schedule the timer.
249 * The ehash lock synchronizes these two:
250 * After acquiring the lock, the timer is always scheduled (else
251 * timer_shutdown returns false), because hashdance_schedule releases
252 * the ehash lock only after completing the timer initialization.
254 * Without grabbing the ehash lock, we get:
255 * 1) cpu x sets twsk refcount to 3
256 * 2) cpu y bumps refcount to 4
257 * 3) cpu y calls inet_twsk_deschedule_put() and shuts timer down
258 * 4) cpu x tries to start timer, but mod_timer is a noop post-shutdown
259 * -> timer refcount is never decremented.
262 /* Makes sure hashdance_schedule() has completed */
265 if (timer_shutdown_sync(&tw
->tw_timer
))
269 EXPORT_SYMBOL(inet_twsk_deschedule_put
);
271 void __inet_twsk_schedule(struct inet_timewait_sock
*tw
, int timeo
, bool rearm
)
273 /* timeout := RTO * 3.5
275 * 3.5 = 1+2+0.5 to wait for two retransmits.
277 * RATIONALE: if FIN arrived and we entered TIME-WAIT state,
278 * our ACK acking that FIN can be lost. If N subsequent retransmitted
279 * FINs (or previous seqments) are lost (probability of such event
280 * is p^(N+1), where p is probability to lose single packet and
281 * time to detect the loss is about RTO*(2^N - 1) with exponential
282 * backoff). Normal timewait length is calculated so, that we
283 * waited at least for one retransmitted FIN (maximal RTO is 120sec).
284 * [ BTW Linux. following BSD, violates this requirement waiting
285 * only for 60sec, we should wait at least for 240 secs.
286 * Well, 240 consumes too much of resources 8)
288 * This interval is not reduced to catch old duplicate and
289 * responces to our wandering segments living for two MSLs.
290 * However, if we use PAWS to detect
291 * old duplicates, we can reduce the interval to bounds required
292 * by RTO, rather than MSL. So, if peer understands PAWS, we
293 * kill tw bucket after 3.5*RTO (it is important that this number
294 * is greater than TS tick!) and detect old duplicates with help
299 bool kill
= timeo
<= 4*HZ
;
301 __NET_INC_STATS(twsk_net(tw
), kill
? LINUX_MIB_TIMEWAITKILLED
:
302 LINUX_MIB_TIMEWAITED
);
303 BUG_ON(mod_timer(&tw
->tw_timer
, jiffies
+ timeo
));
304 refcount_inc(&tw
->tw_dr
->tw_refcount
);
306 mod_timer_pending(&tw
->tw_timer
, jiffies
+ timeo
);
309 EXPORT_SYMBOL_GPL(__inet_twsk_schedule
);
311 /* Remove all non full sockets (TIME_WAIT and NEW_SYN_RECV) for dead netns */
312 void inet_twsk_purge(struct inet_hashinfo
*hashinfo
)
314 struct inet_ehash_bucket
*head
= &hashinfo
->ehash
[0];
315 unsigned int ehash_mask
= hashinfo
->ehash_mask
;
316 struct hlist_nulls_node
*node
;
320 for (slot
= 0; slot
<= ehash_mask
; slot
++, head
++) {
321 if (hlist_nulls_empty(&head
->chain
))
328 sk_nulls_for_each_rcu(sk
, node
, &head
->chain
) {
329 int state
= inet_sk_state_load(sk
);
331 if ((1 << state
) & ~(TCPF_TIME_WAIT
|
335 if (refcount_read(&sock_net(sk
)->ns
.count
))
338 if (unlikely(!refcount_inc_not_zero(&sk
->sk_refcnt
)))
341 if (refcount_read(&sock_net(sk
)->ns
.count
)) {
348 if (state
== TCP_TIME_WAIT
) {
349 inet_twsk_deschedule_put(inet_twsk(sk
));
351 struct request_sock
*req
= inet_reqsk(sk
);
353 inet_csk_reqsk_queue_drop_and_put(req
->rsk_listener
,
359 /* If the nulls value we got at the end of this lookup is
360 * not the expected one, we must restart lookup.
361 * We probably met an item that was moved to another chain.
363 if (get_nulls_value(node
) != slot
)
368 EXPORT_SYMBOL_GPL(inet_twsk_purge
);