Struct NetstatClient 

pub struct NetstatClient { /* private fields */ }

Client for executing netstat commands

This client wraps netstat CLI operations using our CommandExecutor collaborator, enabling testability and consistency with other external tool clients.

Netstat is a command-line tool that displays network connections, routing tables, interface statistics, masquerade connections, and multicast memberships.

Architecture

The client uses CommandExecutor as a collaborator for actual command execution, following the same pattern as other adapters in this crate.

Example

use torrust_tracker_deployer_lib::adapters::network::NetstatClient;

let netstat = NetstatClient::new();

// List all TCP listening ports with process information
let output = netstat.list_tcp_listening_ports()?;
println!("Listening ports:\n{}", output);

Implementations

impl NetstatClient

pub fn new() -> Self

Create a new netstat client

Example

use torrust_tracker_deployer_lib::adapters::network::NetstatClient;

let netstat = NetstatClient::new();

pub fn list_tcp_listening_ports(&self) -> Result<String, NetworkError>

List TCP listening ports with process information

Executes netstat -tlnp to list all TCP listening sockets with:

• -t: TCP connections only
• -l: Listening sockets only
• -n: Numeric addresses (no DNS resolution)
• -p: Show process ID and name (may require root)

Returns

The netstat output as a string

Errors

Returns NetworkError::NetstatFailed if the command fails or netstat is not installed

Example

let output = netstat.list_tcp_listening_ports()?;

// Parse output to find specific ports
for line in output.lines() {
    if line.contains(":8080") {
        println!("Port 8080 is in use: {}", line);
    }
}

Trait Implementations

impl Debug for NetstatClient

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Default for NetstatClient

fn default() -> Self

Returns the “default value” for a type.