2  *  @brief DNS Service Discovery
23  * @brief DNS Service Discovery
26  * advertise a service, system or application code should use
32  * @defgroup dns_sd DNS Service Discovery
63  * Currently sub-types and service domains are unsupported and only the
79  * Currently sub-types and service domains are unsupported and only the
89  * @brief Register a service for DNS Service Discovery
96  * ephemeral port usage - i.e. when the service is bound using port number 0.
102  * The service can be referenced using the @p _id variable.
104  * @param _id variable name for the DNS-SD service record
105  * @param _instance name of the service instance such as "My HTTP Server"
106  * @param _service name of the service, such as "_http"
107  * @param _proto protocol used by the service - either "_tcp" or "_udp"
108  * @param _domain the domain of the service, such as "local"
110  * @param _port a pointer to the port number that this service will use
116 		.service = _service,					\
125  * @brief Register a TCP service for DNS Service Discovery
127  * This macro can be used for service advertisement using DNS-SD.
129  * The service can be referenced using the @p id variable.
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.
181  * @param id variable name for the DNS-SD service record
182  * @param instance name of the service instance such as "My TFTP Server"
183  * @param service name of the service, such as "_tftp"
184  * @param domain the domain of the service, such as "local" or "zephyrproject.org"
186  * @param port a pointer to the port number that this service will use
190 #define DNS_SD_REGISTER_UDP_SERVICE(id, instance, service, domain, text, \  argument
193 	DNS_SD_REGISTER_SERVICE(id, instance, service, "_udp", domain,	 \
200  * @brief DNS Service Discovery record
206  * is non-zero, the service is advertised as being on that particular
207  * port. When the value in @a port is zero, then the service is not
218 	/** Top half of the "<Service>" such as "_http" */
219 	const char *service;  member
220 	/** Bottom half of the "<Service>" "_tcp" or "_udp" */
228 	/** A pointer to the port number used by the service */
261  * @brief Check if @a rec is a DNS-SD Service Type Enumeration
263  * DNS-SD Service Type Enumeration is used by network tooling to
272 …* @see <a href="https://datatracker.ietf.org/doc/html/rfc6763#section-9">Service Type Enumeration,…
275  * @return true if @a rec is a DNS-SD Service Type Enumeration