2 * net/dccp/ccids/ccid3.c
4 * Copyright (c) 2005-7 The University of Waikato, Hamilton, New Zealand.
5 * Copyright (c) 2005-7 Ian McDonald <ian.mcdonald@jandi.co.nz>
7 * An implementation of the DCCP protocol
9 * This code has been developed by the University of Waikato WAND
10 * research group. For further information please see http://www.wand.net.nz/
12 * This code also uses code from Lulea University, rereleased as GPL by its
14 * Copyright (c) 2003 Nils-Erik Mattsson, Joacim Haggmark, Magnus Erixzon
16 * Changes to meet Linux coding standards, to make it meet latest ccid3 draft
17 * and to make it work as a loadable module in the DCCP stack written by
18 * Arnaldo Carvalho de Melo <acme@conectiva.com.br>.
20 * Copyright (c) 2005 Arnaldo Carvalho de Melo <acme@conectiva.com.br>
22 * This program is free software; you can redistribute it and/or modify
23 * it under the terms of the GNU General Public License as published by
24 * the Free Software Foundation; either version 2 of the License, or
25 * (at your option) any later version.
27 * This program is distributed in the hope that it will be useful,
28 * but WITHOUT ANY WARRANTY; without even the implied warranty of
29 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
30 * GNU General Public License for more details.
32 * You should have received a copy of the GNU General Public License
33 * along with this program; if not, write to the Free Software
34 * Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
38 #include "lib/packet_history.h"
39 #include "lib/loss_interval.h"
43 #ifdef CONFIG_IP_DCCP_CCID3_DEBUG
44 static int ccid3_debug;
45 #define ccid3_pr_debug(format, a...) DCCP_PR_DEBUG(ccid3_debug, format, ##a)
47 #define ccid3_pr_debug(format, a...)
50 static struct dccp_tx_hist *ccid3_tx_hist;
51 static struct dccp_rx_hist *ccid3_rx_hist;
52 static struct dccp_li_hist *ccid3_li_hist;
55 * Transmitter Half-Connection Routines
57 #ifdef CONFIG_IP_DCCP_CCID3_DEBUG
58 static const char *ccid3_tx_state_name(enum ccid3_hc_tx_states state)
60 static char *ccid3_state_names[] = {
61 [TFRC_SSTATE_NO_SENT] = "NO_SENT",
62 [TFRC_SSTATE_NO_FBACK] = "NO_FBACK",
63 [TFRC_SSTATE_FBACK] = "FBACK",
64 [TFRC_SSTATE_TERM] = "TERM",
67 return ccid3_state_names[state];
71 static void ccid3_hc_tx_set_state(struct sock *sk,
72 enum ccid3_hc_tx_states state)
74 struct ccid3_hc_tx_sock *hctx = ccid3_hc_tx_sk(sk);
75 enum ccid3_hc_tx_states oldstate = hctx->ccid3hctx_state;
77 ccid3_pr_debug("%s(%p) %-8.8s -> %s\n",
78 dccp_role(sk), sk, ccid3_tx_state_name(oldstate),
79 ccid3_tx_state_name(state));
80 WARN_ON(state == oldstate);
81 hctx->ccid3hctx_state = state;
85 * Compute the initial sending rate X_init according to RFC 3390:
86 * w_init = min(4 * MSS, max(2 * MSS, 4380 bytes))
87 * X_init = w_init / RTT
88 * For consistency with other parts of the code, X_init is scaled by 2^6.
90 static inline u64 rfc3390_initial_rate(struct sock *sk)
92 const struct dccp_sock *dp = dccp_sk(sk);
93 const __u32 w_init = min(4 * dp->dccps_mss_cache,
94 max(2 * dp->dccps_mss_cache, 4380U));
96 return scaled_div(w_init << 6, ccid3_hc_tx_sk(sk)->ccid3hctx_rtt);
100 * Recalculate t_ipi and delta (should be called whenever X changes)
102 static inline void ccid3_update_send_interval(struct ccid3_hc_tx_sock *hctx)
104 /* Calculate new t_ipi = s / X_inst (X_inst is in 64 * bytes/second) */
105 hctx->ccid3hctx_t_ipi = scaled_div32(((u64)hctx->ccid3hctx_s) << 6,
108 /* Calculate new delta by delta = min(t_ipi / 2, t_gran / 2) */
109 hctx->ccid3hctx_delta = min_t(u32, hctx->ccid3hctx_t_ipi / 2,
110 TFRC_OPSYS_HALF_TIME_GRAN);
112 ccid3_pr_debug("t_ipi=%u, delta=%u, s=%u, X=%u\n",
113 hctx->ccid3hctx_t_ipi, hctx->ccid3hctx_delta,
114 hctx->ccid3hctx_s, (unsigned)(hctx->ccid3hctx_x >> 6));
120 * X_calc = calcX(s, R, p);
121 * X = max(min(X_calc, 2 * X_recv), s / t_mbi);
123 * If (now - tld >= R)
124 * X = max(min(2 * X, 2 * X_recv), s / R);
127 * Note: X and X_recv are both stored in units of 64 * bytes/second, to support
128 * fine-grained resolution of sending rates. This requires scaling by 2^6
129 * throughout the code. Only X_calc is unscaled (in bytes/second).
132 static void ccid3_hc_tx_update_x(struct sock *sk, struct timeval *now)
135 struct ccid3_hc_tx_sock *hctx = ccid3_hc_tx_sk(sk);
136 __u64 min_rate = 2 * hctx->ccid3hctx_x_recv;
137 const __u64 old_x = hctx->ccid3hctx_x;
140 * Handle IDLE periods: do not reduce below RFC3390 initial sending rate
141 * when idling [RFC 4342, 5.1]. See also draft-ietf-dccp-rfc3448bis.
142 * For consistency with X and X_recv, min_rate is also scaled by 2^6.
144 if (unlikely(hctx->ccid3hctx_idle)) {
145 min_rate = rfc3390_initial_rate(sk);
146 min_rate = max(min_rate, 2 * hctx->ccid3hctx_x_recv);
149 if (hctx->ccid3hctx_p > 0) {
151 hctx->ccid3hctx_x = min(((__u64)hctx->ccid3hctx_x_calc) << 6,
153 hctx->ccid3hctx_x = max(hctx->ccid3hctx_x,
154 (((__u64)hctx->ccid3hctx_s) << 6) /
157 } else if (timeval_delta(now, &hctx->ccid3hctx_t_ld) -
158 (suseconds_t)hctx->ccid3hctx_rtt >= 0) {
161 max(min(2 * hctx->ccid3hctx_x, min_rate),
162 scaled_div(((__u64)hctx->ccid3hctx_s) << 6,
163 hctx->ccid3hctx_rtt));
164 hctx->ccid3hctx_t_ld = *now;
167 if (hctx->ccid3hctx_x != old_x) {
168 ccid3_pr_debug("X_prev=%u, X_now=%u, X_calc=%u, "
169 "X_recv=%u\n", (unsigned)(old_x >> 6),
170 (unsigned)(hctx->ccid3hctx_x >> 6),
171 hctx->ccid3hctx_x_calc,
172 (unsigned)(hctx->ccid3hctx_x_recv >> 6));
174 ccid3_update_send_interval(hctx);
179 * Track the mean packet size `s' (cf. RFC 4342, 5.3 and RFC 3448, 4.1)
180 * @len: DCCP packet payload size in bytes
182 static inline void ccid3_hc_tx_update_s(struct ccid3_hc_tx_sock *hctx, int len)
184 const u16 old_s = hctx->ccid3hctx_s;
186 hctx->ccid3hctx_s = old_s == 0 ? len : (9 * old_s + len) / 10;
188 if (hctx->ccid3hctx_s != old_s)
189 ccid3_update_send_interval(hctx);
193 * Update Window Counter using the algorithm from [RFC 4342, 8.1].
194 * The algorithm is not applicable if RTT < 4 microseconds.
196 static inline void ccid3_hc_tx_update_win_count(struct ccid3_hc_tx_sock *hctx,
202 if (unlikely(hctx->ccid3hctx_rtt < 4)) /* avoid divide-by-zero */
205 delta = timeval_delta(now, &hctx->ccid3hctx_t_last_win_count);
206 DCCP_BUG_ON(delta < 0);
208 quarter_rtts = (u32)delta / (hctx->ccid3hctx_rtt / 4);
210 if (quarter_rtts > 0) {
211 hctx->ccid3hctx_t_last_win_count = *now;
212 hctx->ccid3hctx_last_win_count += min_t(u32, quarter_rtts, 5);
213 hctx->ccid3hctx_last_win_count &= 0xF; /* mod 16 */
215 ccid3_pr_debug("now at %#X\n", hctx->ccid3hctx_last_win_count);
219 static void ccid3_hc_tx_no_feedback_timer(unsigned long data)
221 struct sock *sk = (struct sock *)data;
222 struct ccid3_hc_tx_sock *hctx = ccid3_hc_tx_sk(sk);
224 unsigned long t_nfb = USEC_PER_SEC / 5;
227 if (sock_owned_by_user(sk)) {
228 /* Try again later. */
229 /* XXX: set some sensible MIB */
233 ccid3_pr_debug("%s(%p, state=%s) - entry \n", dccp_role(sk), sk,
234 ccid3_tx_state_name(hctx->ccid3hctx_state));
236 hctx->ccid3hctx_idle = 1;
238 switch (hctx->ccid3hctx_state) {
239 case TFRC_SSTATE_NO_FBACK:
240 /* RFC 3448, 4.4: Halve send rate directly */
241 hctx->ccid3hctx_x = max(hctx->ccid3hctx_x / 2,
242 (((__u64)hctx->ccid3hctx_s) << 6) /
245 ccid3_pr_debug("%s(%p, state=%s), updated tx rate to %u "
246 "bytes/s\n", dccp_role(sk), sk,
247 ccid3_tx_state_name(hctx->ccid3hctx_state),
248 (unsigned)(hctx->ccid3hctx_x >> 6));
249 /* The value of R is still undefined and so we can not recompute
250 * the timout value. Keep initial value as per [RFC 4342, 5]. */
251 t_nfb = TFRC_INITIAL_TIMEOUT;
252 ccid3_update_send_interval(hctx);
254 case TFRC_SSTATE_FBACK:
256 * Modify the cached value of X_recv [RFC 3448, 4.4]
258 * If (p == 0 || X_calc > 2 * X_recv)
259 * X_recv = max(X_recv / 2, s / (2 * t_mbi));
261 * X_recv = X_calc / 4;
263 * Note that X_recv is scaled by 2^6 while X_calc is not
265 BUG_ON(hctx->ccid3hctx_p && !hctx->ccid3hctx_x_calc);
267 if (hctx->ccid3hctx_p == 0 ||
268 (hctx->ccid3hctx_x_calc > (hctx->ccid3hctx_x_recv >> 5))) {
270 hctx->ccid3hctx_x_recv =
271 max(hctx->ccid3hctx_x_recv / 2,
272 (((__u64)hctx->ccid3hctx_s) << 6) /
275 if (hctx->ccid3hctx_p == 0)
276 dccp_timestamp(sk, &now);
278 hctx->ccid3hctx_x_recv = hctx->ccid3hctx_x_calc;
279 hctx->ccid3hctx_x_recv <<= 4;
281 /* Now recalculate X [RFC 3448, 4.3, step (4)] */
282 ccid3_hc_tx_update_x(sk, &now);
284 * Schedule no feedback timer to expire in
285 * max(t_RTO, 2 * s/X) = max(t_RTO, 2 * t_ipi)
286 * See comments in packet_recv() regarding the value of t_RTO.
288 t_nfb = max(hctx->ccid3hctx_t_rto, 2 * hctx->ccid3hctx_t_ipi);
290 case TFRC_SSTATE_NO_SENT:
291 DCCP_BUG("%s(%p) - Illegal state NO_SENT", dccp_role(sk), sk);
293 case TFRC_SSTATE_TERM:
298 sk_reset_timer(sk, &hctx->ccid3hctx_no_feedback_timer,
299 jiffies + usecs_to_jiffies(t_nfb));
307 * > 0: delay (in msecs) that should pass before actually sending
308 * = 0: can send immediately
309 * < 0: error condition; do not send packet
311 static int ccid3_hc_tx_send_packet(struct sock *sk, struct sk_buff *skb)
313 struct dccp_sock *dp = dccp_sk(sk);
314 struct ccid3_hc_tx_sock *hctx = ccid3_hc_tx_sk(sk);
318 BUG_ON(hctx == NULL);
321 * This function is called only for Data and DataAck packets. Sending
322 * zero-sized Data(Ack)s is theoretically possible, but for congestion
323 * control this case is pathological - ignore it.
325 if (unlikely(skb->len == 0))
328 dccp_timestamp(sk, &now);
330 switch (hctx->ccid3hctx_state) {
331 case TFRC_SSTATE_NO_SENT:
332 sk_reset_timer(sk, &hctx->ccid3hctx_no_feedback_timer,
334 usecs_to_jiffies(TFRC_INITIAL_TIMEOUT)));
335 hctx->ccid3hctx_last_win_count = 0;
336 hctx->ccid3hctx_t_last_win_count = now;
338 /* Set t_0 for initial packet */
339 hctx->ccid3hctx_t_nom = now;
341 hctx->ccid3hctx_s = skb->len;
344 * Use initial RTT sample when available: recommended by erratum
345 * to RFC 4342. This implements the initialisation procedure of
346 * draft rfc3448bis, section 4.2. Remember, X is scaled by 2^6.
348 if (dp->dccps_syn_rtt) {
349 ccid3_pr_debug("SYN RTT = %uus\n", dp->dccps_syn_rtt);
350 hctx->ccid3hctx_rtt = dp->dccps_syn_rtt;
351 hctx->ccid3hctx_x = rfc3390_initial_rate(sk);
352 hctx->ccid3hctx_t_ld = now;
354 /* Sender does not have RTT sample: X = MSS/second */
355 hctx->ccid3hctx_x = dp->dccps_mss_cache;
356 hctx->ccid3hctx_x <<= 6;
358 ccid3_update_send_interval(hctx);
360 ccid3_hc_tx_set_state(sk, TFRC_SSTATE_NO_FBACK);
362 case TFRC_SSTATE_NO_FBACK:
363 case TFRC_SSTATE_FBACK:
364 delay = timeval_delta(&hctx->ccid3hctx_t_nom, &now);
365 ccid3_pr_debug("delay=%ld\n", (long)delay);
367 * Scheduling of packet transmissions [RFC 3448, 4.6]
369 * if (t_now > t_nom - delta)
370 * // send the packet now
372 * // send the packet in (t_nom - t_now) milliseconds.
374 if (delay - (suseconds_t)hctx->ccid3hctx_delta >= 0)
375 return delay / 1000L;
377 ccid3_hc_tx_update_win_count(hctx, &now);
379 case TFRC_SSTATE_TERM:
380 DCCP_BUG("%s(%p) - Illegal state TERM", dccp_role(sk), sk);
384 /* prepare to send now (add options etc.) */
385 dp->dccps_hc_tx_insert_options = 1;
386 DCCP_SKB_CB(skb)->dccpd_ccval = hctx->ccid3hctx_last_win_count;
387 hctx->ccid3hctx_idle = 0;
389 /* set the nominal send time for the next following packet */
390 timeval_add_usecs(&hctx->ccid3hctx_t_nom, hctx->ccid3hctx_t_ipi);
395 static void ccid3_hc_tx_packet_sent(struct sock *sk, int more,
398 struct ccid3_hc_tx_sock *hctx = ccid3_hc_tx_sk(sk);
400 struct dccp_tx_hist_entry *packet;
402 BUG_ON(hctx == NULL);
404 ccid3_hc_tx_update_s(hctx, len);
406 packet = dccp_tx_hist_entry_new(ccid3_tx_hist, GFP_ATOMIC);
407 if (unlikely(packet == NULL)) {
408 DCCP_CRIT("packet history - out of memory!");
411 dccp_tx_hist_add_entry(&hctx->ccid3hctx_hist, packet);
413 dccp_timestamp(sk, &now);
414 packet->dccphtx_tstamp = now;
415 packet->dccphtx_seqno = dccp_sk(sk)->dccps_gss;
416 packet->dccphtx_rtt = hctx->ccid3hctx_rtt;
417 packet->dccphtx_sent = 1;
420 static void ccid3_hc_tx_packet_recv(struct sock *sk, struct sk_buff *skb)
422 struct ccid3_hc_tx_sock *hctx = ccid3_hc_tx_sk(sk);
423 struct ccid3_options_received *opt_recv;
424 struct dccp_tx_hist_entry *packet;
429 BUG_ON(hctx == NULL);
431 /* we are only interested in ACKs */
432 if (!(DCCP_SKB_CB(skb)->dccpd_type == DCCP_PKT_ACK ||
433 DCCP_SKB_CB(skb)->dccpd_type == DCCP_PKT_DATAACK))
436 opt_recv = &hctx->ccid3hctx_options_received;
438 switch (hctx->ccid3hctx_state) {
439 case TFRC_SSTATE_NO_FBACK:
440 case TFRC_SSTATE_FBACK:
441 /* get packet from history to look up t_recvdata */
442 packet = dccp_tx_hist_find_entry(&hctx->ccid3hctx_hist,
443 DCCP_SKB_CB(skb)->dccpd_ack_seq);
444 if (unlikely(packet == NULL)) {
445 DCCP_WARN("%s(%p), seqno %llu(%s) doesn't exist "
446 "in history!\n", dccp_role(sk), sk,
447 (unsigned long long)DCCP_SKB_CB(skb)->dccpd_ack_seq,
448 dccp_packet_name(DCCP_SKB_CB(skb)->dccpd_type));
452 /* Update receive rate in units of 64 * bytes/second */
453 hctx->ccid3hctx_x_recv = opt_recv->ccid3or_receive_rate;
454 hctx->ccid3hctx_x_recv <<= 6;
456 /* Update loss event rate */
457 pinv = opt_recv->ccid3or_loss_event_rate;
458 if (pinv == ~0U || pinv == 0) /* see RFC 4342, 8.5 */
459 hctx->ccid3hctx_p = 0;
460 else /* can not exceed 100% */
461 hctx->ccid3hctx_p = 1000000 / pinv;
463 dccp_timestamp(sk, &now);
466 * Calculate new round trip sample as per [RFC 3448, 4.3] by
467 * R_sample = (now - t_recvdata) - t_elapsed
469 r_sample = dccp_sample_rtt(sk, &now, &packet->dccphtx_tstamp);
472 * Update RTT estimate by
473 * If (No feedback recv)
476 * R = q * R + (1 - q) * R_sample;
478 * q is a constant, RFC 3448 recomments 0.9
480 if (hctx->ccid3hctx_state == TFRC_SSTATE_NO_FBACK) {
482 * Larger Initial Windows [RFC 4342, sec. 5]
484 hctx->ccid3hctx_rtt = r_sample;
485 hctx->ccid3hctx_x = rfc3390_initial_rate(sk);
486 hctx->ccid3hctx_t_ld = now;
488 ccid3_update_send_interval(hctx);
490 ccid3_pr_debug("%s(%p), s=%u, MSS=%u, "
491 "R_sample=%uus, X=%u\n", dccp_role(sk),
492 sk, hctx->ccid3hctx_s,
493 dccp_sk(sk)->dccps_mss_cache, r_sample,
494 (unsigned)(hctx->ccid3hctx_x >> 6));
496 ccid3_hc_tx_set_state(sk, TFRC_SSTATE_FBACK);
498 hctx->ccid3hctx_rtt = (9 * hctx->ccid3hctx_rtt +
501 /* Update sending rate (step 4 of [RFC 3448, 4.3]) */
502 if (hctx->ccid3hctx_p > 0)
503 hctx->ccid3hctx_x_calc =
504 tfrc_calc_x(hctx->ccid3hctx_s,
507 ccid3_hc_tx_update_x(sk, &now);
509 ccid3_pr_debug("%s(%p), RTT=%uus (sample=%uus), s=%u, "
510 "p=%u, X_calc=%u, X_recv=%u, X=%u\n",
512 sk, hctx->ccid3hctx_rtt, r_sample,
513 hctx->ccid3hctx_s, hctx->ccid3hctx_p,
514 hctx->ccid3hctx_x_calc,
515 (unsigned)(hctx->ccid3hctx_x_recv >> 6),
516 (unsigned)(hctx->ccid3hctx_x >> 6));
519 /* unschedule no feedback timer */
520 sk_stop_timer(sk, &hctx->ccid3hctx_no_feedback_timer);
522 /* remove all packets older than the one acked from history */
523 dccp_tx_hist_purge_older(ccid3_tx_hist,
524 &hctx->ccid3hctx_hist, packet);
526 * As we have calculated new ipi, delta, t_nom it is possible
527 * that we now can send a packet, so wake up dccp_wait_for_ccid
529 sk->sk_write_space(sk);
532 * Update timeout interval for the nofeedback timer.
533 * We use a configuration option to increase the lower bound.
534 * This can help avoid triggering the nofeedback timer too
535 * often ('spinning') on LANs with small RTTs.
537 hctx->ccid3hctx_t_rto = max_t(u32, 4 * hctx->ccid3hctx_rtt,
538 CONFIG_IP_DCCP_CCID3_RTO *
539 (USEC_PER_SEC/1000));
541 * Schedule no feedback timer to expire in
542 * max(t_RTO, 2 * s/X) = max(t_RTO, 2 * t_ipi)
544 t_nfb = max(hctx->ccid3hctx_t_rto, 2 * hctx->ccid3hctx_t_ipi);
546 ccid3_pr_debug("%s(%p), Scheduled no feedback timer to "
547 "expire in %lu jiffies (%luus)\n",
549 sk, usecs_to_jiffies(t_nfb), t_nfb);
551 sk_reset_timer(sk, &hctx->ccid3hctx_no_feedback_timer,
552 jiffies + usecs_to_jiffies(t_nfb));
555 hctx->ccid3hctx_idle = 1;
557 case TFRC_SSTATE_NO_SENT: /* fall through */
558 case TFRC_SSTATE_TERM: /* ignore feedback when closing */
563 static int ccid3_hc_tx_parse_options(struct sock *sk, unsigned char option,
564 unsigned char len, u16 idx,
565 unsigned char *value)
568 const struct dccp_sock *dp = dccp_sk(sk);
569 struct ccid3_hc_tx_sock *hctx = ccid3_hc_tx_sk(sk);
570 struct ccid3_options_received *opt_recv;
572 BUG_ON(hctx == NULL);
574 opt_recv = &hctx->ccid3hctx_options_received;
576 if (opt_recv->ccid3or_seqno != dp->dccps_gsr) {
577 opt_recv->ccid3or_seqno = dp->dccps_gsr;
578 opt_recv->ccid3or_loss_event_rate = ~0;
579 opt_recv->ccid3or_loss_intervals_idx = 0;
580 opt_recv->ccid3or_loss_intervals_len = 0;
581 opt_recv->ccid3or_receive_rate = 0;
585 case TFRC_OPT_LOSS_EVENT_RATE:
586 if (unlikely(len != 4)) {
587 DCCP_WARN("%s(%p), invalid len %d "
588 "for TFRC_OPT_LOSS_EVENT_RATE\n",
589 dccp_role(sk), sk, len);
592 opt_recv->ccid3or_loss_event_rate =
593 ntohl(*(__be32 *)value);
594 ccid3_pr_debug("%s(%p), LOSS_EVENT_RATE=%u\n",
596 opt_recv->ccid3or_loss_event_rate);
599 case TFRC_OPT_LOSS_INTERVALS:
600 opt_recv->ccid3or_loss_intervals_idx = idx;
601 opt_recv->ccid3or_loss_intervals_len = len;
602 ccid3_pr_debug("%s(%p), LOSS_INTERVALS=(%u, %u)\n",
604 opt_recv->ccid3or_loss_intervals_idx,
605 opt_recv->ccid3or_loss_intervals_len);
607 case TFRC_OPT_RECEIVE_RATE:
608 if (unlikely(len != 4)) {
609 DCCP_WARN("%s(%p), invalid len %d "
610 "for TFRC_OPT_RECEIVE_RATE\n",
611 dccp_role(sk), sk, len);
614 opt_recv->ccid3or_receive_rate =
615 ntohl(*(__be32 *)value);
616 ccid3_pr_debug("%s(%p), RECEIVE_RATE=%u\n",
618 opt_recv->ccid3or_receive_rate);
626 static int ccid3_hc_tx_init(struct ccid *ccid, struct sock *sk)
628 struct ccid3_hc_tx_sock *hctx = ccid_priv(ccid);
630 hctx->ccid3hctx_s = 0;
631 hctx->ccid3hctx_rtt = 0;
632 hctx->ccid3hctx_state = TFRC_SSTATE_NO_SENT;
633 INIT_LIST_HEAD(&hctx->ccid3hctx_hist);
635 hctx->ccid3hctx_no_feedback_timer.function =
636 ccid3_hc_tx_no_feedback_timer;
637 hctx->ccid3hctx_no_feedback_timer.data = (unsigned long)sk;
638 init_timer(&hctx->ccid3hctx_no_feedback_timer);
643 static void ccid3_hc_tx_exit(struct sock *sk)
645 struct ccid3_hc_tx_sock *hctx = ccid3_hc_tx_sk(sk);
647 BUG_ON(hctx == NULL);
649 ccid3_hc_tx_set_state(sk, TFRC_SSTATE_TERM);
650 sk_stop_timer(sk, &hctx->ccid3hctx_no_feedback_timer);
652 /* Empty packet history */
653 dccp_tx_hist_purge(ccid3_tx_hist, &hctx->ccid3hctx_hist);
656 static void ccid3_hc_tx_get_info(struct sock *sk, struct tcp_info *info)
658 const struct ccid3_hc_tx_sock *hctx = ccid3_hc_tx_sk(sk);
660 /* Listen socks doesn't have a private CCID block */
661 if (sk->sk_state == DCCP_LISTEN)
664 BUG_ON(hctx == NULL);
666 info->tcpi_rto = hctx->ccid3hctx_t_rto;
667 info->tcpi_rtt = hctx->ccid3hctx_rtt;
670 static int ccid3_hc_tx_getsockopt(struct sock *sk, const int optname, int len,
671 u32 __user *optval, int __user *optlen)
673 const struct ccid3_hc_tx_sock *hctx = ccid3_hc_tx_sk(sk);
676 /* Listen socks doesn't have a private CCID block */
677 if (sk->sk_state == DCCP_LISTEN)
681 case DCCP_SOCKOPT_CCID_TX_INFO:
682 if (len < sizeof(hctx->ccid3hctx_tfrc))
684 len = sizeof(hctx->ccid3hctx_tfrc);
685 val = &hctx->ccid3hctx_tfrc;
691 if (put_user(len, optlen) || copy_to_user(optval, val, len))
698 * Receiver Half-Connection Routines
700 #ifdef CONFIG_IP_DCCP_CCID3_DEBUG
701 static const char *ccid3_rx_state_name(enum ccid3_hc_rx_states state)
703 static char *ccid3_rx_state_names[] = {
704 [TFRC_RSTATE_NO_DATA] = "NO_DATA",
705 [TFRC_RSTATE_DATA] = "DATA",
706 [TFRC_RSTATE_TERM] = "TERM",
709 return ccid3_rx_state_names[state];
713 static void ccid3_hc_rx_set_state(struct sock *sk,
714 enum ccid3_hc_rx_states state)
716 struct ccid3_hc_rx_sock *hcrx = ccid3_hc_rx_sk(sk);
717 enum ccid3_hc_rx_states oldstate = hcrx->ccid3hcrx_state;
719 ccid3_pr_debug("%s(%p) %-8.8s -> %s\n",
720 dccp_role(sk), sk, ccid3_rx_state_name(oldstate),
721 ccid3_rx_state_name(state));
722 WARN_ON(state == oldstate);
723 hcrx->ccid3hcrx_state = state;
726 static inline void ccid3_hc_rx_update_s(struct ccid3_hc_rx_sock *hcrx, int len)
728 if (unlikely(len == 0)) /* don't update on empty packets (e.g. ACKs) */
729 ccid3_pr_debug("Packet payload length is 0 - not updating\n");
731 hcrx->ccid3hcrx_s = hcrx->ccid3hcrx_s == 0 ? len :
732 (9 * hcrx->ccid3hcrx_s + len) / 10;
735 static void ccid3_hc_rx_send_feedback(struct sock *sk)
737 struct ccid3_hc_rx_sock *hcrx = ccid3_hc_rx_sk(sk);
738 struct dccp_sock *dp = dccp_sk(sk);
739 struct dccp_rx_hist_entry *packet;
743 ccid3_pr_debug("%s(%p) - entry \n", dccp_role(sk), sk);
745 dccp_timestamp(sk, &now);
747 switch (hcrx->ccid3hcrx_state) {
748 case TFRC_RSTATE_NO_DATA:
749 hcrx->ccid3hcrx_x_recv = 0;
751 case TFRC_RSTATE_DATA:
752 delta = timeval_delta(&now,
753 &hcrx->ccid3hcrx_tstamp_last_feedback);
754 DCCP_BUG_ON(delta < 0);
755 hcrx->ccid3hcrx_x_recv =
756 scaled_div32(hcrx->ccid3hcrx_bytes_recv, delta);
758 case TFRC_RSTATE_TERM:
759 DCCP_BUG("%s(%p) - Illegal state TERM", dccp_role(sk), sk);
763 packet = dccp_rx_hist_find_data_packet(&hcrx->ccid3hcrx_hist);
764 if (unlikely(packet == NULL)) {
765 DCCP_WARN("%s(%p), no data packet in history!\n",
770 hcrx->ccid3hcrx_tstamp_last_feedback = now;
771 hcrx->ccid3hcrx_ccval_last_counter = packet->dccphrx_ccval;
772 hcrx->ccid3hcrx_bytes_recv = 0;
774 /* Elapsed time information [RFC 4340, 13.2] in units of 10 * usecs */
775 delta = timeval_delta(&now, &packet->dccphrx_tstamp);
776 DCCP_BUG_ON(delta < 0);
777 hcrx->ccid3hcrx_elapsed_time = delta / 10;
779 if (hcrx->ccid3hcrx_p == 0)
780 hcrx->ccid3hcrx_pinv = ~0U; /* see RFC 4342, 8.5 */
781 else if (hcrx->ccid3hcrx_p > 1000000) {
782 DCCP_WARN("p (%u) > 100%%\n", hcrx->ccid3hcrx_p);
783 hcrx->ccid3hcrx_pinv = 1; /* use 100% in this case */
785 hcrx->ccid3hcrx_pinv = 1000000 / hcrx->ccid3hcrx_p;
787 dp->dccps_hc_rx_insert_options = 1;
791 static int ccid3_hc_rx_insert_options(struct sock *sk, struct sk_buff *skb)
793 const struct ccid3_hc_rx_sock *hcrx = ccid3_hc_rx_sk(sk);
796 BUG_ON(hcrx == NULL);
798 if (!(sk->sk_state == DCCP_OPEN || sk->sk_state == DCCP_PARTOPEN))
801 DCCP_SKB_CB(skb)->dccpd_ccval = hcrx->ccid3hcrx_ccval_last_counter;
803 if (dccp_packet_without_ack(skb))
806 x_recv = htonl(hcrx->ccid3hcrx_x_recv);
807 pinv = htonl(hcrx->ccid3hcrx_pinv);
809 if ((hcrx->ccid3hcrx_elapsed_time != 0 &&
810 dccp_insert_option_elapsed_time(sk, skb,
811 hcrx->ccid3hcrx_elapsed_time)) ||
812 dccp_insert_option_timestamp(sk, skb) ||
813 dccp_insert_option(sk, skb, TFRC_OPT_LOSS_EVENT_RATE,
814 &pinv, sizeof(pinv)) ||
815 dccp_insert_option(sk, skb, TFRC_OPT_RECEIVE_RATE,
816 &x_recv, sizeof(x_recv)))
822 /* calculate first loss interval
824 * returns estimated loss interval in usecs */
826 static u32 ccid3_hc_rx_calc_first_li(struct sock *sk,
827 struct list_head *hist_list,
828 struct timeval *last_feedback,
829 u16 s, u32 bytes_recv,
832 struct dccp_rx_hist_entry *entry, *next, *tail = NULL;
834 suseconds_t rtt, delta;
835 struct timeval tstamp = { 0, 0 };
841 list_for_each_entry_safe(entry, next, hist_list, dccphrx_node) {
842 if (dccp_rx_hist_entry_data_packet(entry)) {
847 tstamp = entry->dccphrx_tstamp;
848 win_count = entry->dccphrx_ccval;
852 interval = win_count - entry->dccphrx_ccval;
854 interval += TFRC_WIN_COUNT_LIMIT;
862 if (unlikely(step == 0)) {
863 DCCP_WARN("%s(%p), packet history has no data packets!\n",
868 if (unlikely(interval == 0)) {
869 DCCP_WARN("%s(%p), Could not find a win_count interval > 0."
870 "Defaulting to 1\n", dccp_role(sk), sk);
875 DCCP_CRIT("tail is null\n");
879 delta = timeval_delta(&tstamp, &tail->dccphrx_tstamp);
880 DCCP_BUG_ON(delta < 0);
882 rtt = delta * 4 / interval;
883 ccid3_pr_debug("%s(%p), approximated RTT to %dus\n",
884 dccp_role(sk), sk, (int)rtt);
887 * Determine the length of the first loss interval via inverse lookup.
888 * Assume that X_recv can be computed by the throughput equation
892 * Find some p such that f(p) = fval; return 1/p [RFC 3448, 6.3.1].
894 if (rtt == 0) { /* would result in divide-by-zero */
895 DCCP_WARN("RTT==0\n");
899 dccp_timestamp(sk, &tstamp);
900 delta = timeval_delta(&tstamp, last_feedback);
901 DCCP_BUG_ON(delta <= 0);
903 x_recv = scaled_div32(bytes_recv, delta);
904 if (x_recv == 0) { /* would also trigger divide-by-zero */
905 DCCP_WARN("X_recv==0\n");
906 if (previous_x_recv == 0) {
907 DCCP_BUG("stored value of X_recv is zero");
910 x_recv = previous_x_recv;
913 fval = scaled_div(s, rtt);
914 fval = scaled_div32(fval, x_recv);
915 p = tfrc_calc_x_reverse_lookup(fval);
917 ccid3_pr_debug("%s(%p), receive rate=%u bytes/s, implied "
918 "loss rate=%u\n", dccp_role(sk), sk, x_recv, p);
926 static void ccid3_hc_rx_update_li(struct sock *sk,
927 struct list_head *li_hist_list,
928 struct list_head *hist_list,
929 struct timeval *last_feedback,
930 u16 s, u32 bytes_recv,
932 u64 seq_loss, u8 win_loss)
934 struct dccp_li_hist_entry *head;
937 if (list_empty(li_hist_list)) {
938 if (!dccp_li_hist_interval_new(ccid3_li_hist,
939 li_hist_list, seq_loss,
943 head = list_entry(li_hist_list->next, struct dccp_li_hist_entry,
945 head->dccplih_interval =
946 ccid3_hc_rx_calc_first_li(sk, hist_list,
951 struct dccp_li_hist_entry *entry;
952 struct list_head *tail;
954 head = list_entry(li_hist_list->next, struct dccp_li_hist_entry,
956 /* FIXME win count check removed as was wrong */
957 /* should make this check with receive history */
958 /* and compare there as per section 10.2 of RFC4342 */
960 /* new loss event detected */
961 /* calculate last interval length */
962 seq_temp = dccp_delta_seqno(head->dccplih_seqno, seq_loss);
963 entry = dccp_li_hist_entry_new(ccid3_li_hist, GFP_ATOMIC);
966 DCCP_BUG("out of memory - can not allocate entry");
970 list_add(&entry->dccplih_node, li_hist_list);
972 tail = li_hist_list->prev;
974 kmem_cache_free(ccid3_li_hist->dccplih_slab, tail);
976 /* Create the newest interval */
977 entry->dccplih_seqno = seq_loss;
978 entry->dccplih_interval = seq_temp;
979 entry->dccplih_win_count = win_loss;
983 static int ccid3_hc_rx_detect_loss(struct sock *sk,
984 struct dccp_rx_hist_entry *packet)
986 struct ccid3_hc_rx_sock *hcrx = ccid3_hc_rx_sk(sk);
987 struct dccp_rx_hist_entry *rx_hist =
988 dccp_rx_hist_head(&hcrx->ccid3hcrx_hist);
989 u64 seqno = packet->dccphrx_seqno;
995 tmp_seqno = hcrx->ccid3hcrx_seqno_nonloss;
998 follows48(packet->dccphrx_seqno, hcrx->ccid3hcrx_seqno_nonloss)) {
999 hcrx->ccid3hcrx_seqno_nonloss = seqno;
1000 hcrx->ccid3hcrx_ccval_nonloss = packet->dccphrx_ccval;
1005 while (dccp_delta_seqno(hcrx->ccid3hcrx_seqno_nonloss, seqno)
1006 > TFRC_RECV_NUM_LATE_LOSS) {
1008 ccid3_hc_rx_update_li(sk,
1009 &hcrx->ccid3hcrx_li_hist,
1010 &hcrx->ccid3hcrx_hist,
1011 &hcrx->ccid3hcrx_tstamp_last_feedback,
1013 hcrx->ccid3hcrx_bytes_recv,
1014 hcrx->ccid3hcrx_x_recv,
1015 hcrx->ccid3hcrx_seqno_nonloss,
1016 hcrx->ccid3hcrx_ccval_nonloss);
1017 tmp_seqno = hcrx->ccid3hcrx_seqno_nonloss;
1018 dccp_inc_seqno(&tmp_seqno);
1019 hcrx->ccid3hcrx_seqno_nonloss = tmp_seqno;
1020 dccp_inc_seqno(&tmp_seqno);
1021 while (dccp_rx_hist_find_entry(&hcrx->ccid3hcrx_hist,
1022 tmp_seqno, &ccval)) {
1023 hcrx->ccid3hcrx_seqno_nonloss = tmp_seqno;
1024 hcrx->ccid3hcrx_ccval_nonloss = ccval;
1025 dccp_inc_seqno(&tmp_seqno);
1029 /* FIXME - this code could be simplified with above while */
1030 /* but works at moment */
1031 if (follows48(packet->dccphrx_seqno, hcrx->ccid3hcrx_seqno_nonloss)) {
1032 hcrx->ccid3hcrx_seqno_nonloss = seqno;
1033 hcrx->ccid3hcrx_ccval_nonloss = packet->dccphrx_ccval;
1037 dccp_rx_hist_add_packet(ccid3_rx_hist, &hcrx->ccid3hcrx_hist,
1038 &hcrx->ccid3hcrx_li_hist, packet,
1039 hcrx->ccid3hcrx_seqno_nonloss);
1043 static void ccid3_hc_rx_packet_recv(struct sock *sk, struct sk_buff *skb)
1045 struct ccid3_hc_rx_sock *hcrx = ccid3_hc_rx_sk(sk);
1046 const struct dccp_options_received *opt_recv;
1047 struct dccp_rx_hist_entry *packet;
1049 u32 p_prev, r_sample, rtt_prev;
1050 int loss, payload_size;
1052 BUG_ON(hcrx == NULL);
1054 opt_recv = &dccp_sk(sk)->dccps_options_received;
1056 switch (DCCP_SKB_CB(skb)->dccpd_type) {
1058 if (hcrx->ccid3hcrx_state == TFRC_RSTATE_NO_DATA)
1060 case DCCP_PKT_DATAACK:
1061 if (opt_recv->dccpor_timestamp_echo == 0)
1063 rtt_prev = hcrx->ccid3hcrx_rtt;
1064 dccp_timestamp(sk, &now);
1065 r_sample = dccp_sample_rtt(sk, &now, NULL);
1067 if (hcrx->ccid3hcrx_state == TFRC_RSTATE_NO_DATA)
1068 hcrx->ccid3hcrx_rtt = r_sample;
1070 hcrx->ccid3hcrx_rtt = (hcrx->ccid3hcrx_rtt * 9) / 10 +
1073 if (rtt_prev != hcrx->ccid3hcrx_rtt)
1074 ccid3_pr_debug("%s(%p), New RTT=%uus, elapsed time=%u\n",
1075 dccp_role(sk), sk, hcrx->ccid3hcrx_rtt,
1076 opt_recv->dccpor_elapsed_time);
1080 default: /* We're not interested in other packet types, move along */
1084 packet = dccp_rx_hist_entry_new(ccid3_rx_hist, sk, opt_recv->dccpor_ndp,
1086 if (unlikely(packet == NULL)) {
1087 DCCP_WARN("%s(%p), Not enough mem to add rx packet "
1088 "to history, consider it lost!\n", dccp_role(sk), sk);
1092 loss = ccid3_hc_rx_detect_loss(sk, packet);
1094 if (DCCP_SKB_CB(skb)->dccpd_type == DCCP_PKT_ACK)
1097 payload_size = skb->len - dccp_hdr(skb)->dccph_doff * 4;
1098 ccid3_hc_rx_update_s(hcrx, payload_size);
1100 switch (hcrx->ccid3hcrx_state) {
1101 case TFRC_RSTATE_NO_DATA:
1102 ccid3_pr_debug("%s(%p, state=%s), skb=%p, sending initial "
1103 "feedback\n", dccp_role(sk), sk,
1104 dccp_state_name(sk->sk_state), skb);
1105 ccid3_hc_rx_send_feedback(sk);
1106 ccid3_hc_rx_set_state(sk, TFRC_RSTATE_DATA);
1108 case TFRC_RSTATE_DATA:
1109 hcrx->ccid3hcrx_bytes_recv += payload_size;
1113 dccp_timestamp(sk, &now);
1114 if ((timeval_delta(&now, &hcrx->ccid3hcrx_tstamp_last_ack) -
1115 (suseconds_t)hcrx->ccid3hcrx_rtt) >= 0) {
1116 hcrx->ccid3hcrx_tstamp_last_ack = now;
1117 ccid3_hc_rx_send_feedback(sk);
1120 case TFRC_RSTATE_TERM:
1121 DCCP_BUG("%s(%p) - Illegal state TERM", dccp_role(sk), sk);
1125 /* Dealing with packet loss */
1126 ccid3_pr_debug("%s(%p, state=%s), data loss! Reacting...\n",
1127 dccp_role(sk), sk, dccp_state_name(sk->sk_state));
1129 p_prev = hcrx->ccid3hcrx_p;
1131 /* Calculate loss event rate */
1132 if (!list_empty(&hcrx->ccid3hcrx_li_hist)) {
1133 u32 i_mean = dccp_li_hist_calc_i_mean(&hcrx->ccid3hcrx_li_hist);
1135 /* Scaling up by 1000000 as fixed decimal */
1137 hcrx->ccid3hcrx_p = 1000000 / i_mean;
1139 DCCP_BUG("empty loss history");
1141 if (hcrx->ccid3hcrx_p > p_prev) {
1142 ccid3_hc_rx_send_feedback(sk);
1147 static int ccid3_hc_rx_init(struct ccid *ccid, struct sock *sk)
1149 struct ccid3_hc_rx_sock *hcrx = ccid_priv(ccid);
1151 ccid3_pr_debug("entry\n");
1153 hcrx->ccid3hcrx_state = TFRC_RSTATE_NO_DATA;
1154 INIT_LIST_HEAD(&hcrx->ccid3hcrx_hist);
1155 INIT_LIST_HEAD(&hcrx->ccid3hcrx_li_hist);
1156 dccp_timestamp(sk, &hcrx->ccid3hcrx_tstamp_last_ack);
1157 hcrx->ccid3hcrx_tstamp_last_feedback = hcrx->ccid3hcrx_tstamp_last_ack;
1158 hcrx->ccid3hcrx_s = 0;
1159 hcrx->ccid3hcrx_rtt = 0;
1163 static void ccid3_hc_rx_exit(struct sock *sk)
1165 struct ccid3_hc_rx_sock *hcrx = ccid3_hc_rx_sk(sk);
1167 BUG_ON(hcrx == NULL);
1169 ccid3_hc_rx_set_state(sk, TFRC_RSTATE_TERM);
1171 /* Empty packet history */
1172 dccp_rx_hist_purge(ccid3_rx_hist, &hcrx->ccid3hcrx_hist);
1174 /* Empty loss interval history */
1175 dccp_li_hist_purge(ccid3_li_hist, &hcrx->ccid3hcrx_li_hist);
1178 static void ccid3_hc_rx_get_info(struct sock *sk, struct tcp_info *info)
1180 const struct ccid3_hc_rx_sock *hcrx = ccid3_hc_rx_sk(sk);
1182 /* Listen socks doesn't have a private CCID block */
1183 if (sk->sk_state == DCCP_LISTEN)
1186 BUG_ON(hcrx == NULL);
1188 info->tcpi_ca_state = hcrx->ccid3hcrx_state;
1189 info->tcpi_options |= TCPI_OPT_TIMESTAMPS;
1190 info->tcpi_rcv_rtt = hcrx->ccid3hcrx_rtt;
1193 static int ccid3_hc_rx_getsockopt(struct sock *sk, const int optname, int len,
1194 u32 __user *optval, int __user *optlen)
1196 const struct ccid3_hc_rx_sock *hcrx = ccid3_hc_rx_sk(sk);
1199 /* Listen socks doesn't have a private CCID block */
1200 if (sk->sk_state == DCCP_LISTEN)
1204 case DCCP_SOCKOPT_CCID_RX_INFO:
1205 if (len < sizeof(hcrx->ccid3hcrx_tfrc))
1207 len = sizeof(hcrx->ccid3hcrx_tfrc);
1208 val = &hcrx->ccid3hcrx_tfrc;
1211 return -ENOPROTOOPT;
1214 if (put_user(len, optlen) || copy_to_user(optval, val, len))
1220 static struct ccid_operations ccid3 = {
1221 .ccid_id = DCCPC_CCID3,
1222 .ccid_name = "ccid3",
1223 .ccid_owner = THIS_MODULE,
1224 .ccid_hc_tx_obj_size = sizeof(struct ccid3_hc_tx_sock),
1225 .ccid_hc_tx_init = ccid3_hc_tx_init,
1226 .ccid_hc_tx_exit = ccid3_hc_tx_exit,
1227 .ccid_hc_tx_send_packet = ccid3_hc_tx_send_packet,
1228 .ccid_hc_tx_packet_sent = ccid3_hc_tx_packet_sent,
1229 .ccid_hc_tx_packet_recv = ccid3_hc_tx_packet_recv,
1230 .ccid_hc_tx_parse_options = ccid3_hc_tx_parse_options,
1231 .ccid_hc_rx_obj_size = sizeof(struct ccid3_hc_rx_sock),
1232 .ccid_hc_rx_init = ccid3_hc_rx_init,
1233 .ccid_hc_rx_exit = ccid3_hc_rx_exit,
1234 .ccid_hc_rx_insert_options = ccid3_hc_rx_insert_options,
1235 .ccid_hc_rx_packet_recv = ccid3_hc_rx_packet_recv,
1236 .ccid_hc_rx_get_info = ccid3_hc_rx_get_info,
1237 .ccid_hc_tx_get_info = ccid3_hc_tx_get_info,
1238 .ccid_hc_rx_getsockopt = ccid3_hc_rx_getsockopt,
1239 .ccid_hc_tx_getsockopt = ccid3_hc_tx_getsockopt,
1242 #ifdef CONFIG_IP_DCCP_CCID3_DEBUG
1243 module_param(ccid3_debug, int, 0444);
1244 MODULE_PARM_DESC(ccid3_debug, "Enable debug messages");
1247 static __init int ccid3_module_init(void)
1251 ccid3_rx_hist = dccp_rx_hist_new("ccid3");
1252 if (ccid3_rx_hist == NULL)
1255 ccid3_tx_hist = dccp_tx_hist_new("ccid3");
1256 if (ccid3_tx_hist == NULL)
1259 ccid3_li_hist = dccp_li_hist_new("ccid3");
1260 if (ccid3_li_hist == NULL)
1263 rc = ccid_register(&ccid3);
1265 goto out_free_loss_interval_history;
1269 out_free_loss_interval_history:
1270 dccp_li_hist_delete(ccid3_li_hist);
1271 ccid3_li_hist = NULL;
1273 dccp_tx_hist_delete(ccid3_tx_hist);
1274 ccid3_tx_hist = NULL;
1276 dccp_rx_hist_delete(ccid3_rx_hist);
1277 ccid3_rx_hist = NULL;
1280 module_init(ccid3_module_init);
1282 static __exit void ccid3_module_exit(void)
1284 ccid_unregister(&ccid3);
1286 if (ccid3_tx_hist != NULL) {
1287 dccp_tx_hist_delete(ccid3_tx_hist);
1288 ccid3_tx_hist = NULL;
1290 if (ccid3_rx_hist != NULL) {
1291 dccp_rx_hist_delete(ccid3_rx_hist);
1292 ccid3_rx_hist = NULL;
1294 if (ccid3_li_hist != NULL) {
1295 dccp_li_hist_delete(ccid3_li_hist);
1296 ccid3_li_hist = NULL;
1299 module_exit(ccid3_module_exit);
1301 MODULE_AUTHOR("Ian McDonald <ian.mcdonald@jandi.co.nz>, "
1302 "Arnaldo Carvalho de Melo <acme@ghostprotocols.net>");
1303 MODULE_DESCRIPTION("DCCP TFRC CCID3 CCID");
1304 MODULE_LICENSE("GPL");
1305 MODULE_ALIAS("net-dccp-ccid-3");