From: Stefan Hanreich <s.hanreich@proxmox.com>
To: pve-devel@lists.proxmox.com
Subject: [pve-devel] [PATCH proxmox-perl-rs 10/10] pve-rs: fabrics: add function to get the neighbors for a fabric
Date: Thu, 30 Oct 2025 16:48:25 +0100	[thread overview]
Message-ID: <20251030154851.540408-19-s.hanreich@proxmox.com> (raw)
In-Reply-To: <20251030154851.540408-1-s.hanreich@proxmox.com>
From: Gabriel Goller <g.goller@proxmox.com>
Add a function that takes a fabricId and returns all routing protocol
neighbors (OpenFabric or OSPF) identified by FRR. For OpenFabric, the
fabric name is used as the area identifier, so we can filter easily. For
OSPF, the fabric configuration is read/parsed to extract interfaces,
which are then matched against the FRR neighbor output. The fabric
configuration is always read first to verify that a fabric exists before
querying FRR, as configuration parsing is (probably) faster than vtysh
execution.
Signed-off-by: Gabriel Goller <g.goller@proxmox.com>
Signed-off-by: Stefan Hanreich <s.hanreich@proxmox.com>
---
 pve-rs/src/bindings/sdn/fabrics.rs |  49 +++++++++++
 pve-rs/src/sdn/status.rs           | 131 +++++++++++++++++++++++++++++
 2 files changed, 180 insertions(+)
diff --git a/pve-rs/src/bindings/sdn/fabrics.rs b/pve-rs/src/bindings/sdn/fabrics.rs
index 150b7fa..5230aa3 100644
--- a/pve-rs/src/bindings/sdn/fabrics.rs
+++ b/pve-rs/src/bindings/sdn/fabrics.rs
@@ -666,6 +666,55 @@ pub mod pve_rs_sdn_fabrics {
         }
     }
 
+    /// Get the neighbors for this specific fabric on this node
+    ///
+    /// Read and parse the fabric config to get the fabric protocol and the interfaces (ospf).
+    /// Parse the frr output of the neighbor commands and return a common format.
+    #[export]
+    fn neighbors(fabric_id: FabricId) -> Result<status::NeighborStatus, Error> {
+        // Read fabric config to get protocol of fabric
+        let config = get_fabrics_config()?;
+
+        let fabric = config.get_fabric(&fabric_id)?;
+
+        match fabric {
+            FabricEntry::Openfabric(_) => {
+                let openfabric_neighbors_string = String::from_utf8(
+                    Command::new("sh")
+                        .args(["-c", "vtysh -c 'show openfabric neighbor detail json'"])
+                        .output()?
+                        .stdout,
+                )?;
+                let openfabric_neighbors: proxmox_frr::de::openfabric::Neighbors =
+                    if openfabric_neighbors_string.is_empty() {
+                        proxmox_frr::de::openfabric::Neighbors::default()
+                    } else {
+                        serde_json::from_str(&openfabric_neighbors_string)
+                            .with_context(|| "error parsing openfabric neighbors")?
+                    };
+
+                status::get_neighbors_openfabric(fabric_id, openfabric_neighbors).map(|v| v.into())
+            }
+            FabricEntry::Ospf(fabric) => {
+                let ospf_neighbors_string = String::from_utf8(
+                    Command::new("sh")
+                        .args(["-c", "vtysh -c 'show ip ospf neighbor json'"])
+                        .output()?
+                        .stdout,
+                )?;
+                let ospf_neighbors: proxmox_frr::de::ospf::Neighbors =
+                    if ospf_neighbors_string.is_empty() {
+                        proxmox_frr::de::ospf::Neighbors::default()
+                    } else {
+                        serde_json::from_str(&ospf_neighbors_string)
+                            .with_context(|| "error parsing ospf neighbors")?
+                    };
+
+                status::get_neighbors_ospf(fabric_id, fabric, ospf_neighbors).map(|v| v.into())
+            }
+        }
+    }
+
     /// Get the interfaces for this specific fabric on this node
     ///
     /// Read and parse the fabric config to get the protocol of the fabric and retrieve the
