dns_sd.c File Reference

DNS-SD (DNS-Based Service Discovery) More...

#include <stdlib.h>
#include "core/net.h"
#include "mdns/mdns_responder.h"
#include "dns_sd/dns_sd.h"
#include "dns_sd/dns_sd_misc.h"
#include "debug.h"

Go to the source code of this file.

Macros
#define	TRACE_LEVEL   DNS_SD_TRACE_LEVEL

Functions
void	dnsSdGetDefaultSettings (DnsSdSettings *settings)
	Initialize settings with default values. More...
error_t	dnsSdInit (DnsSdContext *context, const DnsSdSettings *settings)
	DNS-DS initialization. More...
error_t	dnsSdStart (DnsSdContext *context)
	Start mDNS responder. More...
error_t	dnsSdStop (DnsSdContext *context)
	Stop mDNS responder. More...
MdnsState	dnsSdGetState (DnsSdContext *context)
	Retrieve current state. More...
error_t	dnsSdSetInstanceName (DnsSdContext *context, const char_t *instanceName)
	Set service instance name. More...
error_t	dnsSdRegisterService (DnsSdContext *context, const char_t *serviceName, uint16_t priority, uint16_t weight, uint16_t port, const char_t *metadata)
	Register a DNS-SD service. More...
error_t	dnsSdUnregisterService (DnsSdContext *context, const char_t *serviceName)
	Unregister a DNS-SD service. More...
uint_t	dnsSdGetNumServices (DnsSdContext *context)
	Get the number of registered services. More...
error_t	dnsSdStartProbing (DnsSdContext *context)
	Restart probing process. More...
void	dnsSdTick (DnsSdContext *context)
	DNS-SD responder timer handler. More...
void	dnsSdLinkChangeEvent (DnsSdContext *context)
	Callback function for link change event. More...

Variables
systime_t	dnsSdTickCounter

Detailed Description

DNS-SD (DNS-Based Service Discovery)

License

SPDX-License-Identifier: GPL-2.0-or-later

Copyright (C) 2010-2024 Oryx Embedded SARL. All rights reserved.

This file is part of CycloneTCP Open.

This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with this program; if not, write to the Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.

Description

DNS-SD allows clients to discover a list of named instances of that desired service, using standard DNS queries. Refer to the following RFCs for complete details:

• RFC 6763: DNS-Based Service Discovery
• RFC 2782: A DNS RR for specifying the location of services (DNS SRV)

Author

Oryx Embedded SARL (www.oryx-embedded.com)

Version

2.4.0

Definition in file dns_sd.c.

Macro Definition Documentation

TRACE_LEVEL

#define TRACE_LEVEL   DNS_SD_TRACE_LEVEL

Definition at line 40 of file dns_sd.c.

Function Documentation

dnsSdGetDefaultSettings()

void dnsSdGetDefaultSettings

(

DnsSdSettings *

settings

)

Initialize settings with default values.

Parameters

[out]

settings

Structure that contains DNS-SD settings

Definition at line 62 of file dns_sd.c.

dnsSdGetNumServices()

uint_t dnsSdGetNumServices

(

DnsSdContext *

context

)

Get the number of registered services.

Parameters

[in]

context

Pointer to the DNS-SD context

Returns

Number of registered services

Definition at line 456 of file dns_sd.c.

dnsSdGetState()

MdnsState dnsSdGetState

(

DnsSdContext *

context

)

Retrieve current state.

Parameters

[in]

context

Pointer to the DNS-SD context

Returns

Current DNS-SD state

Definition at line 187 of file dns_sd.c.

dnsSdInit()

error_t dnsSdInit	(	DnsSdContext *	context,
		const DnsSdSettings *	settings
	)

DNS-DS initialization.

Parameters

[in]	context	Pointer to the DNS-SD context
[in]	settings	DNS-SD specific settings

Returns

Error code

Definition at line 83 of file dns_sd.c.

dnsSdLinkChangeEvent()

void dnsSdLinkChangeEvent

(

DnsSdContext *

context

)

Callback function for link change event.

Parameters

[in]

context

Pointer to the DNS-SD context

Definition at line 680 of file dns_sd.c.

dnsSdRegisterService()

error_t dnsSdRegisterService	(	DnsSdContext *	context,
		const char_t *	serviceName,
		uint16_t	priority,
		uint16_t	weight,
		uint16_t	port,
		const char_t *	metadata
	)

Register a DNS-SD service.

Parameters

[in]	context	Pointer to the DNS-SD context
[in]	serviceName	NULL-terminated string that contains the name of the service to be registered
[in]	priority	Priority field
[in]	weight	Weight field
[in]	port	Port number
[in]	metadata	NULL-terminated string that contains the discovery-time metadata (TXT record)

Returns

Error code

Definition at line 267 of file dns_sd.c.

dnsSdSetInstanceName()

error_t dnsSdSetInstanceName	(	DnsSdContext *	context,
		const char_t *	instanceName
	)

Set service instance name.

Parameters

[in]	context	Pointer to the DNS-SD context
[in]	instanceName	NULL-terminated string that contains the service instance name

Returns

Error code

Definition at line 211 of file dns_sd.c.

dnsSdStart()

error_t dnsSdStart

(

DnsSdContext *

context

)

Start mDNS responder.

Parameters

[in]

context

Pointer to the DNS-SD context

Returns

Error code

Definition at line 125 of file dns_sd.c.

dnsSdStartProbing()

error_t dnsSdStartProbing

(

DnsSdContext *

context

)

Restart probing process.

Parameters

[in]

context

Pointer to the DNS-SD context

Returns

Error code

Definition at line 491 of file dns_sd.c.

dnsSdStop()

error_t dnsSdStop

(

DnsSdContext *

context

)

Stop mDNS responder.

Parameters

[in]

context

Pointer to the DNS-SD context

Returns

Error code

Definition at line 156 of file dns_sd.c.

dnsSdTick()

void dnsSdTick

(

DnsSdContext *

context

)

DNS-SD responder timer handler.

This routine must be periodically called by the TCP/IP stack to manage DNS-SD operation

Parameters

[in]

context

Pointer to the DNS-SD context

Definition at line 514 of file dns_sd.c.

dnsSdUnregisterService()

error_t dnsSdUnregisterService	(	DnsSdContext *	context,
		const char_t *	serviceName
	)

Unregister a DNS-SD service.

Parameters

[in]	context	Pointer to the DNS-SD context
[in]	serviceName	NULL-terminated string that contains the name of the service to be unregistered

Returns

Error code

Definition at line 414 of file dns_sd.c.

Variable Documentation

dnsSdTickCounter

systime_t dnsSdTickCounter

Definition at line 54 of file dns_sd.c.