cc_sim

A discrete-event simulator that allows for rapid prototyping of congestion control algorithms.

Execution

cargo run --release -- path-to-config-file

Release mode is preferred because of its faster execution speed.

Creating Config Files

Our suggestion is to directly create a YAML file following example_config.yaml.
Another option is to create a config file within Rust. For example, example_config.yaml can be created by:

use config::{
    CCConfig, Config, ConfigLog, ConfigTopo, DelayConfig, LinkTraceConfig, LogType,
    SenderGroupConfig,
};
use simulator::Time;
use base::BufferSize;

fn main() {
    // Four variants of links to choose from
    let _c_link_trace = LinkTraceConfig::Const(1_500_000.);
    let _r_link_trace = LinkTraceConfig::Random(RandomVariable {
        dist: CustomDistribution::Poisson(1_000_000.),
        offset: 14_000_000.,
    });
    let _p_link_trace = LinkTraceConfig::Piecewise(vec![
        (1_500_000., Time::from_secs(20)),
        (15_000_000., Time::from_secs(20)),
    ]);
    let _m_link_trace = LinkTraceConfig::MahimahiFile("traces/TMobile-LTE-driving.up".to_string());
    
    // Configure senders
    let mut sender_groups = Vec::new();
    for i in 0..2 {
        sender_groups.push(SenderGroupConfig {
            num_senders: 1,
            delay: DelayConfig::Const(Time::from_millis(50)),
            cc: CCConfig::AIMD,
            start_time: Time::from_secs(i * 2),
            tx_length: TcpSenderTxLength::Infinite,
        });
    }
    
    // Create configuration
    let config = Config {
        pkt_size: 1500,
        sim_dur: Some(Time::from_secs(100)),
        topo: ConfigTopo {
            link: _r_link_trace,
            bufsize: BufferSize::Finite(100),
            sender_groups,
        },
        log: ConfigLog {
            out_terminal: "png".to_string(),
            out_file: "out.png".to_string(),
            cwnd: LogType::Plot,
            rtt: LogType::Plot,
            sender_losses: LogType::Ignore,
            timeouts: LogType::Ignore,
            link_rates: LogType::Plot,
            link_bucket_size: Time::from_micros(1_000_000),
        },
        random_seed: 0,
    };
    
    let config_str = serde_yaml::to_string(&config)?;
    std::fs::write("config.yaml", config_str).expect("Unable to write to YAML config file.");
}