FAST-DISCOVERY-SERVER(1)

๐Ÿ’… NAME

fast-discovery-server โ€” the centralized broker for DDS service discovery, and yes she's that girl ๐Ÿ’–


โœจ SYNOPSIS

fast-discovery-server -i ID [options]

๐Ÿฆ‹ DESCRIPTION

okay so bestie, picture this ๐ŸŒธ: eProsima Fast DDS is a Data Distribution Service (DDS) middleware implementation, and it's out here offering the feature of dynamically discovering communication entities inside a network. slay.

The DDS standard defines a Simple Discovery Protocol (SDP) to do that whole job, sharing the participants' info using well known multicast addresses and ports. and like, that's cute and all โ€” out-of-the-box participant discovery, no setup, we love a low-effort queen ๐Ÿ‘‘ โ€” but she has a problem. it's giving scalability issues ๐Ÿ’€ because the number of exchanged packets goes up exponentially as new participants get added to the system. exponential. in this economy?? no thank you.

and that's not even the worst part, because it also requires multicasting capabilities, which may not work reliably (think WiFi communication [1] โ€” yeah, that case ๐Ÿ™ˆ), or may not even be present at all. not me showing up to a multicast party that isn't happening ๐Ÿ˜ญ

so therefore, eProsima Fast DDS implements the Discovery Server (DS) protocol, which is a brand new discovery mechanism based on a centralized communications model. in this model, a core participant โ€” referred to as a Server โ€” handles all the information exchanged between participants on the network. one main character handling the group chat. iconic behavior, honestly ๐Ÿซถ

fast-discovery-server accepts the following arguments:


๐ŸŽ€ OPTIONS

  • -i ID, --server-id ID โ€” this one is mandatory, bestie, no skipping it ๐Ÿ’… she's the unique server identifier. specifies the zero based server position in the ROS_DISCOVERY_SERVER variable. zero based!! count from 0, not 1, don't embarrass me ๐Ÿ™ˆ
  • -l IP, --ip-address IP โ€” the server interface on which to listen to the clients ๐Ÿ‘‚ defaults to any, which is 0.0.0.0. she's open to everyone โœจ
  • -p PORT, --port PORT โ€” the UDP port on which to listen to the clients ๐Ÿ“ฎ defaults to 11811. memorize it, it's her number ๐ŸŽ€
  • -b, --backup โ€” creates a server with a backup file associated ๐Ÿ’พ she keeps receipts, as she should ๐Ÿงš

๐Ÿ‘‘ AUTHOR

eProsima FastDDS is developed by Proyectos y Sistemas de Mantenimiento SL. This manual page was written for the Debian distribution by Timo Rรถhling, and may be used without restriction. shoutout to Timo fr fr ๐Ÿซถ


and that's the whole page, bestie ๐Ÿ’– this one lives in the eProsima FastDDS manual, section 1 (the FAST-DISCOVERY-SERVER(1) corner of the internet, iykyk), and it's yours to read and share. periodt ๐Ÿ’…โœจ