ACME-DNS client. More...

#include "dns_api/acme_dns_client.h"
#include "dns_api/acme_dns_client_misc.h"
#include "debug.h"

Macros
#define	TRACE_LEVEL ACME_DNS_TRACE_LEVEL

Functions
error_t	acmeDnsClientInit (AcmeDnsClientContext *context)
	Initialize ACME-DNS client context. More...

error_t	acmeDnsClientRegisterTlsInitCallback (AcmeDnsClientContext *context, AcmeDnsClientTlsInitCallback callback)
	Register TLS initialization callback function. More...

error_t	acmeDnsClientSetTimeout (AcmeDnsClientContext *context, systime_t timeout)
	Set communication timeout. More...

error_t	acmeDnsClientSetHost (AcmeDnsClientContext context, const char_t host)
	Set the domain name of the ACME-DNS server. More...

error_t	acmeDnsClientSetUsername (AcmeDnsClientContext context, const char_t username)
	Set user name. More...

error_t	acmeDnsClientSetPassword (AcmeDnsClientContext context, const char_t password)
	Set password. More...

error_t	acmeDnsClientSetSubDomain (AcmeDnsClientContext context, const char_t subDomain)
	Set sub domain. More...

const char_t *	acmeDnsClientGetUsername (AcmeDnsClientContext *context)
	Get user name. More...

const char_t *	acmeDnsClientGetPassword (AcmeDnsClientContext *context)
	Get password. More...

const char_t *	acmeDnsClientGetSubDomain (AcmeDnsClientContext *context)
	Get sub domain. More...

const char_t *	acmeDnsClientGetFullDomain (AcmeDnsClientContext *context)
	Get full domain. More...

error_t	acmeDnsClientBindToInterface (AcmeDnsClientContext context, NetInterface interface)
	Bind the ACME-DNS client to a particular network interface. More...

error_t	acmeDnsClientConnect (AcmeDnsClientContext context, const IpAddr serverIpAddr, uint16_t serverPort)
	Establish a connection with the specified ACME-DNS server. More...

error_t	acmeDnsClientRegister (AcmeDnsClientContext *context)
	Register endpoint. More...

error_t	acmeDnsClientUpdate (AcmeDnsClientContext context, const char_t txt)
	Update endpoint. More...

error_t	acmeDnsClientDisconnect (AcmeDnsClientContext *context)
	Gracefully disconnect from the ACME-DNS server. More...

error_t	acmeDnsClientClose (AcmeDnsClientContext *context)
	Close the connection with the ACME-DNS server. More...

void	acmeDnsClientDeinit (AcmeDnsClientContext *context)
	Release ACME-DNS client context. More...

Detailed Description

ACME-DNS client.

License

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

This file is part of CycloneACME 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.

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

Version: 2.4.0

Definition in file acme_dns_client.c.

Macro Definition Documentation

◆ TRACE_LEVEL

#define TRACE_LEVEL ACME_DNS_TRACE_LEVEL

Definition at line 32 of file acme_dns_client.c.

Function Documentation

◆ acmeDnsClientBindToInterface()

error_t acmeDnsClientBindToInterface	(	AcmeDnsClientContext *	context,
		NetInterface *	interface
	)

Bind the ACME-DNS client to a particular network interface.

Parameters

[in]	context	Pointer to the ACME-DNS client context
[in]	interface	Network interface to be used

Returns: Error code

Definition at line 335 of file acme_dns_client.c.

◆ acmeDnsClientClose()

error_t acmeDnsClientClose ( AcmeDnsClientContext * context )

Close the connection with the ACME-DNS server.

Parameters

[in] context Pointer to the ACME-DNS client context

Returns: Error code

Definition at line 839 of file acme_dns_client.c.

◆ acmeDnsClientConnect()

error_t acmeDnsClientConnect	(	AcmeDnsClientContext *	context,
		const IpAddr *	serverIpAddr,
		uint16_t	serverPort
	)

Establish a connection with the specified ACME-DNS server.

Parameters

[in]	context	Pointer to the ACME-DNS client context
[in]	serverIpAddr	IP address of the ACME-DNS server to connect to
[in]	serverPort	Port number

Returns: Error code

Definition at line 358 of file acme_dns_client.c.

◆ acmeDnsClientDeinit()

void acmeDnsClientDeinit ( AcmeDnsClientContext * context )

Release ACME-DNS client context.

Parameters

[in] context Pointer to the ACME-DNS client context

Definition at line 860 of file acme_dns_client.c.

◆ acmeDnsClientDisconnect()

error_t acmeDnsClientDisconnect ( AcmeDnsClientContext * context )

Gracefully disconnect from the ACME-DNS server.

Parameters

[in] context Pointer to the ACME-DNS client context

Returns: Error code

Definition at line 773 of file acme_dns_client.c.

◆ acmeDnsClientGetFullDomain()

const char_t* acmeDnsClientGetFullDomain ( AcmeDnsClientContext * context )

Get full domain.

Parameters

[in] context Pointer to the ACME-DNS client context

Returns: NULL-terminated string containing the full domain

Definition at line 309 of file acme_dns_client.c.

◆ acmeDnsClientGetPassword()

