2 * Copyright (c) 2007 The University of Aberdeen, Scotland, UK
3 * Copyright (c) 2005-7 The University of Waikato, Hamilton, New Zealand.
4 * Copyright (c) 2005-7 Ian McDonald <ian.mcdonald@jandi.co.nz>
6 * An implementation of the DCCP protocol
8 * This code has been developed by the University of Waikato WAND
9 * research group. For further information please see http://www.wand.net.nz/
11 * This code also uses code from Lulea University, rereleased as GPL by its
13 * Copyright (c) 2003 Nils-Erik Mattsson, Joacim Haggmark, Magnus Erixzon
15 * Changes to meet Linux coding standards, to make it meet latest ccid3 draft
16 * and to make it work as a loadable module in the DCCP stack written by
17 * Arnaldo Carvalho de Melo <acme@conectiva.com.br>.
19 * Copyright (c) 2005 Arnaldo Carvalho de Melo <acme@conectiva.com.br>
21 * This program is free software; you can redistribute it and/or modify
22 * it under the terms of the GNU General Public License as published by
23 * the Free Software Foundation; either version 2 of the License, or
24 * (at your option) any later version.
26 * This program is distributed in the hope that it will be useful,
27 * but WITHOUT ANY WARRANTY; without even the implied warranty of
28 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
29 * GNU General Public License for more details.
31 * You should have received a copy of the GNU General Public License
32 * along with this program; if not, write to the Free Software
33 * Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
38 #include <asm/unaligned.h>
40 #ifdef CONFIG_IP_DCCP_CCID3_DEBUG
41 static int ccid3_debug
;
42 #define ccid3_pr_debug(format, a...) DCCP_PR_DEBUG(ccid3_debug, format, ##a)
44 #define ccid3_pr_debug(format, a...)
48 * Transmitter Half-Connection Routines
50 #ifdef CONFIG_IP_DCCP_CCID3_DEBUG
51 static const char *ccid3_tx_state_name(enum ccid3_hc_tx_states state
)
53 static const char *const ccid3_state_names
[] = {
54 [TFRC_SSTATE_NO_SENT
] = "NO_SENT",
55 [TFRC_SSTATE_NO_FBACK
] = "NO_FBACK",
56 [TFRC_SSTATE_FBACK
] = "FBACK",
57 [TFRC_SSTATE_TERM
] = "TERM",
60 return ccid3_state_names
[state
];
64 static void ccid3_hc_tx_set_state(struct sock
*sk
,
65 enum ccid3_hc_tx_states state
)
67 struct ccid3_hc_tx_sock
*hc
= ccid3_hc_tx_sk(sk
);
68 enum ccid3_hc_tx_states oldstate
= hc
->tx_state
;
70 ccid3_pr_debug("%s(%p) %-8.8s -> %s\n",
71 dccp_role(sk
), sk
, ccid3_tx_state_name(oldstate
),
72 ccid3_tx_state_name(state
));
73 WARN_ON(state
== oldstate
);
78 * Compute the initial sending rate X_init in the manner of RFC 3390:
80 * X_init = min(4 * s, max(2 * s, 4380 bytes)) / RTT
82 * Note that RFC 3390 uses MSS, RFC 4342 refers to RFC 3390, and rfc3448bis
83 * (rev-02) clarifies the use of RFC 3390 with regard to the above formula.
84 * For consistency with other parts of the code, X_init is scaled by 2^6.
86 static inline u64
rfc3390_initial_rate(struct sock
*sk
)
88 const struct ccid3_hc_tx_sock
*hc
= ccid3_hc_tx_sk(sk
);
89 const __u32 w_init
= clamp_t(__u32
, 4380U, 2 * hc
->tx_s
, 4 * hc
->tx_s
);
91 return scaled_div(w_init
<< 6, hc
->tx_rtt
);
95 * Recalculate t_ipi and delta (should be called whenever X changes)
97 static void ccid3_update_send_interval(struct ccid3_hc_tx_sock
*hc
)
99 /* Calculate new t_ipi = s / X_inst (X_inst is in 64 * bytes/second) */
100 hc
->tx_t_ipi
= scaled_div32(((u64
)hc
->tx_s
) << 6, hc
->tx_x
);
102 /* Calculate new delta by delta = min(t_ipi / 2, t_gran / 2) */
103 hc
->tx_delta
= min_t(u32
, hc
->tx_t_ipi
/ 2, TFRC_OPSYS_HALF_TIME_GRAN
);
105 ccid3_pr_debug("t_ipi=%u, delta=%u, s=%u, X=%u\n", hc
->tx_t_ipi
,
106 hc
->tx_delta
, hc
->tx_s
, (unsigned)(hc
->tx_x
>> 6));
109 static u32
ccid3_hc_tx_idle_rtt(struct ccid3_hc_tx_sock
*hc
, ktime_t now
)
111 u32 delta
= ktime_us_delta(now
, hc
->tx_t_last_win_count
);
113 return delta
/ hc
->tx_rtt
;
117 * ccid3_hc_tx_update_x - Update allowed sending rate X
118 * @stamp: most recent time if available - can be left NULL.
119 * This function tracks draft rfc3448bis, check there for latest details.
121 * Note: X and X_recv are both stored in units of 64 * bytes/second, to support
122 * fine-grained resolution of sending rates. This requires scaling by 2^6
123 * throughout the code. Only X_calc is unscaled (in bytes/second).
126 static void ccid3_hc_tx_update_x(struct sock
*sk
, ktime_t
*stamp
)
128 struct ccid3_hc_tx_sock
*hc
= ccid3_hc_tx_sk(sk
);
129 __u64 min_rate
= 2 * hc
->tx_x_recv
;
130 const __u64 old_x
= hc
->tx_x
;
131 ktime_t now
= stamp
? *stamp
: ktime_get_real();
134 * Handle IDLE periods: do not reduce below RFC3390 initial sending rate
135 * when idling [RFC 4342, 5.1]. Definition of idling is from rfc3448bis:
136 * a sender is idle if it has not sent anything over a 2-RTT-period.
137 * For consistency with X and X_recv, min_rate is also scaled by 2^6.
139 if (ccid3_hc_tx_idle_rtt(hc
, now
) >= 2) {
140 min_rate
= rfc3390_initial_rate(sk
);
141 min_rate
= max(min_rate
, 2 * hc
->tx_x_recv
);
146 hc
->tx_x
= min(((__u64
)hc
->tx_x_calc
) << 6, min_rate
);
147 hc
->tx_x
= max(hc
->tx_x
, (((__u64
)hc
->tx_s
) << 6) / TFRC_T_MBI
);
149 } else if (ktime_us_delta(now
, hc
->tx_t_ld
) - (s64
)hc
->tx_rtt
>= 0) {
151 hc
->tx_x
= min(2 * hc
->tx_x
, min_rate
);
152 hc
->tx_x
= max(hc
->tx_x
,
153 scaled_div(((__u64
)hc
->tx_s
) << 6, hc
->tx_rtt
));
157 if (hc
->tx_x
!= old_x
) {
158 ccid3_pr_debug("X_prev=%u, X_now=%u, X_calc=%u, "
159 "X_recv=%u\n", (unsigned)(old_x
>> 6),
160 (unsigned)(hc
->tx_x
>> 6), hc
->tx_x_calc
,
161 (unsigned)(hc
->tx_x_recv
>> 6));
163 ccid3_update_send_interval(hc
);
168 * Track the mean packet size `s' (cf. RFC 4342, 5.3 and RFC 3448, 4.1)
169 * @len: DCCP packet payload size in bytes
171 static inline void ccid3_hc_tx_update_s(struct ccid3_hc_tx_sock
*hc
, int len
)
173 const u16 old_s
= hc
->tx_s
;
175 hc
->tx_s
= tfrc_ewma(hc
->tx_s
, len
, 9);
177 if (hc
->tx_s
!= old_s
)
178 ccid3_update_send_interval(hc
);
182 * Update Window Counter using the algorithm from [RFC 4342, 8.1].
183 * As elsewhere, RTT > 0 is assumed by using dccp_sample_rtt().
185 static inline void ccid3_hc_tx_update_win_count(struct ccid3_hc_tx_sock
*hc
,
188 u32 delta
= ktime_us_delta(now
, hc
->tx_t_last_win_count
),
189 quarter_rtts
= (4 * delta
) / hc
->tx_rtt
;
191 if (quarter_rtts
> 0) {
192 hc
->tx_t_last_win_count
= now
;
193 hc
->tx_last_win_count
+= min(quarter_rtts
, 5U);
194 hc
->tx_last_win_count
&= 0xF; /* mod 16 */
198 static void ccid3_hc_tx_no_feedback_timer(unsigned long data
)
200 struct sock
*sk
= (struct sock
*)data
;
201 struct ccid3_hc_tx_sock
*hc
= ccid3_hc_tx_sk(sk
);
202 unsigned long t_nfb
= USEC_PER_SEC
/ 5;
205 if (sock_owned_by_user(sk
)) {
206 /* Try again later. */
207 /* XXX: set some sensible MIB */
211 ccid3_pr_debug("%s(%p, state=%s) - entry \n", dccp_role(sk
), sk
,
212 ccid3_tx_state_name(hc
->tx_state
));
214 if (hc
->tx_state
== TFRC_SSTATE_FBACK
)
215 ccid3_hc_tx_set_state(sk
, TFRC_SSTATE_NO_FBACK
);
216 else if (hc
->tx_state
!= TFRC_SSTATE_NO_FBACK
)
220 * Determine new allowed sending rate X as per draft rfc3448bis-00, 4.4
222 if (hc
->tx_t_rto
== 0 || /* no feedback received yet */
225 /* halve send rate directly */
226 hc
->tx_x
= max(hc
->tx_x
/ 2,
227 (((__u64
)hc
->tx_s
) << 6) / TFRC_T_MBI
);
228 ccid3_update_send_interval(hc
);
231 * Modify the cached value of X_recv
233 * If (X_calc > 2 * X_recv)
234 * X_recv = max(X_recv / 2, s / (2 * t_mbi));
236 * X_recv = X_calc / 4;
238 * Note that X_recv is scaled by 2^6 while X_calc is not
240 BUG_ON(hc
->tx_p
&& !hc
->tx_x_calc
);
242 if (hc
->tx_x_calc
> (hc
->tx_x_recv
>> 5))
244 max(hc
->tx_x_recv
/ 2,
245 (((__u64
)hc
->tx_s
) << 6) / (2*TFRC_T_MBI
));
247 hc
->tx_x_recv
= hc
->tx_x_calc
;
250 ccid3_hc_tx_update_x(sk
, NULL
);
252 ccid3_pr_debug("Reduced X to %llu/64 bytes/sec\n",
253 (unsigned long long)hc
->tx_x
);
256 * Set new timeout for the nofeedback timer.
257 * See comments in packet_recv() regarding the value of t_RTO.
259 if (unlikely(hc
->tx_t_rto
== 0)) /* no feedback yet */
260 t_nfb
= TFRC_INITIAL_TIMEOUT
;
262 t_nfb
= max(hc
->tx_t_rto
, 2 * hc
->tx_t_ipi
);
265 sk_reset_timer(sk
, &hc
->tx_no_feedback_timer
,
266 jiffies
+ usecs_to_jiffies(t_nfb
));
274 * > 0: delay (in msecs) that should pass before actually sending
275 * = 0: can send immediately
276 * < 0: error condition; do not send packet
278 static int ccid3_hc_tx_send_packet(struct sock
*sk
, struct sk_buff
*skb
)
280 struct dccp_sock
*dp
= dccp_sk(sk
);
281 struct ccid3_hc_tx_sock
*hc
= ccid3_hc_tx_sk(sk
);
282 ktime_t now
= ktime_get_real();
286 * This function is called only for Data and DataAck packets. Sending
287 * zero-sized Data(Ack)s is theoretically possible, but for congestion
288 * control this case is pathological - ignore it.
290 if (unlikely(skb
->len
== 0))
293 switch (hc
->tx_state
) {
294 case TFRC_SSTATE_NO_SENT
:
295 sk_reset_timer(sk
, &hc
->tx_no_feedback_timer
, (jiffies
+
296 usecs_to_jiffies(TFRC_INITIAL_TIMEOUT
)));
297 hc
->tx_last_win_count
= 0;
298 hc
->tx_t_last_win_count
= now
;
300 /* Set t_0 for initial packet */
306 * Use initial RTT sample when available: recommended by erratum
307 * to RFC 4342. This implements the initialisation procedure of
308 * draft rfc3448bis, section 4.2. Remember, X is scaled by 2^6.
310 if (dp
->dccps_syn_rtt
) {
311 ccid3_pr_debug("SYN RTT = %uus\n", dp
->dccps_syn_rtt
);
312 hc
->tx_rtt
= dp
->dccps_syn_rtt
;
313 hc
->tx_x
= rfc3390_initial_rate(sk
);
317 * Sender does not have RTT sample:
318 * - set fallback RTT (RFC 4340, 3.4) since a RTT value
319 * is needed in several parts (e.g. window counter);
320 * - set sending rate X_pps = 1pps as per RFC 3448, 4.2.
322 hc
->tx_rtt
= DCCP_FALLBACK_RTT
;
326 ccid3_update_send_interval(hc
);
328 ccid3_hc_tx_set_state(sk
, TFRC_SSTATE_NO_FBACK
);
330 case TFRC_SSTATE_NO_FBACK
:
331 case TFRC_SSTATE_FBACK
:
332 delay
= ktime_us_delta(hc
->tx_t_nom
, now
);
333 ccid3_pr_debug("delay=%ld\n", (long)delay
);
335 * Scheduling of packet transmissions [RFC 3448, 4.6]
337 * if (t_now > t_nom - delta)
338 * // send the packet now
340 * // send the packet in (t_nom - t_now) milliseconds.
342 if (delay
- (s64
)hc
->tx_delta
>= 1000)
343 return (u32
)delay
/ 1000L;
345 ccid3_hc_tx_update_win_count(hc
, now
);
347 case TFRC_SSTATE_TERM
:
348 DCCP_BUG("%s(%p) - Illegal state TERM", dccp_role(sk
), sk
);
352 /* prepare to send now (add options etc.) */
353 dp
->dccps_hc_tx_insert_options
= 1;
354 DCCP_SKB_CB(skb
)->dccpd_ccval
= hc
->tx_last_win_count
;
356 /* set the nominal send time for the next following packet */
357 hc
->tx_t_nom
= ktime_add_us(hc
->tx_t_nom
, hc
->tx_t_ipi
);
361 static void ccid3_hc_tx_packet_sent(struct sock
*sk
, int more
,
364 struct ccid3_hc_tx_sock
*hc
= ccid3_hc_tx_sk(sk
);
366 ccid3_hc_tx_update_s(hc
, len
);
368 if (tfrc_tx_hist_add(&hc
->tx_hist
, dccp_sk(sk
)->dccps_gss
))
369 DCCP_CRIT("packet history - out of memory!");
372 static void ccid3_hc_tx_packet_recv(struct sock
*sk
, struct sk_buff
*skb
)
374 struct ccid3_hc_tx_sock
*hc
= ccid3_hc_tx_sk(sk
);
375 struct ccid3_options_received
*opt_recv
;
380 /* we are only interested in ACKs */
381 if (!(DCCP_SKB_CB(skb
)->dccpd_type
== DCCP_PKT_ACK
||
382 DCCP_SKB_CB(skb
)->dccpd_type
== DCCP_PKT_DATAACK
))
384 /* ... and only in the established state */
385 if (hc
->tx_state
!= TFRC_SSTATE_FBACK
&&
386 hc
->tx_state
!= TFRC_SSTATE_NO_FBACK
)
389 opt_recv
= &hc
->tx_options_received
;
390 now
= ktime_get_real();
392 /* Estimate RTT from history if ACK number is valid */
393 r_sample
= tfrc_tx_hist_rtt(hc
->tx_hist
,
394 DCCP_SKB_CB(skb
)->dccpd_ack_seq
, now
);
396 DCCP_WARN("%s(%p): %s with bogus ACK-%llu\n", dccp_role(sk
), sk
,
397 dccp_packet_name(DCCP_SKB_CB(skb
)->dccpd_type
),
398 (unsigned long long)DCCP_SKB_CB(skb
)->dccpd_ack_seq
);
402 /* Update receive rate in units of 64 * bytes/second */
403 hc
->tx_x_recv
= opt_recv
->ccid3or_receive_rate
;
406 /* Update loss event rate (which is scaled by 1e6) */
407 pinv
= opt_recv
->ccid3or_loss_event_rate
;
408 if (pinv
== ~0U || pinv
== 0) /* see RFC 4342, 8.5 */
410 else /* can not exceed 100% */
411 hc
->tx_p
= scaled_div(1, pinv
);
413 * Validate new RTT sample and update moving average
415 r_sample
= dccp_sample_rtt(sk
, r_sample
);
416 hc
->tx_rtt
= tfrc_ewma(hc
->tx_rtt
, r_sample
, 9);
418 * Update allowed sending rate X as per draft rfc3448bis-00, 4.2/3
420 if (hc
->tx_state
== TFRC_SSTATE_NO_FBACK
) {
421 ccid3_hc_tx_set_state(sk
, TFRC_SSTATE_FBACK
);
423 if (hc
->tx_t_rto
== 0) {
425 * Initial feedback packet: Larger Initial Windows (4.2)
427 hc
->tx_x
= rfc3390_initial_rate(sk
);
430 ccid3_update_send_interval(hc
);
432 goto done_computing_x
;
433 } else if (hc
->tx_p
== 0) {
435 * First feedback after nofeedback timer expiry (4.3)
437 goto done_computing_x
;
441 /* Update sending rate (step 4 of [RFC 3448, 4.3]) */
443 hc
->tx_x_calc
= tfrc_calc_x(hc
->tx_s
, hc
->tx_rtt
, hc
->tx_p
);
444 ccid3_hc_tx_update_x(sk
, &now
);
447 ccid3_pr_debug("%s(%p), RTT=%uus (sample=%uus), s=%u, "
448 "p=%u, X_calc=%u, X_recv=%u, X=%u\n",
449 dccp_role(sk
), sk
, hc
->tx_rtt
, r_sample
,
450 hc
->tx_s
, hc
->tx_p
, hc
->tx_x_calc
,
451 (unsigned)(hc
->tx_x_recv
>> 6),
452 (unsigned)(hc
->tx_x
>> 6));
454 /* unschedule no feedback timer */
455 sk_stop_timer(sk
, &hc
->tx_no_feedback_timer
);
458 * As we have calculated new ipi, delta, t_nom it is possible
459 * that we now can send a packet, so wake up dccp_wait_for_ccid
461 sk
->sk_write_space(sk
);
464 * Update timeout interval for the nofeedback timer.
465 * We use a configuration option to increase the lower bound.
466 * This can help avoid triggering the nofeedback timer too
467 * often ('spinning') on LANs with small RTTs.
469 hc
->tx_t_rto
= max_t(u32
, 4 * hc
->tx_rtt
, (CONFIG_IP_DCCP_CCID3_RTO
*
470 (USEC_PER_SEC
/ 1000)));
472 * Schedule no feedback timer to expire in
473 * max(t_RTO, 2 * s/X) = max(t_RTO, 2 * t_ipi)
475 t_nfb
= max(hc
->tx_t_rto
, 2 * hc
->tx_t_ipi
);
477 ccid3_pr_debug("%s(%p), Scheduled no feedback timer to "
478 "expire in %lu jiffies (%luus)\n",
479 dccp_role(sk
), sk
, usecs_to_jiffies(t_nfb
), t_nfb
);
481 sk_reset_timer(sk
, &hc
->tx_no_feedback_timer
,
482 jiffies
+ usecs_to_jiffies(t_nfb
));
485 static int ccid3_hc_tx_parse_options(struct sock
*sk
, unsigned char option
,
486 unsigned char len
, u16 idx
,
487 unsigned char *value
)
490 const struct dccp_sock
*dp
= dccp_sk(sk
);
491 struct ccid3_hc_tx_sock
*hc
= ccid3_hc_tx_sk(sk
);
492 struct ccid3_options_received
*opt_recv
;
495 opt_recv
= &hc
->tx_options_received
;
497 if (opt_recv
->ccid3or_seqno
!= dp
->dccps_gsr
) {
498 opt_recv
->ccid3or_seqno
= dp
->dccps_gsr
;
499 opt_recv
->ccid3or_loss_event_rate
= ~0;
500 opt_recv
->ccid3or_loss_intervals_idx
= 0;
501 opt_recv
->ccid3or_loss_intervals_len
= 0;
502 opt_recv
->ccid3or_receive_rate
= 0;
506 case TFRC_OPT_LOSS_EVENT_RATE
:
507 if (unlikely(len
!= 4)) {
508 DCCP_WARN("%s(%p), invalid len %d "
509 "for TFRC_OPT_LOSS_EVENT_RATE\n",
510 dccp_role(sk
), sk
, len
);
513 opt_val
= get_unaligned((__be32
*)value
);
514 opt_recv
->ccid3or_loss_event_rate
= ntohl(opt_val
);
515 ccid3_pr_debug("%s(%p), LOSS_EVENT_RATE=%u\n",
517 opt_recv
->ccid3or_loss_event_rate
);
520 case TFRC_OPT_LOSS_INTERVALS
:
521 opt_recv
->ccid3or_loss_intervals_idx
= idx
;
522 opt_recv
->ccid3or_loss_intervals_len
= len
;
523 ccid3_pr_debug("%s(%p), LOSS_INTERVALS=(%u, %u)\n",
525 opt_recv
->ccid3or_loss_intervals_idx
,
526 opt_recv
->ccid3or_loss_intervals_len
);
528 case TFRC_OPT_RECEIVE_RATE
:
529 if (unlikely(len
!= 4)) {
530 DCCP_WARN("%s(%p), invalid len %d "
531 "for TFRC_OPT_RECEIVE_RATE\n",
532 dccp_role(sk
), sk
, len
);
535 opt_val
= get_unaligned((__be32
*)value
);
536 opt_recv
->ccid3or_receive_rate
= ntohl(opt_val
);
537 ccid3_pr_debug("%s(%p), RECEIVE_RATE=%u\n",
539 opt_recv
->ccid3or_receive_rate
);
547 static int ccid3_hc_tx_init(struct ccid
*ccid
, struct sock
*sk
)
549 struct ccid3_hc_tx_sock
*hc
= ccid_priv(ccid
);
551 hc
->tx_state
= TFRC_SSTATE_NO_SENT
;
553 setup_timer(&hc
->tx_no_feedback_timer
,
554 ccid3_hc_tx_no_feedback_timer
, (unsigned long)sk
);
558 static void ccid3_hc_tx_exit(struct sock
*sk
)
560 struct ccid3_hc_tx_sock
*hc
= ccid3_hc_tx_sk(sk
);
562 ccid3_hc_tx_set_state(sk
, TFRC_SSTATE_TERM
);
563 sk_stop_timer(sk
, &hc
->tx_no_feedback_timer
);
565 tfrc_tx_hist_purge(&hc
->tx_hist
);
568 static void ccid3_hc_tx_get_info(struct sock
*sk
, struct tcp_info
*info
)
570 struct ccid3_hc_tx_sock
*hc
;
572 /* Listen socks doesn't have a private CCID block */
573 if (sk
->sk_state
== DCCP_LISTEN
)
576 hc
= ccid3_hc_tx_sk(sk
);
577 info
->tcpi_rto
= hc
->tx_t_rto
;
578 info
->tcpi_rtt
= hc
->tx_rtt
;
581 static int ccid3_hc_tx_getsockopt(struct sock
*sk
, const int optname
, int len
,
582 u32 __user
*optval
, int __user
*optlen
)
584 const struct ccid3_hc_tx_sock
*hc
;
587 /* Listen socks doesn't have a private CCID block */
588 if (sk
->sk_state
== DCCP_LISTEN
)
591 hc
= ccid3_hc_tx_sk(sk
);
593 case DCCP_SOCKOPT_CCID_TX_INFO
:
594 if (len
< sizeof(hc
->tx_tfrc
))
596 len
= sizeof(hc
->tx_tfrc
);
603 if (put_user(len
, optlen
) || copy_to_user(optval
, val
, len
))
610 * Receiver Half-Connection Routines
613 /* CCID3 feedback types */
614 enum ccid3_fback_type
{
615 CCID3_FBACK_NONE
= 0,
617 CCID3_FBACK_PERIODIC
,
618 CCID3_FBACK_PARAM_CHANGE
621 #ifdef CONFIG_IP_DCCP_CCID3_DEBUG
622 static const char *ccid3_rx_state_name(enum ccid3_hc_rx_states state
)
624 static const char *const ccid3_rx_state_names
[] = {
625 [TFRC_RSTATE_NO_DATA
] = "NO_DATA",
626 [TFRC_RSTATE_DATA
] = "DATA",
627 [TFRC_RSTATE_TERM
] = "TERM",
630 return ccid3_rx_state_names
[state
];
634 static void ccid3_hc_rx_set_state(struct sock
*sk
,
635 enum ccid3_hc_rx_states state
)
637 struct ccid3_hc_rx_sock
*hc
= ccid3_hc_rx_sk(sk
);
638 enum ccid3_hc_rx_states oldstate
= hc
->rx_state
;
640 ccid3_pr_debug("%s(%p) %-8.8s -> %s\n",
641 dccp_role(sk
), sk
, ccid3_rx_state_name(oldstate
),
642 ccid3_rx_state_name(state
));
643 WARN_ON(state
== oldstate
);
644 hc
->rx_state
= state
;
647 static void ccid3_hc_rx_send_feedback(struct sock
*sk
,
648 const struct sk_buff
*skb
,
649 enum ccid3_fback_type fbtype
)
651 struct ccid3_hc_rx_sock
*hc
= ccid3_hc_rx_sk(sk
);
652 struct dccp_sock
*dp
= dccp_sk(sk
);
656 if (unlikely(hc
->rx_state
== TFRC_RSTATE_TERM
))
659 now
= ktime_get_real();
662 case CCID3_FBACK_INITIAL
:
664 hc
->rx_pinv
= ~0U; /* see RFC 4342, 8.5 */
666 case CCID3_FBACK_PARAM_CHANGE
:
668 * When parameters change (new loss or p > p_prev), we do not
669 * have a reliable estimate for R_m of [RFC 3448, 6.2] and so
670 * need to reuse the previous value of X_recv. However, when
671 * X_recv was 0 (due to early loss), this would kill X down to
672 * s/t_mbi (i.e. one packet in 64 seconds).
673 * To avoid such drastic reduction, we approximate X_recv as
674 * the number of bytes since last feedback.
675 * This is a safe fallback, since X is bounded above by X_calc.
677 if (hc
->rx_x_recv
> 0)
680 case CCID3_FBACK_PERIODIC
:
681 delta
= ktime_us_delta(now
, hc
->rx_tstamp_last_feedback
);
683 DCCP_BUG("delta (%ld) <= 0", (long)delta
);
685 hc
->rx_x_recv
= scaled_div32(hc
->rx_bytes_recv
, delta
);
691 ccid3_pr_debug("Interval %ldusec, X_recv=%u, 1/p=%u\n", (long)delta
,
692 hc
->rx_x_recv
, hc
->rx_pinv
);
694 hc
->rx_tstamp_last_feedback
= now
;
695 hc
->rx_last_counter
= dccp_hdr(skb
)->dccph_ccval
;
696 hc
->rx_bytes_recv
= 0;
698 dp
->dccps_hc_rx_insert_options
= 1;
702 static int ccid3_hc_rx_insert_options(struct sock
*sk
, struct sk_buff
*skb
)
704 const struct ccid3_hc_rx_sock
*hc
;
707 if (!(sk
->sk_state
== DCCP_OPEN
|| sk
->sk_state
== DCCP_PARTOPEN
))
710 hc
= ccid3_hc_rx_sk(sk
);
712 if (dccp_packet_without_ack(skb
))
715 x_recv
= htonl(hc
->rx_x_recv
);
716 pinv
= htonl(hc
->rx_pinv
);
718 if (dccp_insert_option(sk
, skb
, TFRC_OPT_LOSS_EVENT_RATE
,
719 &pinv
, sizeof(pinv
)) ||
720 dccp_insert_option(sk
, skb
, TFRC_OPT_RECEIVE_RATE
,
721 &x_recv
, sizeof(x_recv
)))
728 * ccid3_first_li - Implements [RFC 5348, 6.3.1]
730 * Determine the length of the first loss interval via inverse lookup.
731 * Assume that X_recv can be computed by the throughput equation
735 * Find some p such that f(p) = fval; return 1/p (scaled).
737 static u32
ccid3_first_li(struct sock
*sk
)
739 struct ccid3_hc_rx_sock
*hc
= ccid3_hc_rx_sk(sk
);
740 u32 x_recv
, p
, delta
;
743 if (hc
->rx_rtt
== 0) {
744 DCCP_WARN("No RTT estimate available, using fallback RTT\n");
745 hc
->rx_rtt
= DCCP_FALLBACK_RTT
;
748 delta
= ktime_to_us(net_timedelta(hc
->rx_tstamp_last_feedback
));
749 x_recv
= scaled_div32(hc
->rx_bytes_recv
, delta
);
750 if (x_recv
== 0) { /* would also trigger divide-by-zero */
751 DCCP_WARN("X_recv==0\n");
752 if ((x_recv
= hc
->rx_x_recv
) == 0) {
753 DCCP_BUG("stored value of X_recv is zero");
758 fval
= scaled_div(hc
->rx_s
, hc
->rx_rtt
);
759 fval
= scaled_div32(fval
, x_recv
);
760 p
= tfrc_calc_x_reverse_lookup(fval
);
762 ccid3_pr_debug("%s(%p), receive rate=%u bytes/s, implied "
763 "loss rate=%u\n", dccp_role(sk
), sk
, x_recv
, p
);
765 return p
== 0 ? ~0U : scaled_div(1, p
);
768 static void ccid3_hc_rx_packet_recv(struct sock
*sk
, struct sk_buff
*skb
)
770 struct ccid3_hc_rx_sock
*hc
= ccid3_hc_rx_sk(sk
);
771 enum ccid3_fback_type do_feedback
= CCID3_FBACK_NONE
;
772 const u64 ndp
= dccp_sk(sk
)->dccps_options_received
.dccpor_ndp
;
773 const bool is_data_packet
= dccp_data_packet(skb
);
775 if (unlikely(hc
->rx_state
== TFRC_RSTATE_NO_DATA
)) {
776 if (is_data_packet
) {
777 const u32 payload
= skb
->len
- dccp_hdr(skb
)->dccph_doff
* 4;
778 do_feedback
= CCID3_FBACK_INITIAL
;
779 ccid3_hc_rx_set_state(sk
, TFRC_RSTATE_DATA
);
782 * Not necessary to update rx_bytes_recv here,
783 * since X_recv = 0 for the first feedback packet (cf.
784 * RFC 3448, 6.3) -- gerrit
790 if (tfrc_rx_hist_duplicate(&hc
->rx_hist
, skb
))
791 return; /* done receiving */
793 if (is_data_packet
) {
794 const u32 payload
= skb
->len
- dccp_hdr(skb
)->dccph_doff
* 4;
796 * Update moving-average of s and the sum of received payload bytes
798 hc
->rx_s
= tfrc_ewma(hc
->rx_s
, payload
, 9);
799 hc
->rx_bytes_recv
+= payload
;
803 * Perform loss detection and handle pending losses
805 if (tfrc_rx_handle_loss(&hc
->rx_hist
, &hc
->rx_li_hist
,
806 skb
, ndp
, ccid3_first_li
, sk
)) {
807 do_feedback
= CCID3_FBACK_PARAM_CHANGE
;
811 if (tfrc_rx_hist_loss_pending(&hc
->rx_hist
))
812 return; /* done receiving */
815 * Handle data packets: RTT sampling and monitoring p
817 if (unlikely(!is_data_packet
))
820 if (!tfrc_lh_is_initialised(&hc
->rx_li_hist
)) {
821 const u32 sample
= tfrc_rx_hist_sample_rtt(&hc
->rx_hist
, skb
);
823 * Empty loss history: no loss so far, hence p stays 0.
824 * Sample RTT values, since an RTT estimate is required for the
825 * computation of p when the first loss occurs; RFC 3448, 6.3.1.
828 hc
->rx_rtt
= tfrc_ewma(hc
->rx_rtt
, sample
, 9);
830 } else if (tfrc_lh_update_i_mean(&hc
->rx_li_hist
, skb
)) {
832 * Step (3) of [RFC 3448, 6.1]: Recompute I_mean and, if I_mean
833 * has decreased (resp. p has increased), send feedback now.
835 do_feedback
= CCID3_FBACK_PARAM_CHANGE
;
839 * Check if the periodic once-per-RTT feedback is due; RFC 4342, 10.3
841 if (SUB16(dccp_hdr(skb
)->dccph_ccval
, hc
->rx_last_counter
) > 3)
842 do_feedback
= CCID3_FBACK_PERIODIC
;
845 tfrc_rx_hist_add_packet(&hc
->rx_hist
, skb
, ndp
);
849 ccid3_hc_rx_send_feedback(sk
, skb
, do_feedback
);
852 static int ccid3_hc_rx_init(struct ccid
*ccid
, struct sock
*sk
)
854 struct ccid3_hc_rx_sock
*hc
= ccid_priv(ccid
);
856 hc
->rx_state
= TFRC_RSTATE_NO_DATA
;
857 tfrc_lh_init(&hc
->rx_li_hist
);
858 return tfrc_rx_hist_alloc(&hc
->rx_hist
);
861 static void ccid3_hc_rx_exit(struct sock
*sk
)
863 struct ccid3_hc_rx_sock
*hc
= ccid3_hc_rx_sk(sk
);
865 ccid3_hc_rx_set_state(sk
, TFRC_RSTATE_TERM
);
867 tfrc_rx_hist_purge(&hc
->rx_hist
);
868 tfrc_lh_cleanup(&hc
->rx_li_hist
);
871 static void ccid3_hc_rx_get_info(struct sock
*sk
, struct tcp_info
*info
)
873 const struct ccid3_hc_rx_sock
*hc
;
875 /* Listen socks doesn't have a private CCID block */
876 if (sk
->sk_state
== DCCP_LISTEN
)
879 hc
= ccid3_hc_rx_sk(sk
);
880 info
->tcpi_ca_state
= hc
->rx_state
;
881 info
->tcpi_options
|= TCPI_OPT_TIMESTAMPS
;
882 info
->tcpi_rcv_rtt
= hc
->rx_rtt
;
885 static int ccid3_hc_rx_getsockopt(struct sock
*sk
, const int optname
, int len
,
886 u32 __user
*optval
, int __user
*optlen
)
888 const struct ccid3_hc_rx_sock
*hc
;
889 struct tfrc_rx_info rx_info
;
892 /* Listen socks doesn't have a private CCID block */
893 if (sk
->sk_state
== DCCP_LISTEN
)
896 hc
= ccid3_hc_rx_sk(sk
);
898 case DCCP_SOCKOPT_CCID_RX_INFO
:
899 if (len
< sizeof(rx_info
))
901 rx_info
.tfrcrx_x_recv
= hc
->rx_x_recv
;
902 rx_info
.tfrcrx_rtt
= hc
->rx_rtt
;
903 rx_info
.tfrcrx_p
= hc
->rx_pinv
== 0 ? ~0U :
904 scaled_div(1, hc
->rx_pinv
);
905 len
= sizeof(rx_info
);
912 if (put_user(len
, optlen
) || copy_to_user(optval
, val
, len
))
918 struct ccid_operations ccid3_ops
= {
919 .ccid_id
= DCCPC_CCID3
,
920 .ccid_name
= "TCP-Friendly Rate Control",
921 .ccid_hc_tx_obj_size
= sizeof(struct ccid3_hc_tx_sock
),
922 .ccid_hc_tx_init
= ccid3_hc_tx_init
,
923 .ccid_hc_tx_exit
= ccid3_hc_tx_exit
,
924 .ccid_hc_tx_send_packet
= ccid3_hc_tx_send_packet
,
925 .ccid_hc_tx_packet_sent
= ccid3_hc_tx_packet_sent
,
926 .ccid_hc_tx_packet_recv
= ccid3_hc_tx_packet_recv
,
927 .ccid_hc_tx_parse_options
= ccid3_hc_tx_parse_options
,
928 .ccid_hc_rx_obj_size
= sizeof(struct ccid3_hc_rx_sock
),
929 .ccid_hc_rx_init
= ccid3_hc_rx_init
,
930 .ccid_hc_rx_exit
= ccid3_hc_rx_exit
,
931 .ccid_hc_rx_insert_options
= ccid3_hc_rx_insert_options
,
932 .ccid_hc_rx_packet_recv
= ccid3_hc_rx_packet_recv
,
933 .ccid_hc_rx_get_info
= ccid3_hc_rx_get_info
,
934 .ccid_hc_tx_get_info
= ccid3_hc_tx_get_info
,
935 .ccid_hc_rx_getsockopt
= ccid3_hc_rx_getsockopt
,
936 .ccid_hc_tx_getsockopt
= ccid3_hc_tx_getsockopt
,
939 #ifdef CONFIG_IP_DCCP_CCID3_DEBUG
940 module_param(ccid3_debug
, bool, 0644);
941 MODULE_PARM_DESC(ccid3_debug
, "Enable CCID-3 debug messages");