2  *  @brief DNS Service Discovery
22  * @brief DNS Service Discovery
25  * advertise a service, system or application code should use
31  * @defgroup dns_sd DNS Service Discovery
60  * Currently sub-types and service domains are unsupported and only the
76  * Currently sub-types and service domains are unsupported and only the
86  * @brief Register a service for DNS Service Discovery
93  * ephemeral port usage - i.e. when the service is bound using port number 0.
99  * The service can be referenced using the @p _id variable.
101  * @param _id variable name for the DNS-SD service record
102  * @param _instance name of the service instance such as "My HTTP Server"
103  * @param _service name of the service, such as "_http"
104  * @param _proto protocol used by the service - either "_tcp" or "_udp"
105  * @param _domain the domain of the service, such as "local"
107  * @param _port a pointer to the port number that this service will use
113 		.service = _service,					\
122  * @brief Register a TCP service for DNS Service Discovery
124  * This macro can be used for service advertisement using DNS-SD.
126  * The service can be referenced using the @p id variable.
139  * // Possibly only assign bar_port when the service is running
152  * @param id variable name for the DNS-SD service record
153  * @param instance name of the service instance such as "My HTTP Server"
154  * @param service name of the service, such as "_http"
155  * @param domain the domain of the service, such as "local"
157  * @param port the port number that this service will use
161 #define DNS_SD_REGISTER_TCP_SERVICE(id, instance, service, domain, text, \  argument
164 	DNS_SD_REGISTER_SERVICE(id, instance, service, "_tcp", domain,	 \
168  * @brief Register a UDP service for DNS Service Discovery
170  * This macro can be used for service advertisement using DNS-SD.
172  * The service can be referenced using the @p id variable.
183  * @param id variable name for the DNS-SD service record
184  * @param instance name of the service instance such as "My TFTP Server"
185  * @param service name of the service, such as "_tftp"
186  * @param domain the domain of the service, such as "local" or "zephyrproject.org"
188  * @param port a pointer to the port number that this service will use
192 #define DNS_SD_REGISTER_UDP_SERVICE(id, instance, service, domain, text, \  argument
195 	DNS_SD_REGISTER_SERVICE(id, instance, service, "_udp", domain,	 \
204  * @brief DNS Service Discovery record
210  * is non-zero, the service is advertised as being on that particular
211  * port. When the value in @a port is zero, then the service is not
224 	/** Top half of the <Service> such as "_http" */
225 	const char *service;  member
226 	/** Bottom half of the <Service> "_tcp" or "_udp" */
234 	/** A pointer to the port number used by the service */
265  * @brief Check if @a rec is a DNS-SD Service Type Enumeration
267  * DNS-SD Service Type Enumeration is used by network tooling to
276 …* @see <a href="https://datatracker.ietf.org/doc/html/rfc6763#section-9">Service Type Enumeration,…
279  * @return true if @a rec is a DNS-SD Service Type Enumeration