util.c File Reference

Go to the source code of this file.

Macros

#define LDNS_MOD(x, y)   (((x) % (y) < 0) ? ((x) % (y) + (y)) : ((x) % (y)))
 
#define LDNS_DIV(x, y)   (((x) % (y) < 0) ? ((x) / (y) - 1 ) : ((x) / (y)))
 

Functions

ldns_lookup_tableldns_lookup_by_name (ldns_lookup_table *table, const char *name)
 
ldns_lookup_tableldns_lookup_by_id (ldns_lookup_table *table, int id)
 
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 most bit. More...
 
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 right most bit. More...
 
void ldns_set_bit (uint8_t *byte, int bit_nr, bool value)
 sets the specified bit in the specified byte to 1 if value is true, 0 if false The bits are counted from right to left, so bit #0 is the right most bit. More...
 
int ldns_hexdigit_to_int (char ch)
 Returns the int value of the given (hex) digit. More...
 
char ldns_int_to_hexdigit (int i)
 Returns the char (hex) representation of the given int. More...
 
int ldns_hexstring_to_data (uint8_t *data, const char *str)
 Converts a hex string to binary data. More...
 
const char * ldns_version (void)
 Show the internal library version. More...
 
time_t ldns_mktime_from_utc (const struct tm *tm)
 Convert TM to seconds since epoch (midnight, January 1st, 1970). More...
 
time_t mktime_from_utc (const struct tm *tm)
 
struct tm * ldns_serial_arithmetics_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 arithmetics (rfc1982). More...
 
struct tm * ldns_serial_arithmitics_gmtime_r (int32_t time, time_t now, struct tm *result)
 
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 is available, it is automatically seeded from /dev/urandom or /dev/random. More...
 
uint16_t ldns_get_random (void)
 Get random number. More...
 
char * ldns_bubblebabble (uint8_t *data, size_t len)
 Encode data as BubbleBabble. More...
 
int ldns_b32_ntop (const uint8_t *src, size_t src_sz, char *dst, size_t dst_sz)
 
int ldns_b32_ntop_extended_hex (const uint8_t *src, size_t src_sz, char *dst, size_t dst_sz)
 
int b32_ntop (const uint8_t *src, size_t src_sz, char *dst, size_t dst_sz)
 
int b32_ntop_extended_hex (const uint8_t *src, size_t src_sz, char *dst, size_t dst_sz)
 
int ldns_b32_pton (const char *src, size_t src_sz, uint8_t *dst, size_t dst_sz)
 
int ldns_b32_pton_extended_hex (const char *src, size_t src_sz, uint8_t *dst, size_t dst_sz)
 
int b32_pton (const char *src, size_t src_sz, uint8_t *dst, size_t dst_sz)
 
int b32_pton_extended_hex (const char *src, size_t src_sz, uint8_t *dst, size_t dst_sz)
 

Macro Definition Documentation

◆ LDNS_MOD

#define LDNS_MOD (   x,
 
)    (((x) % (y) < 0) ? ((x) % (y) + (y)) : ((x) % (y)))

Definition at line 170 of file util.c.

◆ LDNS_DIV

#define LDNS_DIV (   x,
 
)    (((x) % (y) < 0) ? ((x) / (y) - 1 ) : ((x) / (y)))

Definition at line 171 of file util.c.

Function Documentation

◆ ldns_lookup_by_name()

ldns_lookup_table* ldns_lookup_by_name ( ldns_lookup_table table,
const char *  name 
)

Definition at line 30 of file util.c.

References ldns_struct_lookup_table::name.

◆ ldns_lookup_by_id()

ldns_lookup_table* ldns_lookup_by_id ( ldns_lookup_table table,
int  id 
)

Definition at line 41 of file util.c.

References ldns_struct_lookup_table::id, and ldns_struct_lookup_table::name.

◆ ldns_get_bit()

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 most bit.

Parameters
[in]bitsarray holding the bits
[in]indexto the wanted bit
Returns

Definition at line 52 of file util.c.

◆ ldns_get_bit_r()

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 right most bit.

Parameters
[in]bitsarray holding the bits
[in]indexto the wanted bit
Returns
1 or 0 depending no the bit state

Definition at line 62 of file util.c.

◆ ldns_set_bit()

void ldns_set_bit ( uint8_t *  byte,
int  bit_nr,
bool  value 
)

sets the specified bit in the specified byte to 1 if value is true, 0 if false The bits are counted from right to left, so bit #0 is the right most bit.

Parameters
[in]bytethe bit to set the bit in
[in]bit_nrthe bit to set (0 <= n <= 7)
[in]valuewhether to set the bit to 1 or 0
Returns
1 or 0 depending no the bit state

Definition at line 72 of file util.c.

◆ ldns_hexdigit_to_int()

int ldns_hexdigit_to_int ( char  ch)

Returns the int value of the given (hex) digit.

Parameters
[in]chthe hex char to convert
Returns
the converted decimal value

Definition at line 88 of file util.c.

◆ ldns_int_to_hexdigit()

char ldns_int_to_hexdigit ( int  ch)

Returns the char (hex) representation of the given int.

Parameters
[in]chthe int to convert
Returns
the converted hex char

Definition at line 113 of file util.c.

◆ ldns_hexstring_to_data()

int ldns_hexstring_to_data ( uint8_t *  data,
const char *  str 
)

Converts a hex string to binary data.

Parameters
[out]dataThe binary result is placed here. At least strlen(str)/2 bytes should be allocated
[in]strThe hex string to convert. This string should not contain spaces
Returns
The number of bytes of converted data, or -1 if one of the arguments * is NULL, or -2 if the string length is not an even number

Definition at line 138 of file util.c.

References ldns_hexdigit_to_int().

◆ ldns_version()

const char* ldns_version ( void  )

Show the internal library version.

Returns
a string with the version in it

Definition at line 160 of file util.c.

References LDNS_VERSION.

◆ ldns_mktime_from_utc()

time_t ldns_mktime_from_utc ( const struct tm *  tm)

Convert TM to seconds since epoch (midnight, January 1st, 1970).

Like timegm(3), which is not always available.

Parameters
[in]tma struct tm* with the date
Returns
the seconds since epoch

Definition at line 194 of file util.c.

◆ mktime_from_utc()

time_t mktime_from_utc ( const struct tm *  tm)

Definition at line 219 of file util.c.

References ldns_mktime_from_utc().

◆ ldns_serial_arithmetics_gmtime_r()

struct tm* ldns_serial_arithmetics_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 arithmetics (rfc1982).

That number of seconds is then converted to broken-out time information. This is especially useful when converting the inception and expiration fields of RRSIG records.

Parameters
[in]timenumber of seconds since epoch (midnight, January 1st, 1970) to be interpreted as a serial arithmetics number relative to now.
[in]nownumber of seconds since epoch (midnight, January 1st, 1970) to which the time value is compared to determine the final value.
[out]resultthe struct with the broken-out time information
Returns
result on success or NULL on error

Definition at line 304 of file util.c.

◆ ldns_serial_arithmitics_gmtime_r()

struct tm* ldns_serial_arithmitics_gmtime_r ( int32_t  time,
time_t  now,
struct tm *  result 
)

Definition at line 320 of file util.c.

References ldns_serial_arithmetics_gmtime_r().

◆ ldns_init_random()

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 is available, it is automatically seeded from /dev/urandom or /dev/random.

Seed the random function.

If you need more entropy, or have no openssl available, this function MUST be called at the start of the program

If openssl is available, this function just adds more entropy

Definition at line 337 of file util.c.

References LDNS_FREE, and LDNS_XMALLOC.

◆ ldns_get_random()

uint16_t ldns_get_random ( void  )

Get random number.

Returns
random number.

Definition at line 410 of file util.c.

◆ ldns_bubblebabble()

char* ldns_bubblebabble ( uint8_t *  data,
size_t  len 
)

Encode data as BubbleBabble.

Parameters
[in]dataa pointer to data to be encoded
[in]lensize the number of bytes of data
Returns
a string of BubbleBabble

Definition at line 428 of file util.c.

References LDNS_XMALLOC.

◆ ldns_b32_ntop()

int ldns_b32_ntop ( const uint8_t *  src,
size_t  src_sz,
char *  dst,
size_t  dst_sz 
)

Definition at line 598 of file util.c.

◆ ldns_b32_ntop_extended_hex()

int ldns_b32_ntop_extended_hex ( const uint8_t *  src,
size_t  src_sz,
char *  dst,
size_t  dst_sz 
)

Definition at line 604 of file util.c.

◆ b32_ntop()

int b32_ntop ( const uint8_t *  src,
size_t  src_sz,
char *  dst,
size_t  dst_sz 
)

Definition at line 613 of file util.c.

◆ b32_ntop_extended_hex()

int b32_ntop_extended_hex ( const uint8_t *  src,
size_t  src_sz,
char *  dst,
size_t  dst_sz 
)

Definition at line 619 of file util.c.

◆ ldns_b32_pton()

int ldns_b32_pton ( const char *  src,
size_t  src_sz,
uint8_t *  dst,
size_t  dst_sz 
)

Definition at line 764 of file util.c.

◆ ldns_b32_pton_extended_hex()

int ldns_b32_pton_extended_hex ( const char *  src,
size_t  src_sz,
uint8_t *  dst,
size_t  dst_sz 
)

Definition at line 770 of file util.c.

◆ b32_pton()

int b32_pton ( const char *  src,
size_t  src_sz,
uint8_t *  dst,
size_t  dst_sz 
)

Definition at line 779 of file util.c.

◆ b32_pton_extended_hex()

int b32_pton_extended_hex ( const char *  src,
size_t  src_sz,
uint8_t *  dst,
size_t  dst_sz 
)

Definition at line 785 of file util.c.