Struct HostInfo 

pub struct HostInfo {
    pub machine_id: String,
    pub os_type: Option<String>,
    pub os_version: Option<String>,
    pub architecture: Option<String>,
    pub hostname: Option<String>,
    pub ip_address: Option<String>,
    pub agent_host_id: Option<Uuid>,
    pub features: Option<Vec<String>>,
}

Information about the host machine running the agent.

Fields

machine_id: String

Persistent machine identifier (e.g. /etc/machine-id on Linux, IOPlatformUUID on macOS).

Falls back to "unknown" if the identifier cannot be read.

os_type: Option<String>

Operating system type (e.g. “linux”, “macos”).

os_version: Option<String>

Operating system version (e.g. “Ubuntu 24.04 LTS”).

architecture: Option<String>

CPU architecture (e.g. “x86_64”, “aarch64”).

hostname: Option<String>

Hostname reported by the agent/host machine.

ip_address: Option<String>

Network address of the host (SSH target address for SSH agent hosts).

agent_host_id: Option<Uuid>

Agent-local UUID assigned to this host at bootstrap time.

When present, the controller uses this as hosts.id when creating a new row, ensuring agent and controller share the same UUID. This is required for plugin FK operations (e.g. Proxmox host mapping) that reference hosts.id before the controller has generated its own UUID.

features: Option<Vec<String>>

Agent-probed host features (e.g. ["posix_shell", "privilege_escalation", "systemd"]).

None for legacy agents that predate feature reporting. Uses Vec<String> (not BTreeSet<HostFeature>) on the wire for forward-compatibility: if a newer agent reports a feature the controller doesn’t know, it is stored losslessly and ignored by HostCapabilities parsing.

Trait Implementations

impl Clone for HostInfo

fn clone(&self) -> HostInfo

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for HostInfo

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for HostInfo

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Eq for HostInfo

impl PartialEq for HostInfo

fn eq(&self, other: &HostInfo) -> bool

Equality operator ==.

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=.

impl Serialize for HostInfo

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

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl StructuralPartialEq for HostInfo

impl WireValidate for HostInfo

fn wire_validate(&self) -> Result<(), WireValidationError>

Validate that all fields are within wire protocol size limits.