aria2-core 0.3.3

aria2-rust core download engine: multi-protocol segmented downloads, rate limiting, configuration, session persistence, and BitTorrent seeding
Documentation
//! Network general options: interface binding, DNS, event poll, server statistics.

use crate::config::{OptionCategory, OptionDef, OptionType, OptionValue};

impl crate::config::OptionRegistry {
    /// Register network-related general options: interfaces, DNS, event poll, server stats.
    pub(super) fn register_general_network_options(&mut self) {
        // --- Network Identity ---
        self.register(OptionDef {
            name: "interface".into(),
            opt_type: OptionType::String,
            default_value: OptionValue::None,
            description: "Network interface to bind to".into(),
            category: OptionCategory::General,
            supported: false,
            ..Default::default()
        });
        self.register(OptionDef {
            name: "multiple-interface".into(),
            opt_type: OptionType::String,
            default_value: OptionValue::None,
            description: "Comma-separated list of interfaces for multi-homed setups".into(),
            category: OptionCategory::General,
            supported: false,
            ..Default::default()
        });

        // --- DNS & Async DNS ---
        self.register(OptionDef {
            name: "async-dns".into(),
            opt_type: OptionType::Boolean,
            default_value: OptionValue::Bool(true),
            description: "Enable asynchronous DNS resolution".into(),
            category: OptionCategory::General,
            ..Default::default()
        });
        self.register(OptionDef {
            name: "async-dns-server".into(),
            opt_type: OptionType::String,
            default_value: OptionValue::None,
            description: "DNS server address for async resolver".into(),
            category: OptionCategory::General,
            supported: false,
            ..Default::default()
        });
        self.register(OptionDef {
            name: "dns-timeout".into(),
            opt_type: OptionType::Integer,
            default_value: OptionValue::None,
            min: Some(1),
            max: Some(60),
            description: "DNS resolution timeout in seconds".into(),
            category: OptionCategory::General,
            hidden: true,
            supported: false,
            ..Default::default()
        });
        self.register(OptionDef {
            name: "enable-async-dns6".into(),
            opt_type: OptionType::Boolean,
            // `OptionHandlerFactory.cc` uses `NO_DEFAULT_VALUE`, so the
            // option is absent from `getGlobalOption` until explicitly set.
            default_value: OptionValue::None,
            description: "Enable IPv6 async DNS resolution (deprecated)".into(),
            category: OptionCategory::General,
            deprecated: true,
            supported: false,
            ..Default::default()
        });

        // --- Network / Event Poll ---
        self.register(OptionDef {
            name: "event-poll".into(),
            opt_type: OptionType::Enum,
            default_value: OptionValue::None,
            allowed_values: &["epoll", "kqueue", "port", "libuv", "poll", "select"],
            description: "Event poll method (epoll/kqueue/port/poll/select)".into(),
            category: OptionCategory::General,
            supported: false,
            ..Default::default()
        });

        // --- Server Statistics ---
        self.register(OptionDef {
            name: "server-stat-timeout".into(),
            opt_type: OptionType::Integer,
            default_value: OptionValue::Int(86400),
            min: Some(0),
            description: "Server stat timeout in seconds (0=unlimited)".into(),
            category: OptionCategory::General,
            ..Default::default()
        });
        self.register(OptionDef {
            name: "server-stat-if".into(),
            opt_type: OptionType::Path,
            description: "Server performance statistics input file".into(),
            category: OptionCategory::General,
            ..Default::default()
        });
        self.register(OptionDef {
            name: "server-stat-of".into(),
            opt_type: OptionType::Path,
            description: "Server performance statistics output file".into(),
            category: OptionCategory::General,
            ..Default::default()
        });
    }
}