/usr/include/dnsdb/zdb-zone-arc.h is in libyadifa-dev 2.3.7-1build1.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 | /*------------------------------------------------------------------------------
*
* Copyright (c) 2011-2017, EURid. All rights reserved.
* The YADIFA TM software product is provided under the BSD 3-clause license:
*
* Redistribution and use in source and binary forms, with or without
* modification, are permitted provided that the following conditions
* are met:
*
* * Redistributions of source code must retain the above copyright
* notice, this list of conditions and the following disclaimer.
* * Redistributions in binary form must reproduce the above copyright
* notice, this list of conditions and the following disclaimer in the
* documentation and/or other materials provided with the distribution.
* * Neither the name of EURid nor the names of its contributors may be
* used to endorse or promote products derived from this software
* without specific prior written permission.
*
* THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
* AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
* IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
* ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE
* LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
* CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
* SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
* INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
* CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
* ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
* POSSIBILITY OF SUCH DAMAGE.
*
*------------------------------------------------------------------------------
*
*/
/** @defgroup dnsdbzone Zone related functions
* @ingroup dnsdb
* @brief Functions used to manipulate a zone
*
* Functions used to manipulate a zone
*
* @{
*/
#pragma once
#include <dnsdb/zdb_types.h>
#include <dnsdb/dnsrdata.h>
#include <dnscore/input_stream.h>
#include <dnscore/output_stream.h>
/**
*
* Locks the database
* Gets the zone
* Starts locking the zone for the owner
* Increment the zone RC
* Unlocks the database
* Resume locking the zone for the owner
* returns the locked zone
*
* The read series implies no changes will be done to the database structure (no zone labels added/removed)
* The write series implies changes will be done to the database structure. Most likely a removal of a zone label.
*
* @param db
* @param fqdn/exact_match_origin
* @param owner
* @return
*/
zdb_zone *zdb_acquire_zone_read(zdb *db, const dnsname_vector *exact_match_origin);
zdb_zone *zdb_acquire_zone_read_from_fqdn(zdb *db, const u8 *fqdn);
zdb_zone *zdb_acquire_zone_read_trylock(zdb *db, dnsname_vector *exact_match_origin, u8 owner);
zdb_zone *zdb_acquire_zone_read_trylock_from_name(zdb *db, const char *name, u8 owner);
zdb_zone *zdb_acquire_zone_read_trylock_from_fqdn(zdb *db, const u8 *fqdn, u8 owner);
zdb_zone *zdb_acquire_zone_read_lock(zdb *db, dnsname_vector *exact_match_origin, u8 owner);
zdb_zone *zdb_acquire_zone_read_lock_from_name(zdb *db, const char *name, u8 owner);
zdb_zone *zdb_acquire_zone_read_lock_from_fqdn(zdb *db, const u8 *fqdn, u8 owner);
zdb_zone *zdb_acquire_zone_write_lock(zdb *db, dnsname_vector *exact_match_origin, u8 owner);
zdb_zone *zdb_acquire_zone_write_lock_from_name(zdb *db, const char *name, u8 owner);
zdb_zone *zdb_acquire_zone_write_lock_from_fqdn(zdb *db, const u8 *fqdn, u8 owner);
/**
* The double lock allows the caller to lock a zone for an owner with dibs to change the owner.
* Typically: lock for the simple reader and then change the lock to a writer.
* This is useful when lock-out the readers is not needed yet, but will most likely be in the near future.
*
* ie: lock reader + dynupdate
* verify prerequisites
* do the dry run
* transfer lock to dynupdate
* do the actual update
* unlock
*
* @param db
* @param exact_match_origin
* @param owner
* @param nextowner
* @return
*/
zdb_zone *zdb_acquire_zone_read_double_lock(zdb *db, dnsname_vector *exact_match_origin, u8 owner, u8 nextowner);
zdb_zone *zdb_acquire_zone_read_double_lock_from_name(zdb *db, const char *name, u8 owner, u8 nextowner);
zdb_zone *zdb_acquire_zone_read_double_lock_from_fqdn(zdb *db, const u8 *fqdn, u8 owner, u8 nextowner);
/**
*
* Dereference and unlocks the zone.
* If the RC reached 0, enqueues it for destruction
*
* @param zone
* @param owner
*/
void zdb_zone_acquire(zdb_zone *zone);
void zdb_zone_release(zdb_zone *zone);
void zdb_zone_release_unlock(zdb_zone *zone, u8 owner);
void zdb_zone_release_double_unlock(zdb_zone *zone, u8 owner, u8 nextowner);
/** @} */
|