Struct NsupdateExecutor 

pub struct NsupdateExecutor { /* private fields */ }

nsupdate command executor

Manages dynamic DNS updates via the nsupdate command-line tool. Supports TSIG authentication for secure updates.

Implementations

impl NsupdateExecutor

pub fn new( server: String, port: u16, tsig_key_name: Option<String>, tsig_algorithm: Option<String>, tsig_secret: Option<String>, ) -> Result<Self>

Create a new nsupdate executor

Arguments

• server - DNS server address (e.g., “127.0.0.1”)
• port - DNS server port (typically 53)
• tsig_key_name - Optional TSIG key name
• tsig_algorithm - Optional TSIG algorithm
• tsig_secret - Optional TSIG secret (base64-encoded)

Example

use bindcar::nsupdate::NsupdateExecutor;

let executor = NsupdateExecutor::new(
    "127.0.0.1".to_string(),
    53,
    Some("update-key".to_string()),
    Some("HMAC-SHA256".to_string()),
    Some("dGVzdC1zZWNyZXQ=".to_string()),
)?;

pub async fn add_record( &self, zone: &str, name: &str, ttl: u32, record_type: &str, value: &str, ) -> Result<String>

Add a DNS record

Arguments

• zone - Zone name (e.g., “example.com”)
• name - Record name (FQDN, e.g., “www.example.com.”)
• ttl - Time-to-live in seconds
• record_type - Record type (e.g., “A”, “AAAA”, “CNAME”)
• value - Record value (e.g., “192.0.2.1”)

Example

executor.add_record(
    "example.com",
    "www.example.com.",
    3600,
    "A",
    "192.0.2.1"
).await?;

pub async fn remove_record( &self, zone: &str, name: &str, record_type: &str, value: &str, ) -> Result<String>

Remove a DNS record

Arguments

• zone - Zone name (e.g., “example.com”)
• name - Record name (FQDN, e.g., “www.example.com.”)
• record_type - Record type (e.g., “A”)
• value - Record value to remove (e.g., “192.0.2.1”). If empty, removes all records of this type.

Example

// Remove specific record
executor.remove_record(
    "example.com",
    "www.example.com.",
    "A",
    "192.0.2.1"
).await?;

// Remove all A records for www
executor.remove_record(
    "example.com",
    "www.example.com.",
    "A",
    ""
).await?;

pub async fn update_record( &self, zone: &str, name: &str, ttl: u32, record_type: &str, old_value: &str, new_value: &str, ) -> Result<String>

Update a DNS record (atomic delete + add)

Arguments

• zone - Zone name (e.g., “example.com”)
• name - Record name (FQDN, e.g., “www.example.com.”)
• ttl - New time-to-live in seconds
• record_type - Record type (e.g., “A”)
• old_value - Current record value (e.g., “192.0.2.1”)
• new_value - New record value (e.g., “192.0.2.2”)

Example

executor.update_record(
    "example.com",
    "www.example.com.",
    3600,
    "A",
    "192.0.2.1",
    "192.0.2.2"
).await?;

Trait Implementations

impl Clone for NsupdateExecutor

fn clone(&self) -> NsupdateExecutor

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.