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
125
126
127
|
/*
* Copyright (c) 2009 NLNet Labs. All rights reserved.
*
* Redistribution and use in source and binary forms, with or without
* modification, are permitted provided that the following conditions
* are met:
* 1. Redistributions of source code must retain the above copyright
* notice, this list of conditions and the following disclaimer.
* 2. 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.
*
* THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``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 AUTHOR 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.
*
*/
/**
*
* Utility tools.
*/
#ifndef UTIL_UTIL_H
#define UTIL_UTIL_H
#include "config.h"
#include "status.h"
#ifdef HAVE_SYS_TYPES_H
# include <sys/types.h>
#endif
#ifdef HAVE_UNISTD_H
# include <unistd.h>
#endif
#include <ldns/ldns.h>
#define SE_SOA_RDATA_SERIAL 2
#define SE_SOA_RDATA_EXPIRE 5
#define SE_SOA_RDATA_MINIMUM 6
/* copycode: This define is taken from BIND9 */
#define DNS_SERIAL_GT(a, b) ((int)(((a) - (b)) & 0xFFFFFFFF) > 0)
/**
* Check if a RR is a DNSSEC RR (RRSIG, NSEC, NSEC3 or NSEC3PARAMS).
* \param[in] rr RR
* \return int 1 on true, 0 on false
*
*/
int util_is_dnssec_rr(ldns_rr* rr);
/**
* Compare SERIALs.
* \param serial_new new SERIAL value
* \param serial_old old SERIAL value
* \return int 0 if the new SERIAL <= old SERIAL, non-zero otherwise
*
*/
int util_serial_gt(uint32_t serial_new, uint32_t serial_old);
/**
* Compare RRs only on RDATA.
* \param[in] rr1 RR
* \param[in] rr2 another RR
* \param[out] cmp compare value
* \return status compare status
*
*/
ldns_status util_dnssec_rrs_compare(ldns_rr* rr1, ldns_rr* rr2, int* cmp);
/**
* Check process id file.
* \param[in] pidfile pid filename
* \return int status (0 if process id in pidfile is running)
*
*/
int util_check_pidfile(const char* pidfile);
/**
* Write process id to file.
* \param[in] pidfile pid filename
* \param[in] pid process id
* \return int status
*
*/
int util_write_pidfile(const char* pidfile, pid_t pid);
/**
* Print an LDNS RR, check status.
* \param[in] fd file descriptor
* \param[in] rr RR
* \return ods_status status
*
*/
ods_status util_rr_print(FILE* fd, const ldns_rr* rr);
/**
* Calculates the size needed to store the result of b64_pton.
* \param[in] len strlen
* \return size of b64_pton
*
*/
size_t util_b64_pton_calculate_size(size_t srcsize);
/**
* Check pidfile
*
* Try to read PID file to see if an other instance is already running.
* If pidfile not found or process is not running exit success. Note:
* upon failures reading the file
*
* \param pidfile: file to check.
* \return 1 pidfile does not exist or process not running. 0 otherwise.
*/
int util_pidfile_avail(const char* pidfile);
#endif /* UTIL_UTIL_H */
|