diff --git a/pve-rs/src/sdn/status.rs b/pve-rs/src/sdn/status.rs
index 450bb6c..881fb2d 100644
--- a/pve-rs/src/sdn/status.rs
+++ b/pve-rs/src/sdn/status.rs
@@ -31,6 +31,16 @@ mod ospf {
     use proxmox_frr::de;
     use serde::Serialize;
 
+    /// The status of a neighbor.
+    ///
+    /// Contains the neighbor name and the neighbor status.
+    #[derive(Debug, Serialize)]
+    pub struct NeighborStatus {
+        pub neighbor: String,
+        pub status: String,
+        pub uptime: String,
+    }
+
     /// The status of a fabric interface
     ///
     /// Contains the interface name, the interface state (so if the interface is up/down) and the type
@@ -47,6 +57,16 @@ mod openfabric {
     use proxmox_frr::de;
     use serde::Serialize;
 
+    /// The status of a neighbor.
+    ///
+    /// Contains the neighbor name and the neighbor status.
+    #[derive(Debug, Serialize)]
+    pub struct NeighborStatus {
+        pub neighbor: String,
+        pub status: de::openfabric::AdjacencyState,
+        pub uptime: String,
+    }
+
     /// The status of a fabric interface
     ///
     /// Contains the interface name, the interface state (so if the interface is up/down) and the type
@@ -60,6 +80,25 @@ mod openfabric {
     }
 }
 
+/// Common NeighborStatus that contains either OSPF or Openfabric neighbors
+#[derive(Debug, Serialize)]
+#[serde(untagged)]
+pub enum NeighborStatus {
+    Openfabric(Vec<openfabric::NeighborStatus>),
+    Ospf(Vec<ospf::NeighborStatus>),
+}
+
+impl From<Vec<openfabric::NeighborStatus>> for NeighborStatus {
+    fn from(value: Vec<openfabric::NeighborStatus>) -> Self {
+        NeighborStatus::Openfabric(value)
+    }
+}
+impl From<Vec<ospf::NeighborStatus>> for NeighborStatus {
+    fn from(value: Vec<ospf::NeighborStatus>) -> Self {
+        NeighborStatus::Ospf(value)
+    }
+}
+
 /// Common InterfaceStatus that contains either OSPF or Openfabric interfaces
 #[derive(Debug, Serialize)]
 #[serde(untagged)]
@@ -230,6 +269,98 @@ pub fn get_routes(
     Ok(stats)
 }
 
+/// Convert the parsed openfabric neighbor neighbor information into a list of
+/// [`openfabric::NeighborStatus`].
+///
+/// OpenFabric uses the name of the fabric as an "area", so simply match that to the fabric_id.
+pub fn get_neighbors_openfabric(
+    fabric_id: FabricId,
+    neighbors: de::openfabric::Neighbors,
+) -> Result<Vec<openfabric::NeighborStatus>, anyhow::Error> {
+    let mut stats: Vec<openfabric::NeighborStatus> = Vec::new();
+
+    for area in &neighbors.areas {
+        if area.area != fabric_id.as_str() {
+            continue;
+        }
+        for circuit in &area.circuits {
+            let (Some(adj), Some(interface)) = (&circuit.adj, &circuit.interface) else {
+                continue;
+            };
+            let Some(state) = interface.state else {
+                continue;
+            };
+            stats.push(openfabric::NeighborStatus {
+                neighbor: adj.clone(),
+                status: state,
+                uptime: interface.last_ago.clone(),
+            });
+        }
+    }
+
+    Ok(stats)
+}
+
+/// Convert the parsed ospf neighbor neighbor information into a list of [`ospf::NeighborStatus`].
+///
+/// Ospf does not use the name of the fabric at all, so we again need to retrieve the interfaces of
+/// the fabric on this specific node and then match the neighbors to the fabric using the
+/// interfaces.
+pub fn get_neighbors_ospf(
+    fabric_id: FabricId,
+    fabric: &Entry<OspfProperties, OspfNodeProperties>,
+    neighbors: de::ospf::Neighbors,
+) -> Result<Vec<ospf::NeighborStatus>, anyhow::Error> {
+    let hostname = proxmox_sys::nodename();
+
+    let mut stats: Vec<ospf::NeighborStatus> = Vec::new();
+
+    if let Ok(node) = fabric.node_section(&NodeId::from_string(hostname.to_string())?) {
+        let mut interface_names: HashSet<&str> = node
+            .properties()
+            .interfaces()
+            .map(|i| i.name().as_str())
+            .collect();
+
+        let dummy_interface = format!("dummy_{}", fabric_id.as_str());
+        interface_names.insert(&dummy_interface);
+
+        for (neighbor_key, neighbor_list) in &neighbors.neighbors {
+            let mut has_matching_neighbor = false;
+            for neighbor in neighbor_list {
+                match neighbor.interface_name.split_once(":") {
+                    Some((interface_name, _)) => {
+                        if interface_names.contains(interface_name) {
+                            has_matching_neighbor = true;
+                            break;
+                        }
+                    }
+                    _ => {
+                        continue;
+                    }
+                }
+            }
+            if has_matching_neighbor {
+                let status = neighbor_list
+                    .first()
+                    .map(|n| n.neighbor_state.clone())
+                    .unwrap_or_default();
+                let uptime = neighbor_list
+                    .first()
+                    .map(|n| n.up_time.clone())
+                    .unwrap_or_default();
+                stats.push(ospf::NeighborStatus {
+                    neighbor: neighbor_key.clone(),
+                    status,
+                    uptime,
+                });
+            }
+        }
+    }
+
+    Ok(stats)
+}
+
 /// Conver the `show openfabric interface` output into a list of [`openfabric::InterfaceStatus`].
 ///
 /// Openfabric uses the name of the fabric as an "area", so simply match that to the fabric_id.
-- 
2.47.3
_______________________________________________
pve-devel mailing list
pve-devel@lists.proxmox.com
https://lists.proxmox.com/cgi-bin/mailman/listinfo/pve-devel
next prev parent reply	other threads:[~2025-10-30 15:59 UTC|newest]
Thread overview: 36+ messages / expand[flat|nested]  mbox.gz  Atom feed  top
2025-10-30 15:48 [pve-devel] [PATCH common/manager/network/proxmox{-ve-rs, -perl-rs} 00/35] Improve status reporting for SDN / networking Stefan Hanreich
2025-10-30 15:48 ` [pve-devel] [PATCH pve-common 1/2] iproute2: add helper for detecting bridge members Stefan Hanreich
2025-10-30 15:48 ` [pve-devel] [PATCH pve-common 2/2] iproute2: add helper for querying vlan information Stefan Hanreich
2025-10-30 15:48 ` [pve-devel] [PATCH proxmox-ve-rs 1/6] frr: make room for deserialization structs Stefan Hanreich
2025-10-30 15:48 ` [pve-devel] [PATCH proxmox-ve-rs 2/6] frr: add deserialization types for openfabric and ospf Stefan Hanreich
2025-10-30 15:48 ` [pve-devel] [PATCH proxmox-ve-rs 3/6] ve-config: add helper function to iterate over all nodes in all fabrics Stefan Hanreich
2025-10-30 15:48 ` [pve-devel] [PATCH proxmox-ve-rs 4/6] ve-config: add optional tag property to vnet Stefan Hanreich
2025-10-30 15:48 ` [pve-devel] [PATCH proxmox-ve-rs 5/6] frr: fix some route deserialization types Stefan Hanreich
2025-10-30 15:48 ` [pve-devel] [PATCH proxmox-ve-rs 6/6] frr: add deserialization types for EVPN Stefan Hanreich
2025-10-30 15:48 ` [pve-devel] [PATCH proxmox-perl-rs 01/10] pve-rs: firewall: cargo: fmt Stefan Hanreich
2025-10-30 15:48 ` [pve-devel] [PATCH proxmox-perl-rs 02/10] pve-rs: firewall: add missing documentation comments Stefan Hanreich
2025-10-30 15:48 ` [pve-devel] [PATCH proxmox-perl-rs 03/10] pve-rs: cargo: bump proxmox-apt and proxmox-ve-config versions Stefan Hanreich
2025-10-30 15:48 ` [pve-devel] [PATCH proxmox-perl-rs 04/10] pve-rs: fabrics: update proxmox-frr import path Stefan Hanreich
2025-10-30 15:48 ` [pve-devel] [PATCH proxmox-perl-rs 05/10] pve-rs: fabrics: fix clippy lint warnings Stefan Hanreich
2025-10-30 15:48 ` [pve-devel] [PATCH proxmox-perl-rs 06/10] pve-rs: fabrics: add function to get status of fabric Stefan Hanreich
2025-10-30 15:48 ` [pve-devel] [PATCH proxmox-perl-rs 07/10] pve-rs: fabrics: add function to get l2vpn and l3vpn routes for evpn Stefan Hanreich
2025-10-30 15:48 ` [pve-devel] [PATCH proxmox-perl-rs 08/10] pve-rs: fabrics: add function to get routes learned by a fabric Stefan Hanreich
2025-10-30 15:48 ` [pve-devel] [PATCH proxmox-perl-rs 09/10] pve-rs: fabrics: add function to get the interfaces used for " Stefan Hanreich
2025-10-30 15:48 ` Stefan Hanreich [this message]
2025-10-30 15:48 ` [pve-devel] [PATCH pve-network 1/9] refactor: rework api module structure for the /nodes/{node}/sdn subdir Stefan Hanreich
2025-10-30 15:48 ` [pve-devel] [PATCH pve-network 2/9] fabrics: add fabrics status to SDN::status function Stefan Hanreich
2025-10-30 15:48 ` [pve-devel] [PATCH pve-network 3/9] sdn: status: add zone type to sdn resource Stefan Hanreich
2025-10-30 15:48 ` [pve-devel] [PATCH pve-network 4/9] api: nodes: fabrics: add endpoint for querying route status Stefan Hanreich
2025-10-30 15:48 ` [pve-devel] [PATCH pve-network 5/9] api: nodes: fabrics: add endpoint for querying neighbor information Stefan Hanreich
2025-10-30 15:48 ` [pve-devel] [PATCH pve-network 6/9] api: nodes: fabrics: add endpoint for querying interface status Stefan Hanreich
2025-10-30 15:48 ` [pve-devel] [PATCH pve-network 7/9] api: nodes: zones: add bridge status Stefan Hanreich
2025-10-30 15:48 ` [pve-devel] [PATCH pve-network 8/9] api: nodes: zones: add ip vrf endpoint for evpn zones Stefan Hanreich
2025-10-30 15:48 ` [pve-devel] [PATCH pve-network 9/9] api: nodes: vnets: add mac-vrf endpoint for evpn vnets Stefan Hanreich
2025-10-30 15:48 ` [pve-devel] [PATCH pve-manager 1/8] api: nodes: use new status module for sdn subdirectory Stefan Hanreich
2025-10-30 15:48 ` [pve-devel] [PATCH pve-manager 2/8] refactor: ui: sdn browser: parametrize zone content panel Stefan Hanreich
2025-10-30 15:48 ` [pve-devel] [PATCH pve-manager 3/8] pvestatd: add network resource to status reporting Stefan Hanreich
2025-10-30 15:48 ` [pve-devel] [PATCH pve-manager 4/8] pvestatd: sdn: adapt to changes in " Stefan Hanreich
2025-10-30 15:48 ` [pve-devel] [PATCH pve-manager 5/8] ui: resource tree: add network resource Stefan Hanreich
2025-10-30 15:48 ` [pve-devel] [PATCH pve-manager 6/8] ui: sdn browser: Add ip-vrf panel for evpn zones Stefan Hanreich
2025-10-30 15:48 ` [pve-devel] [PATCH pve-manager 7/8] ui: sdn browser: add mac vrf panel Stefan Hanreich
2025-10-30 15:48 ` [pve-devel] [PATCH pve-manager 8/8] ui: sdn browser: add zone bridge view Stefan Hanreich
Reply instructions:
You may reply publicly to this message via plain-text email
using any one of the following methods:
* Save the following mbox file, import it into your mail client,
  and reply-to-all from there: mbox
  Avoid top-posting and favor interleaved quoting:
  https://en.wikipedia.org/wiki/Posting_style#Interleaved_style
* Reply using the --to, --cc, and --in-reply-to
  switches of git-send-email(1):
  git send-email \
    --in-reply-to=20251030154851.540408-19-s.hanreich@proxmox.com \
    --to=s.hanreich@proxmox.com \
    --cc=pve-devel@lists.proxmox.com \
    /path/to/YOUR_REPLY
  https://kernel.org/pub/software/scm/git/docs/git-send-email.html
* If your mail client supports setting the In-Reply-To header
  via mailto: links, try the mailto: link
  Be sure your reply has a Subject: header at the top and a blank line
  before the message body.
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox