util.h
Go to the documentation of this file.
1 /*
2  * util.h
3  *
4  * helper function header file
5  *
6  * a Net::DNS like library for C
7  *
8  * (c) NLnet Labs, 2004
9  *
10  * See the file LICENSE for the license
11  */
12 
13 #ifndef _UTIL_H
14 #define _UTIL_H
15 
16 #include <inttypes.h>
17 #include <sys/types.h>
18 #include <unistd.h>
19 #include <ldns/common.h>
20 #include <time.h>
21 #include <stdio.h>
22 
23 #ifdef __cplusplus
24 extern "C" {
25 #endif
26 
27 #define dprintf(X,Y) fprintf(stderr, (X), (Y))
28 /* #define dprintf(X, Y) */
29 
30 #define LDNS_VERSION "1.6.16"
31 #define LDNS_REVISION ((1<<16)|(6<<8)|(16))
32 
36 #ifdef S_SPLINT_S
37 # define INLINE
38 #else
39 # ifdef SWIG
40 # define INLINE static
41 # else
42 # define INLINE static inline
43 # endif
44 #endif
45 
49 #define LDNS_MALLOC(type) LDNS_XMALLOC(type, 1)
50 
51 #define LDNS_XMALLOC(type, count) ((type *) malloc((count) * sizeof(type)))
52 
53 #define LDNS_CALLOC(type, count) ((type *) calloc((count), sizeof(type)))
54 
55 #define LDNS_REALLOC(ptr, type) LDNS_XREALLOC((ptr), type, 1)
56 
57 #define LDNS_XREALLOC(ptr, type, count) \
58  ((type *) realloc((ptr), (count) * sizeof(type)))
59 
60 #define LDNS_FREE(ptr) \
61  do { free((ptr)); (ptr) = NULL; } while (0)
62 
63 #define LDNS_DEP printf("DEPRECATED FUNCTION!\n");
64 
65 /*
66  * Copy data allowing for unaligned accesses in network byte order
67  * (big endian).
68  */
69 INLINE uint16_t
70 ldns_read_uint16(const void *src)
71 {
72 #ifdef ALLOW_UNALIGNED_ACCESSES
73  return ntohs(*(uint16_t *) src);
74 #else
75  uint8_t *p = (uint8_t *) src;
76  return ((uint16_t) p[0] << 8) | (uint16_t) p[1];
77 #endif
78 }
79 
80 INLINE uint32_t
81 ldns_read_uint32(const void *src)
82 {
83 #ifdef ALLOW_UNALIGNED_ACCESSES
84  return ntohl(*(uint32_t *) src);
85 #else
86  uint8_t *p = (uint8_t *) src;
87  return ( ((uint32_t) p[0] << 24)
88  | ((uint32_t) p[1] << 16)
89  | ((uint32_t) p[2] << 8)
90  | (uint32_t) p[3]);
91 #endif
92 }
93 
94 /*
95  * Copy data allowing for unaligned accesses in network byte order
96  * (big endian).
97  */
98 INLINE void
99 ldns_write_uint16(void *dst, uint16_t data)
100 {
101 #ifdef ALLOW_UNALIGNED_ACCESSES
102  * (uint16_t *) dst = htons(data);
103 #else
104  uint8_t *p = (uint8_t *) dst;
105  p[0] = (uint8_t) ((data >> 8) & 0xff);
106  p[1] = (uint8_t) (data & 0xff);
107 #endif
108 }
109 
110 INLINE void
111 ldns_write_uint32(void *dst, uint32_t data)
112 {
113 #ifdef ALLOW_UNALIGNED_ACCESSES
114  * (uint32_t *) dst = htonl(data);
115 #else
116  uint8_t *p = (uint8_t *) dst;
117  p[0] = (uint8_t) ((data >> 24) & 0xff);
118  p[1] = (uint8_t) ((data >> 16) & 0xff);
119  p[2] = (uint8_t) ((data >> 8) & 0xff);
120  p[3] = (uint8_t) (data & 0xff);
121 #endif
122 }
123 
124 /* warning. */
125 INLINE void
126 ldns_write_uint64_as_uint48(void *dst, uint64_t data)
127 {
128  uint8_t *p = (uint8_t *) dst;
129  p[0] = (uint8_t) ((data >> 40) & 0xff);
130  p[1] = (uint8_t) ((data >> 32) & 0xff);
131  p[2] = (uint8_t) ((data >> 24) & 0xff);
132  p[3] = (uint8_t) ((data >> 16) & 0xff);
133  p[4] = (uint8_t) ((data >> 8) & 0xff);
134  p[5] = (uint8_t) (data & 0xff);
135 }
136 
137 
147 };
148 
157  int id;
158  const char *name;
159 };
161 
169  const char *name);
170 
178 
187 int ldns_get_bit(uint8_t bits[], size_t index);
188 
189 
198 int ldns_get_bit_r(uint8_t bits[], size_t index);
199 
210 void ldns_set_bit(uint8_t *byte, int bit_nr, bool value);
211 
216 /*@unused@*/
217 INLINE long
218 ldns_power(long a, long b) {
219  long result = 1;
220  while (b > 0) {
221  if (b & 1) {
222  result *= a;
223  if (b == 1) {
224  return result;
225  }
226  }
227  a *= a;
228  b /= 2;
229  }
230  return result;
231 }
232 
238 int ldns_hexdigit_to_int(char ch);
239 
245 char ldns_int_to_hexdigit(int ch);
246 
256 int
257 ldns_hexstring_to_data(uint8_t *data, const char *str);
258 
263 const char * ldns_version(void);
264 
271 time_t ldns_mktime_from_utc(const struct tm *tm);
272 
273 time_t mktime_from_utc(const struct tm *tm);
274 
289 struct tm * ldns_serial_arithmitics_gmtime_r(int32_t time, time_t now, struct tm *result);
290 
310 int ldns_init_random(FILE *fd, unsigned int size);
311 
317 uint16_t ldns_get_random(void);
318 
326 char *ldns_bubblebabble(uint8_t *data, size_t len);
327 
328 #ifndef B32_NTOP
329 int ldns_b32_ntop(uint8_t const *src, size_t srclength,
330  char *target, size_t targsize);
331 int b32_ntop(uint8_t const *src, size_t srclength,
332  char *target, size_t targsize);
333 int ldns_b32_ntop_extended_hex(uint8_t const *src, size_t srclength,
334  char *target, size_t targsize);
335 int b32_ntop_extended_hex(uint8_t const *src, size_t srclength,
336  char *target, size_t targsize);
340 /*@unused@*/
341 INLINE size_t ldns_b32_ntop_calculate_size(size_t srcsize)
342 {
343  size_t result = ((((srcsize / 5) * 8) - 2) + 2);
344  return result;
345 }
346 #endif /* !B32_NTOP */
347 #ifndef B32_PTON
348 int ldns_b32_pton(char const *src, size_t hashed_owner_str_len, uint8_t *target, size_t targsize);
349 int b32_pton(char const *src, size_t hashed_owner_str_len, uint8_t *target, size_t targsize);
350 int ldns_b32_pton_extended_hex(char const *src, size_t hashed_owner_str_len, uint8_t *target, size_t targsize);
351 int b32_pton_extended_hex(char const *src, size_t hashed_owner_str_len, uint8_t *target, size_t targsize);
355 /*@unused@*/
356 INLINE size_t ldns_b32_pton_calculate_size(size_t srcsize)
357 {
358  size_t result = ((((srcsize) / 8) * 5));
359  return result;
360 }
361 #endif /* !B32_PTON */
362 
363 INLINE time_t ldns_time(time_t *t) { return time(t); }
364 
365 #ifdef __cplusplus
366 }
367 #endif
368 
369 #endif /* !_UTIL_H */
int ldns_b32_pton(char const *src, size_t hashed_owner_str_len, uint8_t *target, size_t targsize)
time_t mktime_from_utc(const struct tm *tm)
Definition: util.c:255
void ldns_set_bit(uint8_t *byte, int bit_nr, bool value)
Definition: util.c:108
char * ldns_bubblebabble(uint8_t *data, size_t len)
Encode data as BubbleBabble.
Definition: util.c:454
char ldns_int_to_hexdigit(int i)
Returns the char (hex) representation of the given int.
Definition: util.c:149
int ldns_get_bit_r(uint8_t bits[], size_t index)
Returns the value of the specified bit The bits are counted from right to left, so bit #0 is the righ...
Definition: util.c:98
time_t ldns_mktime_from_utc(const struct tm *tm)
Convert TM to seconds since epoch (midnight, January 1st, 1970).
Definition: util.c:230
struct tm * ldns_serial_arithmitics_gmtime_r(int32_t time, time_t now, struct tm *result)
The function interprets time as the number of seconds since epoch with respect to now using serial ar...
Definition: util.c:340
int b32_ntop_extended_hex(uint8_t const *src, size_t srclength, char *target, size_t targsize)
#define INLINE
splint static inline workaround
Definition: util.h:42
uint16_t ldns_get_random(void)
Get random number.
Definition: util.c:436
const char * ldns_version(void)
Show the internal library version.
Definition: util.c:196
int b32_ntop(uint8_t const *src, size_t srclength, char *target, size_t targsize)
int ldns_init_random(FILE *fd, unsigned int size)
Init the random source applications should call this if they need entropy data within ldns If openSSL...
Definition: util.c:363
Structure to do a Schwartzian-like transformation, for instance when sorting.
Definition: util.h:144
ldns_lookup_table * ldns_lookup_by_id(ldns_lookup_table *table, int id)
Definition: util.c:77
const char * name
Definition: util.h:158
int ldns_b32_ntop_extended_hex(uint8_t const *src, size_t srclength, char *target, size_t targsize)
A general purpose lookup table.
Definition: util.h:156
int ldns_b32_pton_extended_hex(char const *src, size_t hashed_owner_str_len, uint8_t *target, size_t targsize)
int ldns_hexstring_to_data(uint8_t *data, const char *str)
Converts a hex string to binary data.
Definition: util.c:174
int b32_pton_extended_hex(char const *src, size_t hashed_owner_str_len, uint8_t *target, size_t targsize)
int ldns_hexdigit_to_int(char ch)
Returns the int value of the given (hex) digit.
Definition: util.c:124
ldns_lookup_table * ldns_lookup_by_name(ldns_lookup_table *table, const char *name)
Definition: util.c:66
int ldns_get_bit(uint8_t bits[], size_t index)
Returns the value of the specified bit The bits are counted from left to right, so bit #0 is the left...
Definition: util.c:88
Common definitions for LDNS.
int b32_pton(char const *src, size_t hashed_owner_str_len, uint8_t *target, size_t targsize)
dsa p
Definition: keys.c:683
int ldns_b32_ntop(uint8_t const *src, size_t srclength, char *target, size_t targsize)