Lines Matching +full:instance +full:- +full:id
8 * SPDX-License-Identifier: Apache-2.0
43 /** RFC 6763 Section 7.2 - inclusive of underscore */
45 /** RFC 6763 Section 7.2 - inclusive of underscore */
49 /** RFC 6763 Section 4.1.2 - either _tcp or _udp (case insensitive) */
57 * Minimum number of segments in a fully-qualified name
63 * Currently sub-types and service domains are unsupported and only the
72 * Maximum number of segments in a fully-qualified name
76 * <instance>.<sn>._tcp.<domain>.
79 * Currently sub-types and service domains are unsupported and only the
92 * when a custom @p _domain or a custom (non-standard) @p _proto is required.
96 * ephemeral port usage - i.e. when the service is bound using port number 0.
104 * @param _id variable name for the DNS-SD service record
105 * @param _instance name of the service instance such as "My HTTP Server"
107 * @param _proto protocol used by the service - either "_tcp" or "_udp"
115 .instance = _instance, \
120 .text_size = sizeof(_text) - 1, \
127 * This macro can be used for service advertisement using DNS-SD.
129 * The service can be referenced using the @p id variable.
145 * TXT records begin with a single length byte (hex-encoded)
146 * and contain key=value pairs. Thus, the length of the key-value pair
152 * @param id variable name for the DNS-SD service record
153 * @param instance name of the service instance such as "My HTTP Server"
161 #define DNS_SD_REGISTER_TCP_SERVICE(id, instance, service, domain, text, \ argument
163 static const uint16_t id ## _port = sys_cpu_to_be16(port); \
164 DNS_SD_REGISTER_SERVICE(id, instance, service, "_tcp", domain, \
165 text, &id ## _port)
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"
190 #define DNS_SD_REGISTER_UDP_SERVICE(id, instance, service, domain, text, \ argument
192 static const uint16_t id ## _port = sys_cpu_to_be16(port); \
193 DNS_SD_REGISTER_SERVICE(id, instance, service, "_udp", domain, \
194 text, &id ## _port)
196 /** Empty DNS-SD TXT specifier */
205 * The @a port pointer must be non-NULL. When the value in @a port
206 * is non-zero, the service is advertised as being on that particular
211 * particular port if they hard-code the port.
216 /** "<Instance>" - e.g. "My HTTP Server" */
217 const char *instance; member
235 * @brief Empty TXT specifier for DNS-SD
241 * @brief Wildcard Port specifier for DNS-SD
250 * @brief Obtain the size of DNS-SD TXT data
257 return rec->text_size; in dns_sd_txt_size()
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
264 * acquire a list of all mDNS-advertised services belonging to a
268 * would be '_services._dns-sd._udp.local'.
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
280 * @brief Create a wildcard filter for DNS-SD records