1 /*
2  * Copyright (c) 2009 NLNet Labs. All rights reserved.
3  *
4  * Redistribution and use in source and binary forms, with or without
5  * modification, are permitted provided that the following conditions
6  * are met:
7  * 1. Redistributions of source code must retain the above copyright
8  *    notice, this list of conditions and the following disclaimer.
9  * 2. Redistributions in binary form must reproduce the above copyright
10  *    notice, this list of conditions and the following disclaimer in the
11  *    documentation and/or other materials provided with the distribution.
12  *
13  * THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR
14  * IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
15  * WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
16  * ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY
17  * DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
18  * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE
19  * GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
20  * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER
21  * IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR
22  * OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN
23  * IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
24  *
25  */
26 
27 /**
28  * Domain name database.
29  *
30  */
31 
32 #ifndef SIGNER_IXFR_H
33 #define SIGNER_IXFR_H
34 
35 #include "config.h"
36 #include <ldns/ldns.h>
37 
38 typedef struct part_struct part_type;
39 typedef struct ixfr_struct ixfr_type;
40 
41 #include "locks.h"
42 #include "zone.h"
43 
44 #define IXFR_MAX_PARTS 3
45 
46 /**
47  * Part of IXFR Journal. RRs in soamin and soaplus should be owned
48  * by part and must be freed.
49  *
50  */
51 struct part_struct {
52     ldns_rr* soamin; /* pointer to rr in min */
53     ldns_rr_list* min;
54     ldns_rr* soaplus; /* pointer to rr in min */
55     ldns_rr_list* plus;
56 };
57 
58 /**
59  * IXFR Journal.
60  *
61  */
62 struct ixfr_struct {
63     part_type* part[IXFR_MAX_PARTS];
64     pthread_mutex_t ixfr_lock;
65 };
66 
67 /**
68  * Create a new ixfr journal.
69  * \param[in] zone zone reference
70  * \return ixfr_type* ixfr
71  *
72  */
73 ixfr_type* ixfr_create(void);
74 
75 /**
76  * Add +RR to ixfr journal.
77  * \param[in] ixfr journal
78  * \param[in] rr +RR
79  *
80  */
81 void ixfr_add_rr(ixfr_type* ixfr, ldns_rr* rr);
82 
83 /**
84  * Add -RR to ixfr journal.
85  * \param[in] ixfr journal
86  * \param[in] rr -RR
87  *
88  */
89 void ixfr_del_rr(ixfr_type* ixfr, ldns_rr* rr);
90 
91 /**
92  * Print the ixfr journal.
93  * \param[in] fd file descriptor
94  * \param[in] ixfr journal
95  *
96  */
97 int ixfr_print(FILE* fd, ixfr_type* ixfr);
98 
99 /**
100  * Purge the ixfr journal.
101  * \param[in] ixfr journal
102  *
103  */
104 void ixfr_purge(ixfr_type* ixfr, char const *zonename);
105 
106 /**
107  * Cleanup the ixfr journal.
108  * \param[in] ixfr journal
109  *
110  */
111 void ixfr_cleanup(ixfr_type* ixfr);
112 
113 #endif /* SIGNER_IXFR_H */
114