const char_t* acmeDnsClientGetPassword ( AcmeDnsClientContext * context )

Get password.

Parameters

[in] context Pointer to the ACME-DNS client context

Returns: NULL-terminated string containing the password

Definition at line 259 of file acme_dns_client.c.

◆ acmeDnsClientGetSubDomain()

const char_t* acmeDnsClientGetSubDomain ( AcmeDnsClientContext * context )

Get sub domain.

Parameters

[in] context Pointer to the ACME-DNS client context

Returns: NULL-terminated string containing the sub domain

Definition at line 284 of file acme_dns_client.c.

◆ acmeDnsClientGetUsername()

const char_t* acmeDnsClientGetUsername ( AcmeDnsClientContext * context )

Get user name.

Parameters

[in] context Pointer to the ACME-DNS client context

Returns: NULL-terminated string containing the user name

Definition at line 234 of file acme_dns_client.c.

◆ acmeDnsClientInit()

error_t acmeDnsClientInit ( AcmeDnsClientContext * context )

Initialize ACME-DNS client context.

Parameters

[in] context Pointer to the ACME-DNS client context

Returns: Error code

Definition at line 49 of file acme_dns_client.c.

◆ acmeDnsClientRegister()

error_t acmeDnsClientRegister ( AcmeDnsClientContext * context )

Register endpoint.

Parameters

[in] context Pointer to the ACME-DNS client context

Returns: Error code

Definition at line 460 of file acme_dns_client.c.

◆ acmeDnsClientRegisterTlsInitCallback()

error_t acmeDnsClientRegisterTlsInitCallback	(	AcmeDnsClientContext *	context,
		AcmeDnsClientTlsInitCallback	callback
	)

Register TLS initialization callback function.

Parameters

[in]	context	Pointer to the ACME-DNS client context
[in]	callback	TLS initialization callback function

Returns: Error code

Definition at line 85 of file acme_dns_client.c.

◆ acmeDnsClientSetHost()

error_t acmeDnsClientSetHost	(	AcmeDnsClientContext *	context,
		const char_t *	host
	)

Set the domain name of the ACME-DNS server.

Parameters

[in]	context	Pointer to the ACME-DNS client context
[in]	host	NULL-terminated string containing the host name

Returns: Error code

Definition at line 131 of file acme_dns_client.c.

◆ acmeDnsClientSetPassword()

error_t acmeDnsClientSetPassword	(	AcmeDnsClientContext *	context,
		const char_t *	password
	)

Set password.

Parameters

[in]	context	Pointer to the ACME-DNS client context
[in]	password	NULL-terminated string containing the password

Returns: Error code

Definition at line 183 of file acme_dns_client.c.

◆ acmeDnsClientSetSubDomain()

error_t acmeDnsClientSetSubDomain	(	AcmeDnsClientContext *	context,
		const char_t *	subDomain
	)

Set sub domain.

Parameters

[in]	context	Pointer to the ACME-DNS client context
[in]	subDomain	NULL-terminated string containing the sub domain

Returns: Error code

Definition at line 209 of file acme_dns_client.c.

◆ acmeDnsClientSetTimeout()

error_t acmeDnsClientSetTimeout	(	AcmeDnsClientContext *	context,
		systime_t	timeout
	)

Set communication timeout.

Parameters

[in]	context	Pointer to the ACME-DNS client context
[in]	timeout	Timeout value, in milliseconds

Returns: Error code

Definition at line 109 of file acme_dns_client.c.

◆ acmeDnsClientSetUsername()

error_t acmeDnsClientSetUsername	(	AcmeDnsClientContext *	context,
		const char_t *	username
	)

Set user name.

Parameters

[in]	context	Pointer to the ACME-DNS client context
[in]	username	NULL-terminated string containing the user name

Returns: Error code

Definition at line 157 of file acme_dns_client.c.

◆ acmeDnsClientUpdate()

error_t acmeDnsClientUpdate	(	AcmeDnsClientContext *	context,
		const char_t *	txt
	)

Update endpoint.

Parameters

[in]	context	Pointer to the ACME-DNS client context
[in]	txt	NULL-terminated string that contains the value of the TXT record

Returns: Error code

Definition at line 602 of file acme_dns_client.c.

Macros

Functions

Detailed Description

License

Macro Definition Documentation

◆ TRACE_LEVEL

Function Documentation

◆ acmeDnsClientBindToInterface()

◆ acmeDnsClientClose()

◆ acmeDnsClientConnect()

◆ acmeDnsClientDeinit()

◆ acmeDnsClientDisconnect()

◆ acmeDnsClientGetFullDomain()

◆ acmeDnsClientGetPassword()

◆ acmeDnsClientGetSubDomain()

◆ acmeDnsClientGetUsername()

◆ acmeDnsClientInit()

◆ acmeDnsClientRegister()

◆ acmeDnsClientRegisterTlsInitCallback()

◆ acmeDnsClientSetHost()

◆ acmeDnsClientSetPassword()

◆ acmeDnsClientSetSubDomain()

◆ acmeDnsClientSetTimeout()

◆ acmeDnsClientSetUsername()

◆ acmeDnsClientUpdate()