Ondřej Surý
cd632ad31d
This implements node reference tracing that passes all the internal
layers from dns_db API (and friends) to increment_reference() and
decrement_reference().
It can be enabled by #defining DNS_DB_NODETRACE in <dns/trace.h> header.
The output then looks like this:
incr:node:check_address_records:rootns.c:409:0x7f67f5a55a40->references = 1
decr:node:check_address_records:rootns.c:449:0x7f67f5a55a40->references = 0
incr:nodelock:check_address_records:rootns.c:409:0x7f67f5a55a40:0x7f68304d7040->references = 1
decr:nodelock:check_address_records:rootns.c:449:0x7f67f5a55a40:0x7f68304d7040->references = 0
There's associated python script to find the missing detach located at:
https://gitlab.isc.org/isc-projects/bind9/-/snippets/1038
156 lines
3.5 KiB
C
156 lines
3.5 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
|
|
|
|
/*****
|
|
***** Module Info
|
|
*****/
|
|
|
|
/*! \file dns/rdatalist.h
|
|
* \brief
|
|
* A DNS rdatalist is a list of rdata of a common type and class.
|
|
*
|
|
* MP:
|
|
*\li Clients of this module must impose any required synchronization.
|
|
*
|
|
* Reliability:
|
|
*\li No anticipated impact.
|
|
*
|
|
* Resources:
|
|
*\li TBS
|
|
*
|
|
* Security:
|
|
*\li No anticipated impact.
|
|
*
|
|
* Standards:
|
|
*\li None.
|
|
*/
|
|
|
|
#include <isc/lang.h>
|
|
|
|
#include <dns/types.h>
|
|
|
|
/*%
|
|
* Clients may use this type directly.
|
|
*/
|
|
struct dns_rdatalist {
|
|
dns_rdataclass_t rdclass;
|
|
dns_rdatatype_t type;
|
|
dns_rdatatype_t covers;
|
|
dns_ttl_t ttl;
|
|
ISC_LIST(dns_rdata_t) rdata;
|
|
ISC_LINK(dns_rdatalist_t) link;
|
|
/*%<
|
|
* Case vector. If the bit is set then the corresponding
|
|
* character in the owner name needs to be AND'd with 0x20,
|
|
* rendering that character upper case.
|
|
*/
|
|
unsigned char upper[32];
|
|
};
|
|
|
|
ISC_LANG_BEGINDECLS
|
|
|
|
void
|
|
dns_rdatalist_init(dns_rdatalist_t *rdatalist);
|
|
/*%<
|
|
* Initialize rdatalist.
|
|
*
|
|
* Ensures:
|
|
*\li All fields of rdatalist have been initialized to their default
|
|
* values.
|
|
*/
|
|
|
|
void
|
|
dns_rdatalist_tordataset(dns_rdatalist_t *rdatalist, dns_rdataset_t *rdataset);
|
|
/*%<
|
|
* Make 'rdataset' refer to the rdata in 'rdatalist'.
|
|
*
|
|
* Note:
|
|
*\li The caller must ensure that 'rdatalist' remains valid and unchanged
|
|
* while 'rdataset' is associated with it.
|
|
*
|
|
* Requires:
|
|
*
|
|
*\li 'rdatalist' is a valid rdatalist.
|
|
*
|
|
*\li 'rdataset' is a valid rdataset that is not currently associated with
|
|
* any rdata.
|
|
*
|
|
* Ensures,
|
|
* on success,
|
|
*
|
|
*\li 'rdataset' is associated with the rdata in rdatalist.
|
|
*/
|
|
|
|
void
|
|
dns_rdatalist_fromrdataset(dns_rdataset_t *rdataset,
|
|
dns_rdatalist_t **rdatalist);
|
|
/*%<
|
|
* Point 'rdatalist' to the rdatalist in 'rdataset'.
|
|
*
|
|
* Requires:
|
|
*
|
|
*\li 'rdatalist' is a pointer to a NULL dns_rdatalist_t pointer.
|
|
*
|
|
*\li 'rdataset' is a valid rdataset associated with an rdatalist.
|
|
*
|
|
* Ensures,
|
|
* on success,
|
|
*
|
|
*\li 'rdatalist' is pointed to the rdatalist in rdataset.
|
|
*/
|
|
|
|
void
|
|
dns_rdatalist_disassociate(dns_rdataset_t *rdatasetp DNS__DB_FLARG);
|
|
|
|
isc_result_t
|
|
dns_rdatalist_first(dns_rdataset_t *rdataset);
|
|
|
|
isc_result_t
|
|
dns_rdatalist_next(dns_rdataset_t *rdataset);
|
|
|
|
void
|
|
dns_rdatalist_current(dns_rdataset_t *rdataset, dns_rdata_t *rdata);
|
|
|
|
void
|
|
dns_rdatalist_clone(dns_rdataset_t *source,
|
|
dns_rdataset_t *target DNS__DB_FLARG);
|
|
|
|
unsigned int
|
|
dns_rdatalist_count(dns_rdataset_t *rdataset);
|
|
|
|
isc_result_t
|
|
dns_rdatalist_addnoqname(dns_rdataset_t *rdataset, const dns_name_t *name);
|
|
|
|
isc_result_t
|
|
dns_rdatalist_getnoqname(dns_rdataset_t *rdataset, dns_name_t *name,
|
|
dns_rdataset_t *neg,
|
|
dns_rdataset_t *negsig DNS__DB_FLARG);
|
|
|
|
isc_result_t
|
|
dns_rdatalist_addclosest(dns_rdataset_t *rdataset, const dns_name_t *name);
|
|
|
|
isc_result_t
|
|
dns_rdatalist_getclosest(dns_rdataset_t *rdataset, dns_name_t *name,
|
|
dns_rdataset_t *neg,
|
|
dns_rdataset_t *negsig DNS__DB_FLARG);
|
|
|
|
void
|
|
dns_rdatalist_setownercase(dns_rdataset_t *rdataset, const dns_name_t *name);
|
|
|
|
void
|
|
dns_rdatalist_getownercase(const dns_rdataset_t *rdataset, dns_name_t *name);
|
|
|
|
ISC_LANG_ENDDECLS
|