Evan Hunt
916ea26ead
DSCP has not been fully working since the network manager was introduced in 9.16, and has been completely broken since 9.18. This seems to have caused very few difficulties for anyone, so we have now marked it as obsolete and removed the implementation. To ensure that old config files don't fail, the code to parse dscp key-value pairs is still present, but a warning is logged that the feature is obsolete and should not be used. Nothing is done with configured values, and there is no longer any range checking.
220 lines
5.1 KiB
C
220 lines
5.1 KiB
C
/*
|
|
* Copyright (C) Internet Systems Consortium, Inc. ("ISC")
|
|
*
|
|
* SPDX-License-Identifier: MPL-2.0
|
|
*
|
|
* This Source Code Form is subject to the terms of the Mozilla Public
|
|
* License, v. 2.0. If a copy of the MPL was not distributed with this
|
|
* file, you can obtain one at https://mozilla.org/MPL/2.0/.
|
|
*
|
|
* See the COPYRIGHT file distributed with this work for additional
|
|
* information regarding copyright ownership.
|
|
*/
|
|
|
|
#pragma once
|
|
|
|
/*! \file dns/remote.h */
|
|
|
|
#include <stdbool.h>
|
|
|
|
#include <isc/lang.h>
|
|
#include <isc/magic.h>
|
|
#include <isc/mem.h>
|
|
|
|
#include <dns/types.h>
|
|
|
|
ISC_LANG_BEGINDECLS
|
|
|
|
#define DNS_REMOTE_MAGIC ISC_MAGIC('R', 'm', 't', 'e')
|
|
#define DNS_REMOTE_VALID(remote) ISC_MAGIC_VALID(remote, DNS_REMOTE_MAGIC)
|
|
|
|
struct dns_remote {
|
|
unsigned int magic;
|
|
isc_mem_t *mctx;
|
|
isc_sockaddr_t *addresses;
|
|
isc_sockaddr_t *sources;
|
|
dns_name_t **keynames;
|
|
dns_name_t **tlsnames;
|
|
bool *ok;
|
|
unsigned int addrcnt;
|
|
unsigned int curraddr;
|
|
};
|
|
|
|
isc_sockaddr_t *
|
|
dns_remote_addresses(dns_remote_t *remote);
|
|
/*%<
|
|
* Return the addresses of the remote server.
|
|
*
|
|
* Requires:
|
|
* 'remote' is a valid remote structure.
|
|
*/
|
|
|
|
isc_sockaddr_t *
|
|
dns_remote_sources(dns_remote_t *remote);
|
|
/*%<
|
|
* Return the source addresses to be used for the remote server.
|
|
*
|
|
* Requires:
|
|
* 'remote' is a valid remote structure.
|
|
*/
|
|
|
|
unsigned int
|
|
dns_remote_count(dns_remote_t *remote);
|
|
/*%<
|
|
* Return the number of addresses of the remote server.
|
|
*
|
|
* Requires:
|
|
* 'remote' is a valid remote structure.
|
|
*/
|
|
|
|
dns_name_t **
|
|
dns_remote_keynames(dns_remote_t *remote);
|
|
/*%<
|
|
* Return the keynames of the remote server.
|
|
*
|
|
* Requires:
|
|
* 'remote' is a valid remote structure.
|
|
*/
|
|
|
|
dns_name_t **
|
|
dns_remote_tlsnames(dns_remote_t *remote);
|
|
/*%<
|
|
* Return the tlsnames of the remote server.
|
|
*
|
|
* Requires:
|
|
* 'remote' is a valid remote structure.
|
|
*/
|
|
|
|
void
|
|
dns_remote_init(dns_remote_t *remote, unsigned int count,
|
|
const isc_sockaddr_t *addrs, const isc_sockaddr_t *srcs,
|
|
dns_name_t **keynames, dns_name_t **tlsnames, bool mark,
|
|
isc_mem_t *mctx);
|
|
|
|
/*%<
|
|
* Initialize a remote server. Set the provided addresses (addrs),
|
|
* source addresses (srcs), key names (keynames) and tls names
|
|
* (tlsnames). Use the provided memory context (mctx) for allocations.
|
|
* If 'mark' is 'true', set up a list of boolean values to mark the
|
|
* server bad or good.
|
|
*
|
|
* Requires:
|
|
* 'remote' is a valid remote structure.
|
|
* 'mctx' is not NULL.
|
|
* 'addrs' is not NULL, or 'count' equals zero.
|
|
* 'keynames' and 'tlsnames' are not NULL, then 'count > 0'.
|
|
*/
|
|
|
|
void
|
|
dns_remote_clear(dns_remote_t *remote);
|
|
/*%<
|
|
* Clear remote server 'remote', free memory.
|
|
*
|
|
* Requires:
|
|
* 'remote' is a valid remote structure.
|
|
*/
|
|
|
|
bool
|
|
dns_remote_equal(dns_remote_t *a, dns_remote_t *b);
|
|
/*%<
|
|
* Compare two remote servers 'a' and 'b'. Check if the address
|
|
* count, the addresses, the key names and the tls names are
|
|
* the same. Return 'true' if so, 'false' otherwise.
|
|
*
|
|
* Requires:
|
|
* 'a' and 'b' are valid remote structures.
|
|
*/
|
|
|
|
void
|
|
dns_remote_reset(dns_remote_t *remote, bool clear_ok);
|
|
/*%<
|
|
* Reset the remote server, set the current address back to the
|
|
* first. If 'clear_ok' is 'true', clear any servers marked ok.
|
|
*
|
|
* Requires:
|
|
* 'remote' is a valid remote structure.
|
|
*/
|
|
|
|
void
|
|
dns_remote_next(dns_remote_t *remote, bool skip_good);
|
|
/*%<
|
|
* Skip to the next address. If 'skip_good' is 'true', skip over
|
|
* already addresses already considered good, whatever good means in the
|
|
* context of this remote server.
|
|
*
|
|
* Requires:
|
|
* 'remote' is a valid remote structure.
|
|
*/
|
|
|
|
isc_sockaddr_t
|
|
dns_remote_curraddr(dns_remote_t *remote);
|
|
/*%<
|
|
* Return the currently used address for this remote server.
|
|
*
|
|
* Requires:
|
|
* 'remote' is a valid remote structure.
|
|
* 'remote->addresses' is not NULL.
|
|
*/
|
|
|
|
isc_sockaddr_t
|
|
dns_remote_sourceaddr(dns_remote_t *remote);
|
|
/*%<
|
|
* Return the current source address.
|
|
*
|
|
* Requires:
|
|
* 'remote' is a valid remote structure.
|
|
* 'remote->sources' is not NULL.
|
|
*/
|
|
|
|
isc_sockaddr_t
|
|
dns_remote_addr(dns_remote_t *remote, unsigned int i);
|
|
/*%<
|
|
* Return the address at index 'i'.
|
|
*
|
|
* Requires:
|
|
* 'remote' is a valid remote structure.
|
|
* 'remote->addresses' is not NULL.
|
|
*/
|
|
|
|
dns_name_t *
|
|
dns_remote_keyname(dns_remote_t *remote);
|
|
/*%<
|
|
* Return the current key name. Returns NULL if we have iterated
|
|
* over all addresses already, or if keynames are not used.
|
|
*
|
|
* Requires:
|
|
* 'remote' is a valid remote structure.
|
|
*/
|
|
|
|
dns_name_t *
|
|
dns_remote_tlsname(dns_remote_t *remote);
|
|
/*%<
|
|
* Return the current tls name. Returns NULL if we have iterated
|
|
* over all addresses already, or if tlsnames are not used.
|
|
*
|
|
* Requires:
|
|
* 'remote' is a valid remote structure.
|
|
*/
|
|
|
|
void
|
|
dns_remote_mark(dns_remote_t *remote, bool good);
|
|
/*%<
|
|
* Mark the current address 'good' (or not good if 'good' is
|
|
* 'false').
|
|
*
|
|
* Requires:
|
|
* 'remote' is a valid remote structure.
|
|
* The current address index is lower than the address count.
|
|
*/
|
|
|
|
bool
|
|
dns_remote_done(dns_remote_t *remote);
|
|
/*%<
|
|
* Return 'true' if we iterated over all addresses, 'false' otherwise.
|
|
*
|
|
* Requires:
|
|
* 'remote' is a valid remote structure.
|
|
*/
|
|
|
|
ISC_LANG_ENDDECLS
|