misc.h File Reference

Various miscellaneous utility functions. More...

#include <freeradius-devel/build.h>
#include <freeradius-devel/missing.h>
#include <freeradius-devel/util/print.h>
#include <freeradius-devel/util/talloc.h>
#include <freeradius-devel/util/time.h>
#include <signal.h>

Include dependency graph for misc.h:

Go to the source code of this file.

Macros
#define	fr_zero_whitespace(_p)   while (isspace((uint8_t) *_p)) *(_p++) = '\0'
	Zero out any whitespace with nul bytes.
#define	VERIFY_ALL_TALLOC

Typedefs
typedef int8_t(*	fr_cmp_t) (void const *a, void const *b)
typedef void(*	fr_free_t) (void *)

Functions
int	fr_blocking (int fd)
int	fr_digest_cmp (uint8_t const *a, uint8_t const *b, size_t length)
	Do a comparison of two authentication digests by comparing the FULL data.
char const *	fr_filename (char const *path)
	Get the filename from a path.
char const *	fr_filename_common_trim (char const *path, char const *common)
	Trim a common prefix from a filename.
int	fr_nonblock (int fd)
int8_t	fr_pointer_cmp (void const *a, void const *b)
	Compares two pointers.
void	fr_quick_sort (void const *to_sort[], int min_idx, int max_idx, fr_cmp_t cmp)
	Quick sort an array of pointers using a comparator.
int	fr_set_signal (int sig, sig_t func)
	Sets a signal handler using sigaction if available, else signal.
size_t	fr_snprint_uint128 (char *out, size_t outlen, uint128_t const num)
	Write 128bit unsigned integer to buffer.
int	fr_strtoll (int64_t *out, char **end, char const *value)
	Consume the integer (or hex) portion of a value string.
int	fr_strtoull (uint64_t *out, char **end, char const *value)
	Consume the integer (or hex) portion of a value string.
char *	fr_tolower (char *str)
char *	fr_trim (char const *str, size_t size)
	Trim whitespace from the end of a string.
int	fr_unset_signal (int sig)
	Uninstall a signal for a specific handler.
ssize_t	fr_utf8_to_ucs2 (uint8_t *out, size_t outlen, char const *in, size_t inlen)
	Convert UTF8 string to UCS2 encoding.
static bool	is_integer (char const *value)
	Check whether the string is all numbers.
static bool	is_printable (void const *value, size_t len)
	Check whether the string is made up of printable UTF8 chars.
static bool	is_whitespace (char const *value)
	Check whether the string is all whitespace.
static bool	is_zero (char const *value)
	Check whether the string is all zeros.
int	rad_lockfd (int fd, int lock_len)
int	rad_lockfd_nonblock (int fd, int lock_len)
int	rad_unlockfd (int fd, int lock_len)

Detailed Description

Various miscellaneous utility functions.

Copyright

2000,2006 The FreeRADIUS server project

Definition in file misc.h.

Macro Definition Documentation

fr_zero_whitespace

#define fr_zero_whitespace

(

_p

)

while (isspace((uint8_t) *_p)) *(_p++) = '\0'

Zero out any whitespace with nul bytes.

Parameters

[in,out]

_p

string to process

Definition at line 59 of file misc.h.

VERIFY_ALL_TALLOC

#define VERIFY_ALL_TALLOC

Definition at line 52 of file misc.h.

Typedef Documentation

fr_cmp_t

typedef int8_t(* fr_cmp_t) (void const *a, void const *b)

Definition at line 38 of file misc.h.

fr_free_t

typedef void(* fr_free_t) (void *)

Definition at line 39 of file misc.h.

Function Documentation

fr_blocking()

int fr_blocking

(

int

fd

)

fr_digest_cmp()

int fr_digest_cmp	(	uint8_t const *	a,
		uint8_t const *	b,
		size_t	length
	)

Do a comparison of two authentication digests by comparing the FULL data.

Otherwise, the server can be subject to timing attacks.

http://www.cs.rice.edu/~dwallach/pub/crosby-timing2009.pdf

Definition at line 473 of file misc.c.

Here is the caller graph for this function:

fr_filename()

char const * fr_filename

(

char const *

path

)

Get the filename from a path.

Parameters

path	to get filename from.

Returns

• pointer to the filename in the path.
• pointer to the path if no '/' is found.

Definition at line 490 of file misc.c.

fr_filename_common_trim()

char const * fr_filename_common_trim	(	char const *	path,
		char const *	common
	)

Trim a common prefix from a filename.

Parameters

path	to get filename from.
common	prefix to trim from the path.

Returns

• pointer to the position on the path where the common prefix match ended.

Definition at line 506 of file misc.c.

fr_nonblock()

int fr_nonblock

(

int

fd

)

fr_pointer_cmp()

int8_t fr_pointer_cmp	(	void const *	a,
		void const *	b
	)

Compares two pointers.

Parameters

a	first pointer to compare.
b	second pointer to compare.

Returns

• -1 if a < b.
• +1 if b > a.
• 0 if both equal.

Definition at line 418 of file misc.c.

Here is the caller graph for this function:

fr_quick_sort()

