quiche/recovery/congestion/bbr/
init.rs

1// Copyright (C) 2022, Cloudflare, Inc.
2// All rights reserved.
3//
4// Redistribution and use in source and binary forms, with or without
5// modification, are permitted provided that the following conditions are
6// met:
7//
8//     * Redistributions of source code must retain the above copyright notice,
9//       this list of conditions and the following disclaimer.
10//
11//     * Redistributions in binary form must reproduce the above copyright
12//       notice, this list of conditions and the following disclaimer in the
13//       documentation and/or other materials provided with the distribution.
14//
15// THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS
16// IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO,
17// THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
18// PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR
19// CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL,
20// EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO,
21// PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR
22// PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF
23// LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING
24// NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
25// SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
26
27use super::*;
28
29use std::time::Instant;
30
31// BBR Functions at Initialization.
32//
33
34// 4.3.1.  Initialization Steps
35pub fn bbr_init(r: &mut Congestion) {
36    let bbr = &mut r.bbr_state;
37
38    bbr.rtprop = r.initial_rtt;
39    bbr.rtprop_stamp = Instant::now();
40    bbr.next_round_delivered = r.delivery_rate.delivered();
41
42    r.send_quantum = r.max_datagram_size;
43
44    bbr_init_round_counting(r);
45    bbr_init_full_pipe(r);
46    bbr_init_pacing_rate(r);
47    bbr_enter_startup(r);
48}
49
50// 4.1.1.3.  Tracking Time for the BBR.BtlBw Max Filter
51fn bbr_init_round_counting(r: &mut Congestion) {
52    let bbr = &mut r.bbr_state;
53
54    bbr.next_round_delivered = 0;
55    bbr.round_start = false;
56    bbr.round_count = 0;
57}
58
59// 4.2.1.  Pacing Rate
60fn bbr_init_pacing_rate(r: &mut Congestion) {
61    let bbr = &mut r.bbr_state;
62
63    let srtt = r.initial_rtt.as_secs_f64();
64
65    // At init, cwnd is initcwnd.
66    let nominal_bandwidth = r.congestion_window as f64 / srtt;
67
68    bbr.pacing_rate = (bbr.pacing_gain * nominal_bandwidth) as u64;
69}
70
71// 4.3.2.1.  Startup Dynamics
72pub fn bbr_enter_startup(r: &mut Congestion) {
73    let bbr = &mut r.bbr_state;
74
75    bbr.state = BBRStateMachine::Startup;
76    bbr.pacing_gain = BBR_HIGH_GAIN;
77    bbr.cwnd_gain = BBR_HIGH_GAIN;
78}
79
80// 4.3.2.2.  Estimating When Startup has Filled the Pipe
81fn bbr_init_full_pipe(r: &mut Congestion) {
82    let bbr = &mut r.bbr_state;
83
84    bbr.filled_pipe = false;
85    bbr.full_bw = 0;
86    bbr.full_bw_count = 0;
87}