Struct SsClient 

pub struct SsClient { /* private fields */ }

Client for executing ss (socket statistics) commands

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

SS is a modern utility to investigate sockets and is the replacement for netstat. It’s faster and provides more detailed information about network connections.

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::SsClient;

let ss = SsClient::new();

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

Implementations

impl SsClient

pub fn new() -> Self

Create a new ss client

Example

use torrust_tracker_deployer_lib::adapters::network::SsClient;

let ss = SsClient::new();

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

List TCP listening ports with process information

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

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

Returns

The ss output as a string

Errors

Returns NetworkError::SsFailed if the command fails or ss is not installed

Example

let output = ss.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 SsClient

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

Formats the value using the given formatter.

impl Default for SsClient

fn default() -> Self

Returns the “default value” for a type.