void fr_quick_sort	(	void const *	to_sort[],
		int	start,
		int	end,
		fr_cmp_t	cmp
	)

Quick sort an array of pointers using a comparator.

Parameters

to_sort	array of pointers to sort.
start	the lowest index (usually 0).
end	the length of the array.
cmp	the comparison function to use to sort the array elements.

Definition at line 430 of file misc.c.

Here is the call graph for this function:

Here is the caller graph for this function:

fr_set_signal()

int fr_set_signal	(	int	sig,
		sig_t	func
	)

Sets a signal handler using sigaction if available, else signal.

Parameters

sig	to set handler for.
func	handler to set.

Definition at line 48 of file misc.c.

Here is the call graph for this function:

Here is the caller graph for this function:

fr_snprint_uint128()

size_t fr_snprint_uint128	(	char *	out,
		size_t	outlen,
		uint128_t const	num
	)

Write 128bit unsigned integer to buffer.

Author

Alexey Frunze

Parameters

out	where to write result to.
outlen	size of out.
num	128 bit integer.

Definition at line 370 of file misc.c.

Here is the call graph for this function:

Here is the caller graph for this function:

fr_strtoll()

int fr_strtoll	(	int64_t *	out,
		char **	end,
		char const *	value
	)

Consume the integer (or hex) portion of a value string.

Allows integer or hex representations of integers (but not octal, as octal is deemed to be confusing).

Note

Check for overflow with errno == ERANGE.

Parameters

[out]	out	Result of parsing string as signed 64bit integer.
[out]	end	pointer to the first non numeric char.
[in]	value	string to parse.

Returns

integer value.

Definition at line 192 of file misc.c.

fr_strtoull()

int fr_strtoull	(	uint64_t *	out,
		char **	end,
		char const *	value
	)

Consume the integer (or hex) portion of a value string.

Allows integer or hex representations of integers (but not octal, as octal is deemed to be confusing).

Parameters

[out]	out	Result of parsing string as unsigned 64bit integer.
[out]	end	pointer to the first non numeric char.
[in]	value	string to parse.

Returns

integer value.

Definition at line 161 of file misc.c.

fr_tolower()

char * fr_tolower

(

char *

str

)

Definition at line 226 of file misc.c.

Here is the caller graph for this function:

fr_trim()

char * fr_trim	(	char const *	str,
		size_t	size
	)

Trim whitespace from the end of a string.

Definition at line 214 of file misc.c.

fr_unset_signal()

int fr_unset_signal

(

int

sig

)

Uninstall a signal for a specific handler.

man sigaction says these are fine to call from a signal handler.

Parameters

sig

SIGNAL

Definition at line 77 of file misc.c.

Here is the caller graph for this function:

fr_utf8_to_ucs2()

ssize_t fr_utf8_to_ucs2	(	uint8_t *	out,
		size_t	outlen,
		char const *	in,
		size_t	inlen
	)

Convert UTF8 string to UCS2 encoding.

Note

Borrowed from src/crypto/ms_funcs.c of wpa_supplicant project (http://hostap.epitest.fi/wpa_supplicant/)

Parameters

[out]	out	Where to write the ucs2 string.
[in]	outlen	Size of output buffer.
[in]	in	UTF8 string to convert.
[in]	inlen	length of UTF8 string.

Returns

the size of the UCS2 string written to the output buffer (in bytes).

Definition at line 316 of file misc.c.

Here is the caller graph for this function:

is_integer()

static bool is_integer ( char const *  value )

inlinestatic

Check whether the string is all numbers.

Returns

• true if the entirety of the string is number chars.
• false if string contains non-numeric chars or is empty.

Definition at line 109 of file misc.h.

Here is the caller graph for this function:

is_printable()

static bool is_printable ( void const *  value, size_t  len  )

inlinestatic

Check whether the string is made up of printable UTF8 chars.

Parameters

value	to check.
len	of value.

Returns

• true if the string is printable.
• false if the string contains non printable chars

Definition at line 88 of file misc.h.

Here is the call graph for this function:

Here is the caller graph for this function:

is_whitespace()

static bool is_whitespace ( char const *  value )

inlinestatic

Check whether the string is all whitespace.

Returns

• true if the entirety of the string is whitespace.
• false if the string contains non whitespace.

Definition at line 67 of file misc.h.

Here is the caller graph for this function:

is_zero()

static bool is_zero ( char const *  value )

inlinestatic

Check whether the string is all zeros.

Returns

• true if the entirety of the string is all zeros.
• false if string contains non-zero chars or is empty.

Definition at line 127 of file misc.h.

rad_lockfd()

int rad_lockfd	(	int	fd,
		int	lock_len
	)

Definition at line 120 of file misc.c.

Here is the call graph for this function:

rad_lockfd_nonblock()

int rad_lockfd_nonblock	(	int	fd,
		int	lock_len
	)

Definition at line 130 of file misc.c.

Here is the call graph for this function:

Here is the caller graph for this function:

rad_unlockfd()

int rad_unlockfd	(	int	fd,
		int	lock_len
	)

Definition at line 142 of file misc.c.

Here is the call graph for this function:

Here is the caller graph for this function: