Skip to main content

Crate zerodds_discovery

Crate zerodds_discovery 

Source
Expand description

Crate zerodds-discovery. Safety classification: SAFE.

DDSI-RTPS-Discovery für ZeroDDS — SPDP, SEDP, TypeLookup-Service.

§Spec

  • DDSI-RTPS 2.5 §8.5 — Simple Discovery Protocol (SPDP/SEDP).
  • DDSI-RTPS 2.5 §8.5.3 — SPDP Builtin-Endpoints.
  • DDSI-RTPS 2.5 §8.5.4 — SEDP Builtin-Endpoints.
  • XTypes 1.3 §7.6.3.3.4 — TypeLookup-Service (TL_SVC_REQ_{WRITER,READER} + TL_SVC_REPLY_{WRITER,READER}).
  • DDS-Security 1.2 §7.4.2 — Stateless + Volatile-Secure Builtin-Endpoints (sub-module security).

§Public API

  • spdp — SPDP Beacon-Sender + -Receiver + DiscoveredParticipantsCache mit last_seen-Lease-Tracking.
  • sedp — SEDP Stack (Cache, Reader, Writer).
  • type_lookup — TypeLookup-Service Server + Client + Builtin-Endpoint-GUIDs.
  • security — DDS-Security Stateless + Volatile-Secure Builtin-Endpoint-Slots.
  • capabilities::PeerCapabilities — DDSI-Capability-Bits.

§Wiring an DCPS-Runtime

Die Discovery-Primitives sind wire-format-vollständig. Die Instantiierung der Builtin-Endpoint-Reliable-Writer/Reader-Pairs liegt im DCPS-Layer (crates/dcps/src/runtime.rs):

  • SPDP: Best-Effort Writer + Reader auf ParticipantBuiltinTopicData.
  • SEDP: Reliable Writer + Reader auf Publication-/Subscription-BuiltinTopicData.
  • TypeLookup: Reliable Writer + Reader auf TypesRequest/ TypesReply-Topic mit Service-Instance-Name.

Re-exports§

pub use capabilities::PeerCapabilities;
pub use sedp::CacheCaps;
pub use sedp::DiscoveredEndpointsCache;
pub use sedp::DiscoveredPublication;
pub use sedp::DiscoveredSubscription;
pub use spdp::DiscoveredParticipant;
pub use spdp::DiscoveredParticipantsCache;
pub use spdp::SpdpBeacon;
pub use spdp::SpdpError;
pub use spdp::SpdpReader;

Modules§

capabilities
Peer-Capabilities aus dem BuiltinEndpointSet-Bitfield.
metrics
Hot-Path-Hook-Points fuer zerodds-monitor (zerodds-monitor-1.0 §2.4).
security
DDS-Security Builtin-Endpoint-Slots — Wire-Layer.
sedp
Simple Endpoint Discovery Protocol (SEDP) — DDSI-RTPS 2.5 §8.5.4.
spdp
Simple Participant Discovery Protocol (DDSI-RTPS 2.5 §8.5.3).
type_lookup
TypeLookup-Service — XTypes 1.3 §7.6.3.3.4.