Struct VpsRecord 

pub struct VpsRecord {

    pub name: String,
    pub host: String,
    pub port: u16,
    pub username: String,
    pub password: SecretString,
    pub key_path: Option<String>,
    pub key_passphrase: Option<SecretString>,
    pub timeout_ms: u64,
    pub max_command_chars: usize,
    pub max_output_chars: usize,
    pub sudo_password: Option<SecretString>,
    pub su_password: Option<SecretString>,
    pub disable_sudo: bool,
    pub schema_version: u32,
    pub added_at: String,
}

VPS host record in the configuration file.

Wire format (serialize): English field names. Legacy Portuguese keys remain readable via serde(alias = …) (GAP-AUD-20260717-001/002/021).

Fields

name: String

Logical unique VPS name.

host: String

Server hostname or IP.

port: u16

SSH port.

username: String

SSH username.

password: SecretString

SSH password (empty when key-only auth).

key_path: Option<String>

Absolute or expandable OpenSSH private key path.

key_passphrase: Option<SecretString>

Private key passphrase (optional).

timeout_ms: u64

Timeout in milliseconds.

max_command_chars: usize

Command character limit (input). 0 = unlimited at runtime.

max_output_chars: usize

Stdout/stderr character limit. Accepts legacy alias max_chars.

sudo_password: Option<SecretString>

Password for sudo (optional).

su_password: Option<SecretString>

Password for su - (optional).

disable_sudo: bool

If true, sudo-exec and su-exec are rejected for this host.

schema_version: u32

Schema version for this record.

added_at: String

RFC 3339 inclusion timestamp.

Implementations

impl VpsRecord

pub fn new( name: String, host: String, port: u16, username: String, password: SecretString, key_path: Option<String>, key_passphrase: Option<SecretString>, timeout_ms: Option<u64>, max_command_chars: Option<usize>, max_output_chars: Option<usize>, sudo_password: Option<SecretString>, su_password: Option<SecretString>, disable_sudo: bool, ) -> Self

Creates a new record applying defaults.

pub fn has_password(&self) -> bool

Returns true if there is a non-empty password.

pub fn has_key(&self) -> bool

Returns true if there is a private key path.

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

Validates that at least one authentication method exists.

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

Full record validation at the write boundary (add/edit/import).

Ensures port ∈ 1..=65535, non-empty host/user, and credentials present. Does not check that key_path exists on the filesystem (dispatcher does).

pub fn normalize_schema(&mut self)

Normalizes schema after deserialization (v1 → v2 migration).

Trait Implementations

impl Clone for VpsRecord

fn clone(&self) -> VpsRecord

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for VpsRecord

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for VpsRecord

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for VpsRecord

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.