Boxed value structures and functions to manipulate them. More...

#include <freeradius-devel/util/value.h>
#include <freeradius-devel/util/atexit.h>
#include <freeradius-devel/util/base16.h>
#include <freeradius-devel/util/dcursor.h>
#include <freeradius-devel/util/size.h>
#include <freeradius-devel/util/time.h>
#include <math.h>

Include dependency graph for value.c:

Go to the source code of this file.

Macros
#define	_VALUE_PRIVATE

#define	CAST_IP_FIX_COMBO

#define	COMPARE(_type) return CMP(memcmp(&a->datum._type, &b->datum._type, sizeof(a->datum._type)), 0)

#define	INFO_INDENT(_fmt, ...) FR_FAULT_LOG("%s"_fmt, depth 2, " ", ## __VA_ARGS__)

#define	network_max_size(_x) (fr_value_box_network_sizes[_x][1])

#define	network_min_size(_x) (fr_value_box_network_sizes[_x][0])
	Sanity checks. More...

#define	RETURN(_type) return CMP(a->datum._type, b->datum._type)

#define	SIGN_BIT_HIGH(_int, _len) ((((uint64_t)1) << (((_len) << 3) - 1)) & (_int))

#define	SIGN_PROMOTE(_int, _len)

Functions
static void	_fr_value_box_debug (fr_value_box_t const *vb, int depth, int idx)

static void	_fr_value_box_list_debug (fr_value_box_list_t const *head, int depth)

void	_fr_value_box_mark_safe_for (fr_value_box_t *vb, fr_value_box_safe_for_t safe_for)
	Mark a value-box as "safe", of a particular type. More...

return	fr_dbuff_set (dbuff, &our_dbuff)

int	fr_regex_cmp_op (fr_token_t op, fr_value_box_t const a, fr_value_box_t const b)
	Compare two boxes using an operator. More...

	FR_SBUFF_SET_RETURN (sbuff, &our_sbuff)

int	fr_value_box_asprintf (TALLOC_CTX ctx, fr_value_box_t dst, fr_dict_attr_t const enumv, bool tainted, char const fmt,...)
	Print a formatted string using our internal printf wrapper and assign it to a value box. More...

int	fr_value_box_bstr_alloc (TALLOC_CTX ctx, char out, fr_value_box_t dst, fr_dict_attr_t const *enumv, size_t len, bool tainted)
	Alloc and assign an empty \0 terminated string to a fr_value_box_t. More...

int	fr_value_box_bstr_append_buffer (TALLOC_CTX ctx, fr_value_box_t dst, char const *src, bool tainted)
	Append a talloced buffer to an existing fr_value_box_t. More...

int	fr_value_box_bstr_realloc (TALLOC_CTX ctx, char out, fr_value_box_t dst, size_t len)
	Change the length of a buffer already allocated to a value box. More...

int	fr_value_box_bstrdup_buffer (TALLOC_CTX ctx, fr_value_box_t dst, fr_dict_attr_t const enumv, char const src, bool tainted)
	Copy a nul terminated talloced buffer to a fr_value_box_t. More...

int	fr_value_box_bstrdup_buffer_shallow (TALLOC_CTX ctx, fr_value_box_t dst, fr_dict_attr_t const enumv, char const src, bool tainted)
	Assign a talloced buffer containing a nul terminated string to a box, but don't copy it. More...

int	fr_value_box_bstrn_append (TALLOC_CTX ctx, fr_value_box_t dst, char const *src, size_t len, bool tainted)
	Append bytes from a buffer to an existing fr_value_box_t. More...

int	fr_value_box_bstrndup (TALLOC_CTX ctx, fr_value_box_t dst, fr_dict_attr_t const enumv, char const src, size_t len, bool tainted)
	Copy a string to to a fr_value_box_t. More...

int	fr_value_box_bstrndup_dbuff (TALLOC_CTX ctx, fr_value_box_t dst, fr_dict_attr_t const enumv, fr_dbuff_t dbuff, size_t len, bool tainted)

void	fr_value_box_bstrndup_shallow (fr_value_box_t dst, fr_dict_attr_t const enumv, char const *src, size_t len, bool tainted)
	Assign a string to to a fr_value_box_t. More...

int	fr_value_box_cast (TALLOC_CTX ctx, fr_value_box_t dst, fr_type_t dst_type, fr_dict_attr_t const dst_enumv, fr_value_box_t const src)
	Convert one type of fr_value_box_t to another. More...

int	fr_value_box_cast_in_place (TALLOC_CTX ctx, fr_value_box_t vb, fr_type_t dst_type, fr_dict_attr_t const *dst_enumv)
	Convert one type of fr_value_box_t to another in place. More...

static int	fr_value_box_cast_integer_to_integer (UNUSED TALLOC_CTX ctx, fr_value_box_t dst, fr_type_t dst_type, fr_dict_attr_t const dst_enumv, fr_value_box_t const src)
	Convert any signed or unsigned integer type to any other signed or unsigned integer type. More...

static int	fr_value_box_cast_to_bool (TALLOC_CTX ctx, fr_value_box_t dst, fr_type_t dst_type, fr_dict_attr_t const dst_enumv, fr_value_box_t const src)
	Convert any supported type to a bool. More...

static int	fr_value_box_cast_to_ethernet (TALLOC_CTX ctx, fr_value_box_t dst, fr_type_t dst_type, fr_dict_attr_t const dst_enumv, fr_value_box_t const src)
	Convert any supported type to an ethernet address. More...

static int	fr_value_box_cast_to_float (UNUSED TALLOC_CTX ctx, fr_value_box_t dst, fr_type_t dst_type, fr_dict_attr_t const dst_enumv, fr_value_box_t const src)
	Convert any value to a floating point value. More...

static int	fr_value_box_cast_to_integer (TALLOC_CTX ctx, fr_value_box_t dst, fr_type_t dst_type, fr_dict_attr_t const dst_enumv, fr_value_box_t const src)
	Convert any value to a signed or unsigned integer. More...

static int	fr_value_box_cast_to_ipv4addr (TALLOC_CTX ctx, fr_value_box_t dst, fr_type_t dst_type, fr_dict_attr_t const dst_enumv, fr_value_box_t const src)
	Convert any supported type to an IPv4 address. More...

static int	fr_value_box_cast_to_ipv4prefix (TALLOC_CTX ctx, fr_value_box_t dst, fr_type_t dst_type, fr_dict_attr_t const dst_enumv, fr_value_box_t const src)
	Convert any supported type to an IPv6 address. More...

static int	fr_value_box_cast_to_ipv6addr (TALLOC_CTX ctx, fr_value_box_t dst, fr_type_t dst_type, fr_dict_attr_t const dst_enumv, fr_value_box_t const src)
	Convert any supported type to an IPv6 address. More...

static int	fr_value_box_cast_to_ipv6prefix (TALLOC_CTX ctx, fr_value_box_t dst, fr_type_t dst_type, fr_dict_attr_t const dst_enumv, fr_value_box_t const src)
	Convert any supported type to an IPv6 address. More...

static int	fr_value_box_cast_to_octets (TALLOC_CTX ctx, fr_value_box_t dst, fr_type_t dst_type, fr_dict_attr_t const dst_enumv, fr_value_box_t const src)
	Convert any supported type to octets. More...

static int	fr_value_box_cast_to_strvalue (TALLOC_CTX ctx, fr_value_box_t dst, fr_type_t dst_type, fr_dict_attr_t const dst_enumv, fr_value_box_t const src)
	Convert any supported type to a string. More...

static int	fr_value_box_cidr_cmp_op (fr_token_t op, int bytes, uint8_t a_net, uint8_t const a, uint8_t b_net, uint8_t const b)

void	fr_value_box_clear (fr_value_box_t *data)
	Clear/free any existing value and metadata. More...

void	fr_value_box_clear_value (fr_value_box_t *data)
	Clear/free any existing value. More...

int8_t	fr_value_box_cmp (fr_value_box_t const a, fr_value_box_t const b)
	Compare two values. More...

int	fr_value_box_cmp_op (fr_token_t op, fr_value_box_t const a, fr_value_box_t const b)
	Compare two attributes using an operator. More...

int	fr_value_box_copy (TALLOC_CTX ctx, fr_value_box_t dst, const fr_value_box_t *src)
	Copy value data verbatim duplicating any buffers. More...

static void	fr_value_box_copy_meta (fr_value_box_t dst, fr_value_box_t const src)
	Copy flags and type data from one value box to another. More...

void	fr_value_box_copy_shallow (TALLOC_CTX ctx, fr_value_box_t dst, fr_value_box_t const *src)
	Perform a shallow copy of a value_box. More...

void	fr_value_box_debug (fr_value_box_t const *vb)
	Print the value of a box as info messages. More...

int	fr_value_box_escape_in_place (fr_value_box_t vb, fr_value_box_escape_t escape, fr_value_box_safe_for_t safe_for, void uctx)
	Escape a single value box in place. More...

static int	fr_value_box_fixed_size_from_octets (fr_value_box_t dst, fr_type_t dst_type, fr_dict_attr_t const dst_enumv, fr_value_box_t const *src)
	Convert octets to a fixed size value box value. More...

void	fr_value_box_flatten (TALLOC_CTX ctx, fr_value_box_list_t list, bool steal, bool free)
	Removes a single layer of nesting, moving all children into the parent list. More...

ssize_t	fr_value_box_from_network (TALLOC_CTX ctx, fr_value_box_t dst, fr_type_t type, fr_dict_attr_t const enumv, fr_dbuff_t dbuff, size_t len, bool tainted)
	Decode a fr_value_box_t from serialized binary data. More...

static fr_slen_t	fr_value_box_from_numeric_substr (fr_value_box_t dst, fr_type_t dst_type, fr_dict_attr_t const dst_enumv, fr_sbuff_t in, fr_sbuff_parse_rules_t const rules, bool tainted)
	Convert integer encoded as string to a fr_value_box_t type. More...

ssize_t	fr_value_box_from_str (TALLOC_CTX ctx, fr_value_box_t dst, fr_type_t dst_type, fr_dict_attr_t const dst_enumv, char const in, size_t inlen, fr_sbuff_unescape_rules_t const *erules, bool tainted)

ssize_t	fr_value_box_from_substr (TALLOC_CTX ctx, fr_value_box_t dst, fr_type_t dst_type, fr_dict_attr_t const dst_enumv, fr_sbuff_t in, fr_sbuff_parse_rules_t const *rules, bool tainted)
	Convert string value to a fr_value_box_t type. More...

uint32_t	fr_value_box_hash (fr_value_box_t const *vb)
	Hash the contents of a value box. More...

int	fr_value_box_hton (fr_value_box_t dst, fr_value_box_t const src)
	Performs byte order reversal for types that need it. More...

void	fr_value_box_increment (fr_value_box_t *vb)
	Increment a boxed value. More...

int	fr_value_box_ipaddr (fr_value_box_t dst, fr_dict_attr_t const enumv, fr_ipaddr_t const *ipaddr, bool tainted)
	Assign a fr_value_box_t value from an fr_ipaddr_t. More...

bool	fr_value_box_is_truthy (fr_value_box_t const *in)
	Check truthiness of values. More...

int	fr_value_box_list_acopy (TALLOC_CTX ctx, fr_value_box_list_t out, fr_value_box_list_t const *in)
	Do a full copy of a list of value boxes. More...

char *	fr_value_box_list_aprint (TALLOC_CTX ctx, fr_value_box_list_t const list, char const delim, fr_sbuff_escape_rules_t const e_rules)
	Concatenate the string representations of a list of value boxes together. More...

char *	fr_value_box_list_aprint_secure (TALLOC_CTX ctx, fr_value_box_list_t const list, char const delim, fr_sbuff_escape_rules_t const e_rules)
	Concatenate the string representations of a list of value boxes together hiding "secret" values. More...

ssize_t	fr_value_box_list_concat_as_octets (bool tainted, bool secret, fr_dbuff_t dbuff, fr_value_box_list_t list, uint8_t const *sep, size_t sep_len, fr_value_box_list_action_t proc_action, bool flatten)
	Concatenate a list of value boxes together. More...

ssize_t	fr_value_box_list_concat_as_string (bool tainted, bool secret, fr_sbuff_t sbuff, fr_value_box_list_t list, char const sep, size_t sep_len, fr_sbuff_escape_rules_t const e_rules, fr_value_box_list_action_t proc_action, bool flatten)
	Concatenate a list of value boxes together. More...

int	fr_value_box_list_concat_in_place (TALLOC_CTX ctx, fr_value_box_t out, fr_value_box_list_t *list, fr_type_t type, fr_value_box_list_action_t proc_action, bool flatten, size_t max_size)
	Concatenate a list of value boxes. More...

void	fr_value_box_list_debug (fr_value_box_list_t const *head)
	Print a list of value boxes as info messages. More...

int	fr_value_box_list_escape_in_place (fr_value_box_list_t list, fr_value_box_escape_t escape, fr_value_box_safe_for_t safe_for, void uctx)
	Escape a list of value boxes in place. More...

void	fr_value_box_list_mark_safe_for (fr_value_box_list_t *list, fr_value_box_safe_for_t safe_for)
	Set the escaped flag for all value boxes in a list. More...

void	fr_value_box_list_taint (fr_value_box_list_t *head)
	Taint every list member (and their children) More...

bool	fr_value_box_list_tainted (fr_value_box_list_t const *head)
	Check to see if any list members (or their children) are tainted. More...

void	fr_value_box_list_untaint (fr_value_box_list_t *head)
	Untaint every list member (and their children) More...

void	fr_value_box_list_verify (char const file, int line, fr_value_box_list_t const list)

void	fr_value_box_mark_unsafe (fr_value_box_t *vb)
	Mark a value-box as "unsafe". More...

int	fr_value_box_mem_alloc (TALLOC_CTX ctx, uint8_t out, fr_value_box_t dst, fr_dict_attr_t const *enumv, size_t len, bool tainted)
	Pre-allocate an octets buffer for filling by the caller. More...

int	fr_value_box_mem_append (TALLOC_CTX ctx, fr_value_box_t dst, uint8_t const *src, size_t len, bool tainted)
	Append data to an existing fr_value_box_t. More...

int	fr_value_box_mem_append_buffer (TALLOC_CTX ctx, fr_value_box_t dst, uint8_t const *src, bool tainted)
	Append a talloc buffer to an existing fr_value_box_t. More...

int	fr_value_box_mem_realloc (TALLOC_CTX ctx, uint8_t out, fr_value_box_t dst, size_t len)
	Change the length of a buffer already allocated to a value box. More...

int	fr_value_box_memdup (TALLOC_CTX ctx, fr_value_box_t dst, fr_dict_attr_t const enumv, uint8_t const src, size_t len, bool tainted)
	Copy a buffer to a fr_value_box_t. More...

int	fr_value_box_memdup_buffer (TALLOC_CTX ctx, fr_value_box_t dst, fr_dict_attr_t const enumv, uint8_t const src, bool tainted)
	Copy a talloced buffer to a fr_value_box_t. More...

void	fr_value_box_memdup_buffer_shallow (TALLOC_CTX ctx, fr_value_box_t dst, fr_dict_attr_t const enumv, uint8_t const src, bool tainted)
	Assign a talloced buffer to a box, but don't copy it. More...

int	fr_value_box_memdup_dbuff (TALLOC_CTX ctx, fr_value_box_t dst, fr_dict_attr_t const enumv, fr_dbuff_t dbuff, size_t len, bool tainted)

void	fr_value_box_memdup_shallow (fr_value_box_t dst, fr_dict_attr_t const enumv, uint8_t const *src, size_t len, bool tainted)
	Assign a buffer to a box, but don't copy it. More...

size_t	fr_value_box_network_length (fr_value_box_t const *value)
	Get the size of the value held by the fr_value_box_t. More...

ssize_t	fr_value_box_print (fr_sbuff_t out, fr_value_box_t const data, fr_sbuff_escape_rules_t const *e_rules)
	Print one boxed value to a string. More...

ssize_t	fr_value_box_print_quoted (fr_sbuff_t out, fr_value_box_t const data, fr_token_t quote)
	Print one boxed value to a string with quotes (where needed) More...

int	fr_value_box_steal (TALLOC_CTX ctx, fr_value_box_t dst, fr_value_box_t *src)
	Copy value data verbatim moving any buffers to the specified context. More...

int	fr_value_box_strdup (TALLOC_CTX ctx, fr_value_box_t dst, fr_dict_attr_t const enumv, char const src, bool tainted)
	Copy a nul terminated string to a fr_value_box_t. More...

void	fr_value_box_strdup_shallow (fr_value_box_t dst, fr_dict_attr_t const enumv, char const *src, bool tainted)
	Assign a buffer containing a nul terminated string to a box, but don't copy it. More...

void	fr_value_box_strdup_shallow_replace (fr_value_box_t vb, char const src, ssize_t len)
	Free the existing buffer (if talloced) associated with the valuebox, and replace it with a new one. More...

int	fr_value_box_strtrim (TALLOC_CTX ctx, fr_value_box_t vb)
	Trim the length of the string buffer to match the length of the C string. More...

int	fr_value_box_to_key (uint8_t *out, size_t outlen, fr_value_box_t const *value)
	Get a key from a value box. More...

ssize_t	fr_value_box_to_network (fr_dbuff_t dbuff, fr_value_box_t const value)
	Encode a single value box, serializing its contents in generic network format. More...

int	fr_value_box_vasprintf (TALLOC_CTX ctx, fr_value_box_t dst, fr_dict_attr_t const enumv, bool tainted, char const fmt, va_list ap)
	Print a formatted string using our internal printf wrapper and assign it to a value box. More...

void	fr_value_box_verify (char const file, int line, fr_value_box_t const vb)
	Validation function to check that a fr_value_box_t is correctly initialised. More...

size_t	fr_value_str_unescape (fr_sbuff_t out, fr_sbuff_t in, size_t inlen, char quote)
	Convert a string value with escape sequences into its binary form. More...

size_t	fr_value_substr_unescape (fr_sbuff_t out, fr_sbuff_t in, size_t inlen, char quote)
	Convert a string value with escape sequences into its binary form. More...

int	fr_value_unbox_ipaddr (fr_ipaddr_t dst, fr_value_box_t src)
	Unbox an IP address performing a type check. More...

Variables
size_t const	fr_value_box_field_sizes []
	How many bytes wide each of the value data fields are. More...

static uint64_t const	fr_value_box_integer_max []

static int64_t const	fr_value_box_integer_min []

static size_t const	fr_value_box_network_sizes [FR_TYPE_MAX+1][2]

size_t const	fr_value_box_offsets []
	Where the value starts in the fr_value_box_t. More...

fr_sbuff_escape_rules_t	fr_value_escape_backtick

fr_sbuff_escape_rules_t *	fr_value_escape_by_char [UINT8_MAX+1]

fr_sbuff_escape_rules_t *	fr_value_escape_by_quote [T_TOKEN_LAST]

fr_sbuff_escape_rules_t	fr_value_escape_double

fr_sbuff_escape_rules_t	fr_value_escape_secret
	Escape secret fields by simply mashing all data to '. More...

fr_sbuff_escape_rules_t	fr_value_escape_single

fr_sbuff_escape_rules_t	fr_value_escape_solidus

fr_sbuff_escape_rules_t	fr_value_escape_unprintables

fr_sbuff_unescape_rules_t	fr_value_unescape_backtick

fr_sbuff_unescape_rules_t *	fr_value_unescape_by_char [UINT8_MAX+1]

fr_sbuff_unescape_rules_t *	fr_value_unescape_by_quote [T_TOKEN_LAST]

fr_sbuff_unescape_rules_t	fr_value_unescape_double

fr_sbuff_unescape_rules_t	fr_value_unescape_single

fr_sbuff_unescape_rules_t	fr_value_unescape_solidus

static uint8_t const	v4_v6_map []
	v4 to v6 mapping prefix More...

Produce a #tmpl_t from a string or substring
fr_sbuff_parse_rules_t const	value_parse_rules_backtick_quoted

fr_sbuff_parse_rules_t const	value_parse_rules_backtick_unquoted

fr_sbuff_parse_rules_t const	value_parse_rules_bareword_quoted

fr_sbuff_parse_rules_t const	value_parse_rules_bareword_unquoted
	Default formatting rules. More...

fr_sbuff_parse_rules_t const	value_parse_rules_double_quoted

fr_sbuff_parse_rules_t const	value_parse_rules_double_unquoted

fr_sbuff_parse_rules_t const *	value_parse_rules_quoted [T_TOKEN_LAST]
	Parse rules for quoted strings. More...

fr_sbuff_parse_rules_t const *	value_parse_rules_quoted_char [UINT8_MAX]

fr_sbuff_parse_rules_t const	value_parse_rules_single_quoted

fr_sbuff_parse_rules_t const	value_parse_rules_single_unquoted

fr_sbuff_parse_rules_t const	value_parse_rules_solidus_quoted

fr_sbuff_parse_rules_t const	value_parse_rules_solidus_unquoted

fr_sbuff_parse_rules_t const *	value_parse_rules_unquoted [T_TOKEN_LAST]
	Parse rules for non-quoted strings. More...

fr_sbuff_parse_rules_t const *	value_parse_rules_unquoted_char [UINT8_MAX]

Detailed Description

Boxed value structures and functions to manipulate them.

There are three notional data formats used in the server:

fr_value_box_t are the INTERNAL format. This is usually close to the in-memory representation of the data, though uint32s and IPs are always converted to/from octets with BIG ENDIAN uint8 ordering for consistency.
- fr_value_box_cast is used to convert (cast) fr_value_box_t between INTERNAL formats.
- fr_value_box_strdup* is used to ingest nul terminated strings into the INTERNAL format.
- fr_value_box_memdup* is used to ingest binary data into the INTERNAL format.
NETWORK format is the format we send/receive on the wire. It is not a perfect representation of data packing for all protocols, so you will likely need to overload conversion for some types.
- fr_value_box_to_network is used to convert INTERNAL format data to generic NETWORK format data. For uint32s, IP addresses etc... This means BIG ENDIAN uint8 ordering.
- fr_value_box_from_network is used to convert packet buffer fragments in NETWORK format to INTERNAL format.
PRESENTATION format is what we print to the screen, and what we get from the user, databases and configuration files.
- fr_value_box_aprint is used to convert from INTERNAL to PRESENTATION format.
- fr_value_box_from_substr is used to convert from PRESENTATION to INTERNAL format.

Copyright: 2014-2017 The FreeRADIUS server project; 2017 Arran Cudbard-Bell (a.cud.nosp@m.bard.nosp@m.b@fre.nosp@m.erad.nosp@m.ius.o.nosp@m.rg)

Definition in file value.c.

Macro Definition Documentation

◆ _VALUE_PRIVATE

#define _VALUE_PRIVATE

Definition at line 47 of file value.c.

◆ CAST_IP_FIX_COMBO

#define CAST_IP_FIX_COMBO

Value:

        case FR_TYPE_COMBO_IP_ADDR: \
                if (src->vb_ip.af == AF_INET) { \
                        src_type = FR_TYPE_IPV4_ADDR; \
                } else if (src->vb_ip.af == AF_INET6) { \
                        src_type = FR_TYPE_IPV6_ADDR; \
                } \
                break; \
        case FR_TYPE_COMBO_IP_PREFIX: \
                if (src->vb_ip.af == AF_INET) { \
                        src_type = FR_TYPE_IPV4_PREFIX; \
                } else if (src->vb_ip.af == AF_INET6) { \
                        src_type = FR_TYPE_IPV6_PREFIX; \
                } \
                break

Definition at line 2295 of file value.c.

◆ COMPARE

#define COMPARE ( _type ) return CMP(memcmp(&a->datum._type, &b->datum._type, sizeof(a->datum._type)), 0)

◆ INFO_INDENT

#define INFO_INDENT	(	_fmt,
		...
	)	FR_FAULT_LOG("%s"_fmt, depth 2, " ", ## __VA_ARGS__)

Definition at line 6308 of file value.c.

◆ network_max_size

#define network_max_size ( _x ) (fr_value_box_network_sizes[_x][1])

Definition at line 108 of file value.c.

◆ network_min_size

#define network_min_size ( _x ) (fr_value_box_network_sizes[_x][0])

Sanity checks.

There should never be an instance where these fail. How many bytes on-the-wire would a fr_value_box_t value consume

This is for the generic NETWORK format. For field sizes in the in-memory structure use fr_value_box_field_sizes.

Note: Don't use this array directly when determining the length that would be consumed by the on-the-wire representation. Use fr_value_box_network_length instead, as that deals with variable length attributes too.

Definition at line 107 of file value.c.

◆ RETURN

#define RETURN ( _type ) return CMP(a->datum._type, b->datum._type)

◆ SIGN_BIT_HIGH

#define SIGN_BIT_HIGH	(	_int,
		_len
	)	((((uint64_t)1) << (((_len) << 3) - 1)) & (_int))

◆ SIGN_PROMOTE

#define SIGN_PROMOTE	(	_int,
		_len
	)

Value:

((_len) < sizeof(_int) ? \

(_int) | (~((__typeof__(_int))0)) << ((_len) << 3) : (_int))

Function Documentation

◆ _fr_value_box_debug()

static void _fr_value_box_debug	(	fr_value_box_t const *	vb,
		int	depth,
		int	idx
	)

static

Definition at line 6329 of file value.c.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ _fr_value_box_list_debug()

static void _fr_value_box_list_debug	(	fr_value_box_list_t const *	head,
		int	depth
	)

static

Definition at line 6311 of file value.c.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ _fr_value_box_mark_safe_for()

void _fr_value_box_mark_safe_for	(	fr_value_box_t *	vb,
		fr_value_box_safe_for_t	safe_for
	)

Mark a value-box as "safe", of a particular type.

Definition at line 6240 of file value.c.

◆ fr_dbuff_set()

return fr_dbuff_set	(	dbuff	,
		&	our_dbuff
	)

◆ fr_regex_cmp_op()

int fr_regex_cmp_op	(	fr_token_t	op,
		fr_value_box_t const *	a,
		fr_value_box_t const *	b
	)

Compare two boxes using an operator.

Todo:

allow /foo/i on the RHS

However, this involves allocating intermediate sbuffs for the unescaped RHS, and all kinds of extra work. It's not overly hard, but it's something we wish to avoid for now.

Parameters

[in]	op	to use in comparison. MUST be T_OP_REG_EQ or T_OP_REG_NE
[in]	a	Value to compare, MUST be FR_TYPE_STRING
[in]	b	uncompiled regex as FR_TYPE_STRING

Returns

1 if true
0 if false
-1 on failure.

Definition at line 1360 of file regex.c.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ FR_SBUFF_SET_RETURN()

FR_SBUFF_SET_RETURN	(	sbuff	,
		&	our_sbuff
	)

◆ fr_value_box_asprintf()

int fr_value_box_asprintf	(	TALLOC_CTX *	ctx,
		fr_value_box_t *	dst,
		fr_dict_attr_t const *	enumv,
		bool	tainted,
		char const *	fmt,
			...
	)

Print a formatted string using our internal printf wrapper and assign it to a value box.

Parameters

[in]	ctx	to allocate any new buffers in.
[in]	dst	to assign new buffer to.
[in]	enumv	Aliases for values.
[in]	tainted	Whether the value came from a trusted source.
[in]	fmt	The printf format string to process.
[in]	...	Substitution arguments.

Returns

0 on success.
-1 on failure.

Definition at line 3963 of file value.c.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ fr_value_box_bstr_alloc()

int fr_value_box_bstr_alloc	(	TALLOC_CTX *	ctx,
		char **	out,
		fr_value_box_t *	dst,
		fr_dict_attr_t const *	enumv,
		size_t	len,
		bool	tainted
	)

Alloc and assign an empty \0 terminated string to a fr_value_box_t.

Parameters

[in]	ctx	to allocate any new buffers in.
[out]	out	if non-null where to write a pointer to the new buffer.
[in]	dst	to assign new buffer to.
[in]	enumv	Aliases for values.
[in]	len	of buffer to allocate.
[in]	tainted	Whether the value came from a trusted source.

Returns

0 on success.
-1 on failure.

Definition at line 4020 of file value.c.

Here is the caller graph for this function:

◆ fr_value_box_bstr_append_buffer()

int fr_value_box_bstr_append_buffer	(	TALLOC_CTX *	ctx,
		fr_value_box_t *	dst,
		char const *	src,
		bool	tainted
	)

Append a talloced buffer to an existing fr_value_box_t.

Parameters

[in]	ctx	Where to allocate any talloc buffers required.
[in]	dst	value box to append to.
[in]	src	string data to append.
[in]	tainted	Whether src is tainted.

Returns

0 on success.
- -1 on failure.

Definition at line 4286 of file value.c.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ fr_value_box_bstr_realloc()

int fr_value_box_bstr_realloc	(	TALLOC_CTX *	ctx,
		char **	out,
		fr_value_box_t *	dst,
		size_t	len
	)

Change the length of a buffer already allocated to a value box.

Note: Do not use on an uninitialised box.

Parameters

[in]	ctx	to realloc buffer in.
[out]	out	if non-null where to write a pointer to the new buffer.
[in]	dst	to realloc buffer for.
[in]	len	to realloc to (don't include nul byte).

Returns

0 on success.
- -1 on failure.

Definition at line 4053 of file value.c.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ fr_value_box_bstrdup_buffer()

int fr_value_box_bstrdup_buffer	(	TALLOC_CTX *	ctx,
		fr_value_box_t *	dst,
		fr_dict_attr_t const *	enumv,
		char const *	src,
		bool	tainted
	)

Copy a nul terminated talloced buffer to a fr_value_box_t.

Copy a talloced nul terminated buffer, setting fields in the dst value box appropriately.

The buffer must be \0 terminated, or an error will be returned.

Parameters

[in]	ctx	to allocate any new buffers in.
[in]	dst	to assign new buffer to.
[in]	enumv	Aliases for values.
[in]	src	a talloced nul terminated buffer.
[in]	tainted	Whether the value came from a trusted source.

Returns

0 on success.
-1 on failure.

Definition at line 4157 of file value.c.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ fr_value_box_bstrdup_buffer_shallow()

int fr_value_box_bstrdup_buffer_shallow	(	TALLOC_CTX *	ctx,
		fr_value_box_t *	dst,
		fr_dict_attr_t const *	enumv,
		char const *	src,
		bool	tainted
	)

Assign a talloced buffer containing a nul terminated string to a box, but don't copy it.

Adds a reference to the src buffer so that it cannot be freed until the ctx is freed.

Parameters

[in]	ctx	to add reference from. If NULL no reference will be added.
[in]	dst	to assign string to.
[in]	enumv	Aliases for values.
[in]	src	to copy string from.
[in]	tainted	Whether the value came from a trusted source.

Returns

0 on success.
-1 on failure.

Definition at line 4202 of file value.c.

Here is the caller graph for this function:

◆ fr_value_box_bstrn_append()

int fr_value_box_bstrn_append	(	TALLOC_CTX *	ctx,
		fr_value_box_t *	dst,
		char const *	src,
		size_t	len,
		bool	tainted
	)

Append bytes from a buffer to an existing fr_value_box_t.

Parameters

[in]	ctx	Where to allocate any talloc buffers required.
[in]	dst	value box to append to.
[in]	src	octets data to append.
[in]	len	length of octets data.
[in]	tainted	Whether src is tainted.

Returns

0 on success.
- -1 on failure.

Definition at line 4233 of file value.c.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ fr_value_box_bstrndup()

int fr_value_box_bstrndup	(	TALLOC_CTX *	ctx,
		fr_value_box_t *	dst,
		fr_dict_attr_t const *	enumv,
		char const *	src,
		size_t	len,
		bool	tainted
	)

Copy a string to to a fr_value_box_t.

Parameters

[in]	ctx	to allocate any new buffers in.
[in]	dst	to assign buffer to.
[in]	enumv	Aliases for values.
[in]	src	a string. May be NULL only if len == 0.
[in]	len	of src.
[in]	tainted	Whether the value came from a trusted source.

Definition at line 4097 of file value.c.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ fr_value_box_bstrndup_dbuff()

int fr_value_box_bstrndup_dbuff	(	TALLOC_CTX *	ctx,
		fr_value_box_t *	dst,
		fr_dict_attr_t const *	enumv,
		fr_dbuff_t *	dbuff,
		size_t	len,
		bool	tainted
	)

Definition at line 4121 of file value.c.

Here is the caller graph for this function:

◆ fr_value_box_bstrndup_shallow()

void fr_value_box_bstrndup_shallow	(	fr_value_box_t *	dst,
		fr_dict_attr_t const *	enumv,
		char const *	src,
		size_t	len,
		bool	tainted
	)

Assign a string to to a fr_value_box_t.

Parameters

[in]	dst	to assign new buffer to.
[in]	enumv	Aliases for values.
[in]	src	a string.
[in]	len	of src.
[in]	tainted	Whether the value came from a trusted source.

Definition at line 4181 of file value.c.

Here is the caller graph for this function:

◆ fr_value_box_cast()

int fr_value_box_cast	(	TALLOC_CTX *	ctx,
		fr_value_box_t *	dst,
		fr_type_t	dst_type,
		fr_dict_attr_t const *	dst_enumv,
		fr_value_box_t const *	src
	)

Convert one type of fr_value_box_t to another.

This should be the canonical function used to convert between INTERNAL data formats.

If you want to convert from PRESENTATION format, use fr_value_box_from_substr.

Note: src and dst must not be the same box. We do not support casting in place.

Parameters

ctx	to allocate buffers in (usually the same as dst)
dst	Where to write result of casting.
dst_type	to cast to.
dst_enumv	Aliases for values contained within this fr_value_box_t. If fr_value_box_t is passed to fr_value_box_aprint names will be printed instead of actual value.
src	Input data.

Returns

0 on success.
-1 on failure.

Definition at line 3301 of file value.c.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ fr_value_box_cast_in_place()

int fr_value_box_cast_in_place	(	TALLOC_CTX *	ctx,
		fr_value_box_t *	vb,
		fr_type_t	dst_type,
		fr_dict_attr_t const *	dst_enumv
	)

Convert one type of fr_value_box_t to another in place.

This should be the canonical function used to convert between INTERNAL data formats.

If you want to convert from PRESENTATION format, use fr_value_box_from_substr.

Parameters

ctx	to allocate buffers in (usually the same as dst)
vb	to cast.
dst_type	to cast to.
dst_enumv	Aliases for values contained within this fr_value_box_t. If fr_value_box_t is passed to fr_value_box_aprint names will be printed instead of actual value.

Returns

0 on success.
-1 on failure.

Definition at line 3521 of file value.c.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ fr_value_box_cast_integer_to_integer()

static int fr_value_box_cast_integer_to_integer	(	UNUSED TALLOC_CTX *	ctx,
		fr_value_box_t *	dst,
		fr_type_t	dst_type,
		fr_dict_attr_t const *	dst_enumv,
		fr_value_box_t const *	src
	)

inlinestatic

Convert any signed or unsigned integer type to any other signed or unsigned integer type.

Definition at line 2923 of file value.c.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ fr_value_box_cast_to_bool()

static int fr_value_box_cast_to_bool	(	TALLOC_CTX *	ctx,
		fr_value_box_t *	dst,
		fr_type_t	dst_type,
		fr_dict_attr_t const *	dst_enumv,
		fr_value_box_t const *	src
	)

inlinestatic

Convert any supported type to a bool.

Allowed input types are:

FR_TYPE_STRING ("yes", "true", "no", "false")

Parameters

ctx	unused.
dst	Where to write result of casting.
dst_type	to cast to.
dst_enumv	enumeration values.
src	Input data.

Definition at line 2834 of file value.c.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ fr_value_box_cast_to_ethernet()

static int fr_value_box_cast_to_ethernet	(	TALLOC_CTX *	ctx,
		fr_value_box_t *	dst,
		fr_type_t	dst_type,
		fr_dict_attr_t const *	dst_enumv,
		fr_value_box_t const *	src
	)

inlinestatic

Convert any supported type to an ethernet address.

Allowed input types are:

FR_TYPE_STRING ("00:11:22:33:44:55")
FR_TYPE_OCTETS (0x001122334455)

Parameters

ctx	unused.
dst	Where to write result of casting.
dst_type	to cast to.
dst_enumv	enumeration values.
src	Input data.

Definition at line 2774 of file value.c.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ fr_value_box_cast_to_float()

static int fr_value_box_cast_to_float	(	UNUSED TALLOC_CTX *	ctx,
		fr_value_box_t *	dst,
		fr_type_t	dst_type,
		fr_dict_attr_t const *	dst_enumv,
		fr_value_box_t const *	src
	)

inlinestatic

Convert any value to a floating point value.

Parameters

ctx	unused.
dst	Where to write result of casting.
dst_type	to cast to.
dst_enumv	enumeration values.
src	Input data.

Definition at line 3179 of file value.c.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ fr_value_box_cast_to_integer()

static int fr_value_box_cast_to_integer	(	TALLOC_CTX *	ctx,
		fr_value_box_t *	dst,
		fr_type_t	dst_type,
		fr_dict_attr_t const *	dst_enumv,
		fr_value_box_t const *	src
	)

inlinestatic

Convert any value to a signed or unsigned integer.

Parameters

ctx	unused.
dst	Where to write result of casting.
dst_type	to cast to.
dst_enumv	enumeration values.
src	Input data.

Definition at line 3078 of file value.c.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ fr_value_box_cast_to_ipv4addr()

static int fr_value_box_cast_to_ipv4addr	(	TALLOC_CTX *	ctx,
		fr_value_box_t *	dst,
		fr_type_t	dst_type,
		fr_dict_attr_t const *	dst_enumv,
		fr_value_box_t const *	src
	)

inlinestatic

Convert any supported type to an IPv4 address.

Allowed input types are:

FR_TYPE_IPV6_ADDR (with v4 prefix).
FR_TYPE_IPV4_PREFIX (with 32bit mask).
FR_TYPE_IPV6_PREFIX (with v4 prefix and 128bit mask).
FR_TYPE_OCTETS (of length 4).
FR_TYPE_UINT32

Parameters

ctx	unused.
dst	Where to write result of casting.
dst_type	to cast to.
dst_enumv	enumeration values.
src	Input data.

Definition at line 2327 of file value.c.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ fr_value_box_cast_to_ipv4prefix()

static int fr_value_box_cast_to_ipv4prefix	(	TALLOC_CTX *	ctx,
		fr_value_box_t *	dst,
		fr_type_t	dst_type,
		fr_dict_attr_t const *	dst_enumv,
		fr_value_box_t const *	src
	)

inlinestatic

Convert any supported type to an IPv6 address.

Allowed input types are:

FR_TYPE_IPV4_ADDR
FR_TYPE_IPV4_PREFIX (with 32bit mask).
FR_TYPE_IPV6_PREFIX (with 128bit mask).
FR_TYPE_OCTETS (of length 16).

Parameters

ctx	unused.
dst	Where to write result of casting.
dst_type	to cast to.
dst_enumv	enumeration values.
src	Input data.

Definition at line 2443 of file value.c.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ fr_value_box_cast_to_ipv6addr()

static int fr_value_box_cast_to_ipv6addr	(	TALLOC_CTX *	ctx,
		fr_value_box_t *	dst,
		fr_type_t	dst_type,
		fr_dict_attr_t const *	dst_enumv,
		fr_value_box_t const *	src
	)

inlinestatic

Convert any supported type to an IPv6 address.

Allowed input types are:

FR_TYPE_IPV4_ADDR
FR_TYPE_IPV4_PREFIX (with 32bit mask).
FR_TYPE_IPV6_PREFIX (with 128bit mask).
FR_TYPE_OCTETS (of length 16).

Parameters

ctx	unused.
dst	Where to write result of casting.
dst_type	to cast to.
dst_enumv	enumeration values.
src	Input data.

Definition at line 2559 of file value.c.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ fr_value_box_cast_to_ipv6prefix()

static int fr_value_box_cast_to_ipv6prefix	(	TALLOC_CTX *	ctx,
		fr_value_box_t *	dst,
		fr_type_t	dst_type,
		fr_dict_attr_t const *	dst_enumv,
		fr_value_box_t const *	src
	)

inlinestatic

Convert any supported type to an IPv6 address.

Allowed input types are:

FR_TYPE_IPV4_ADDR
FR_TYPE_IPV4_PREFIX (with 32bit mask).
FR_TYPE_IPV6_PREFIX (with 128bit mask).
FR_TYPE_OCTETS (of length 16).

Parameters

ctx	unused.
dst	Where to write result of casting.
dst_type	to cast to.
dst_enumv	enumeration values.
src	Input data.

Definition at line 2674 of file value.c.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ fr_value_box_cast_to_octets()

static int fr_value_box_cast_to_octets	(	TALLOC_CTX *	ctx,
		fr_value_box_t *	dst,
		fr_type_t	dst_type,
		fr_dict_attr_t const *	dst_enumv,
		fr_value_box_t const *	src
	)

inlinestatic

Convert any supported type to octets.

All non-structural types are allowed.

Parameters

ctx	unused.
dst	Where to write result of casting.
dst_type	to cast to.
dst_enumv	enumeration values.
src	Input data.

Definition at line 2205 of file value.c.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ fr_value_box_cast_to_strvalue()

static int fr_value_box_cast_to_strvalue	(	TALLOC_CTX *	ctx,
		fr_value_box_t *	dst,
		fr_type_t	dst_type,
		fr_dict_attr_t const *	dst_enumv,
		fr_value_box_t const *	src
	)

inlinestatic

Convert any supported type to a string.

All non-structural types are allowed.

Parameters

ctx	unused.
dst	Where to write result of casting.
dst_type	to cast to.
dst_enumv	enumeration values.
src	Input data.

Definition at line 2158 of file value.c.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ fr_value_box_cidr_cmp_op()

static int fr_value_box_cidr_cmp_op	(	fr_token_t	op,
		int	bytes,
		uint8_t	a_net,
		uint8_t const *	a,
		uint8_t	b_net,
		uint8_t const *	b
	)

static

Definition at line 762 of file value.c.

Here is the caller graph for this function:

◆ fr_value_box_clear()

void fr_value_box_clear ( fr_value_box_t * data )

Clear/free any existing value and metadata.

Note: Do not use on uninitialised memory.

Parameters

[in] data to clear.

Definition at line 3672 of file value.c.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ fr_value_box_clear_value()

void fr_value_box_clear_value ( fr_value_box_t * data )

Clear/free any existing value.

Note: Do not use on uninitialised memory.

Parameters

[in] data to clear.

Definition at line 3630 of file value.c.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ fr_value_box_cmp()

int8_t fr_value_box_cmp	(	fr_value_box_t const *	a,
		fr_value_box_t const *	b
	)

Compare two values.

Parameters

[in]	a	Value to compare.
[in]	b	Value to compare.

Returns

-1 if a is less than b.
0 if both are equal.
1 if a is more than b.
< -1 on failure.

Definition at line 640 of file value.c.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ fr_value_box_cmp_op()

int fr_value_box_cmp_op	(	fr_token_t	op,
		fr_value_box_t const *	a,
		fr_value_box_t const *	b
	)

Compare two attributes using an operator.

Parameters

[in]	op	to use in comparison.
[in]	a	Value to compare.
[in]	b	Value to compare.

Returns

1 if true
0 if false
-1 on failure.

Definition at line 884 of file value.c.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ fr_value_box_copy()

int fr_value_box_copy	(	TALLOC_CTX *	ctx,
		fr_value_box_t *	dst,
		const fr_value_box_t *	src
	)

Copy value data verbatim duplicating any buffers.

Note: Will free any exiting buffers associated with the dst fr_value_box_t.

Parameters

ctx	To allocate buffers in.
dst	Where to copy value_box to.
src	Where to copy value_box from.

Returns

0 on success.
-1 on failure.

Definition at line 3689 of file value.c.

Here is the call graph for this function:

◆ fr_value_box_copy_meta()

static void fr_value_box_copy_meta	(	fr_value_box_t *	dst,
		fr_value_box_t const *	src
	)

inlinestatic

Copy flags and type data from one value box to another.

Parameters

[in]	dst	to copy flags to
[in]	src	of data.

Definition at line 602 of file value.c.

Here is the caller graph for this function:

◆ fr_value_box_copy_shallow()

void fr_value_box_copy_shallow	(	TALLOC_CTX *	ctx,
		fr_value_box_t *	dst,
		fr_value_box_t const *	src
	)

Perform a shallow copy of a value_box.

Like fr_value_box_copy, but does not duplicate the buffers of the src value_box.

For FR_TYPE_STRING and FR_TYPE_OCTETS adds a reference from ctx so that the buffer cannot be freed until the ctx is freed.

Parameters

[in]	ctx	to add reference from. If NULL no reference will be added.
[in]	dst	to copy value to.
[in]	src	to copy value from.

Definition at line 3783 of file value.c.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ fr_value_box_debug()

void fr_value_box_debug ( fr_value_box_t const * vb )

Print the value of a box as info messages.

Note: Call directly from the debugger

Definition at line 6351 of file value.c.

Here is the call graph for this function:

◆ fr_value_box_escape_in_place()

int fr_value_box_escape_in_place	(	fr_value_box_t *	vb,
		fr_value_box_escape_t	escape,
		fr_value_box_safe_for_t	safe_for,
		void *	uctx
	)

Escape a single value box in place.

Note: Applies recursively to the children of group boxes.

Parameters

[in]	vb	to escape.
[in]	escape	function to apply to the value box.
[in]	safe_for	the escaped value to check value boxes again. box has an escaped value that matches, it will not be re-escaped.
[in]	uctx	user context to pass to the escape function.

Returns

0 on success.
-1 on failure.

Definition at line 5893 of file value.c.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ fr_value_box_fixed_size_from_octets()

static int fr_value_box_fixed_size_from_octets	(	fr_value_box_t *	dst,
		fr_type_t	dst_type,
		fr_dict_attr_t const *	dst_enumv,
		fr_value_box_t const *	src
	)

static

Convert octets to a fixed size value box value.

All fixed size types are allowed.

Parameters

dst	Where to write result of casting.
dst_type	to cast to.
dst_enumv	enumeration values.
src	Input data.

Definition at line 2102 of file value.c.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ fr_value_box_flatten()

void fr_value_box_flatten	(	TALLOC_CTX *	ctx,
		fr_value_box_list_t *	list,
		bool	steal,
		bool	free
	)

Removes a single layer of nesting, moving all children into the parent list.

Parameters

[in]	ctx	to reparent children in if steal is true.
[in]	list	to flatten.
[in]	steal	whether to change the talloc ctx of children.
[in]	free	whether to free any group boxes which have had their children removed.

Definition at line 5951 of file value.c.

Here is the call graph for this function:

◆ fr_value_box_from_network()

ssize_t fr_value_box_from_network	(	TALLOC_CTX *	ctx,
		fr_value_box_t *	dst,
		fr_type_t	type,
		fr_dict_attr_t const *	enumv,
		fr_dbuff_t *	dbuff,
		size_t	len,
		bool	tainted
	)

Decode a fr_value_box_t from serialized binary data.

The general deserialization rules are:

Octets are decoded in binary form (not hex).
Strings are decoded without the trailing \0 byte. Strings must consist only of valid UTF8 chars.
Integers are decoded big-endian.
Bools are decoded using one byte, with value 0x00 (false) or 0x01 (true).
Signed integers are decoded two's complement, with the MSB as the sign bit. Byte order is big-endian.
Network addresses are decoded big-endian.
IPv4 prefixes are decoded with 1 byte for the prefix, then 4 bytes of address.
IPv6 prefixes are decoded with 1 byte for the scope_id, 1 byte for the prefix, and 16 bytes of address.
Floats are decoded in IEEE-754 format with a big-endian byte order. We rely on the fact that the C standards require floats to be represented in IEEE-754 format in memory.
Dates are decoded as 32bit unsigned UNIX timestamps.

All of the dictionary rules are respected. string/octets can have a fixed length, or can have an 8/16-bit "length" prefix. If the enumv is not an array, then the input # len MUST be the correct size (not too large or small), otherwise an error is returned.

If the enumv is an array, then the input must have the minimum length, and the number of bytes decoded is capped at the maximum length allowed to be decoded. This behavior allows the caller to decode an array of values simply by calling this function in a loop.

Parameters

[in]	ctx	Where to allocate any talloc buffers required.
[out]	dst	value_box to write the result to.
[in]	type	to decode data to.
[in]	enumv	Aliases for values.
[in]	dbuff	Binary data to decode.
[in]	len	Length of data to decode. For fixed length types we only decode complete values.
[in]	tainted	Whether the value came from a trusted source.

Returns

>= 0 The number of bytes consumed.
<0 - The negative offset where the error occurred.
FR_VALUE_BOX_NET_OOM (negative value) - Out of memory.

Definition at line 1709 of file value.c.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ fr_value_box_from_numeric_substr()

static fr_slen_t fr_value_box_from_numeric_substr	(	fr_value_box_t *	dst,
		fr_type_t	dst_type,
		fr_dict_attr_t const *	dst_enumv,
		fr_sbuff_t *	in,
		fr_sbuff_parse_rules_t const *	rules,
		bool	tainted
	)

inlinestatic

Convert integer encoded as string to a fr_value_box_t type.

Parameters

[out]	dst	where to write parsed value.
[in]	dst_type	type of integer to convert string to.
[in]	dst_enumv	Enumeration values.
[in]	in	String to convert to integer.
[in]	rules	for parsing string.
[in]	tainted	Whether the value came from a trusted source.

Returns

>= 0 on success (number of bytes parsed).
< 0 on error (where the parse error occurred).

Definition at line 4650 of file value.c.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ fr_value_box_from_str()

ssize_t fr_value_box_from_str	(	TALLOC_CTX *	ctx,
		fr_value_box_t *	dst,
		fr_type_t	dst_type,
		fr_dict_attr_t const *	dst_enumv,
		char const *	in,
		size_t	inlen,
		fr_sbuff_unescape_rules_t const *	erules,
		bool	tainted
	)

Definition at line 5264 of file value.c.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ fr_value_box_from_substr()

ssize_t fr_value_box_from_substr	(	TALLOC_CTX *	ctx,
		fr_value_box_t *	dst,
		fr_type_t	dst_type,
		fr_dict_attr_t const *	dst_enumv,
		fr_sbuff_t *	in,
		fr_sbuff_parse_rules_t const *	rules,
		bool	tainted
	)

Convert string value to a fr_value_box_t type.

Parameters

[in]	ctx	to alloc strings in.
[out]	dst	where to write parsed value.
[in,out]	dst_type	of value data to create/dst_type of value created.
[in]	dst_enumv	fr_dict_attr_t with string names for uint32 values.
[in]	in	sbuff to read data from.
[in]	rules	unescape and termination rules.
[in]	tainted	Whether the value came from a trusted source.

Returns

>0 on success.
<= 0 on parse error.

Definition at line 4751 of file value.c.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ fr_value_box_hash()

uint32_t fr_value_box_hash ( fr_value_box_t const * vb )

Hash the contents of a value box.

Definition at line 6077 of file value.c.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ fr_value_box_hton()

int fr_value_box_hton	(	fr_value_box_t *	dst,
		fr_value_box_t const *	src
	)

Performs byte order reversal for types that need it.

Parameters

[in]	dst	Where to write the result. May be the same as src.
[in]	src	fr_value_box_t containing an uint32 value.

Returns

0 on success.
-1 on failure.

Definition at line 1186 of file value.c.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ fr_value_box_increment()

void fr_value_box_increment ( fr_value_box_t * vb )

Increment a boxed value.

Implements safe integer overflow.

Parameters

[in] vb to increment.

Definition at line 4597 of file value.c.

Here is the caller graph for this function:

◆ fr_value_box_ipaddr()

int fr_value_box_ipaddr	(	fr_value_box_t *	dst,
		fr_dict_attr_t const *	enumv,
		fr_ipaddr_t const *	ipaddr,
		bool	tainted
	)

Assign a fr_value_box_t value from an fr_ipaddr_t.

Automatically determines the type of the value box from the ipaddr address family and the length of the prefix field.

Parameters

[in]	dst	to assign ipaddr to.
[in]	enumv	Aliases for values.
[in]	ipaddr	to copy address from.
[in]	tainted	Whether the value came from a trusted source.

Returns

0 on success.
-1 on failure.

Definition at line 3579 of file value.c.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ fr_value_box_is_truthy()

bool fr_value_box_is_truthy ( fr_value_box_t const * in )

Check truthiness of values.

The casting rules for expressions / conditions are slightly
different than fr_value_box_cast().  Largely because that
function is used to parse configuration files, and parses "yes
/ no" and "true / false" strings, even if there's no
fr_dict_attr_t passed to it.

Definition at line 6274 of file value.c.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ fr_value_box_list_acopy()

int fr_value_box_list_acopy	(	TALLOC_CTX *	ctx,
		fr_value_box_list_t *	out,
		fr_value_box_list_t const *	in
	)

Do a full copy of a list of value boxes.

Parameters

[in]	ctx	to allocate boxes in.
[out]	out	Where to write the head of the new list.
[in]	in	boxes to copy.

Returns

A duplicate list of value boxes, allocated in the context of 'ctx'
NULL on error, or empty input list.

Definition at line 6106 of file value.c.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ fr_value_box_list_aprint()

char* fr_value_box_list_aprint	(	TALLOC_CTX *	ctx,
		fr_value_box_list_t const *	list,
		char const *	delim,
		fr_sbuff_escape_rules_t const *	e_rules
	)

Concatenate the string representations of a list of value boxes together.

Parameters

[in]	ctx	to allocate the buffer in.
[in]	list	of value boxes.
[in]	delim	to insert between value box values.
[in]	e_rules	to control escaping of the concatenated elements.

Returns

NULL on error.
The concatenation of the string values of the value box list on success.

Definition at line 5976 of file value.c.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ fr_value_box_list_aprint_secure()

char* fr_value_box_list_aprint_secure	(	TALLOC_CTX *	ctx,
		fr_value_box_list_t const *	list,
		char const *	delim,
		fr_sbuff_escape_rules_t const *	e_rules
	)

Concatenate the string representations of a list of value boxes together hiding "secret" values.

Parameters

[in]	ctx	to allocate the buffer in.
[in]	list	of value boxes.
[in]	delim	to insert between value box values.
[in]	e_rules	to control escaping of the concatenated elements.

Returns

NULL on error.
The concatenation of the string values of the value box list on success.

Definition at line 6026 of file value.c.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ fr_value_box_list_concat_as_octets()

ssize_t fr_value_box_list_concat_as_octets	(	bool *	tainted,
		bool *	secret,
		fr_dbuff_t *	dbuff,
		fr_value_box_list_t *	list,
		uint8_t const *	sep,
		size_t	sep_len,
		fr_value_box_list_action_t	proc_action,
		bool	flatten
	)

Concatenate a list of value boxes together.

All boxes will be removed from the list.

Parameters

[out]	tainted	If nonnull, will be set to true if any input boxes are tainted. bool pointed to must be initialised.
[out]	secret	If nonnull, will be set to true if any input boxes are secret.
[out]	dbuff	to write the result of the concatenation to.
[in]	list	to concatenate.
[in]	sep	Insert a separator between the values.
[in]	sep_len	Length of the separator.
[in]	proc_action	What to do with the boxes in the list once they've been processed.
[in]	flatten	If true and we encounter a FR_TYPE_GROUP, we concat the contents of its children together. If false, the contents will be cast to FR_TYPE_OCTETS.

Returns

>=0 the number of bytes written to the sbuff.
<0 how many additional bytes we would have needed to concat the next box.

Definition at line 5625 of file value.c.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ fr_value_box_list_concat_as_string()

ssize_t fr_value_box_list_concat_as_string	(	bool *	tainted,
		bool *	secret,
		fr_sbuff_t *	sbuff,
		fr_value_box_list_t *	list,
		char const *	sep,
		size_t	sep_len,
		fr_sbuff_escape_rules_t const *	e_rules,
		fr_value_box_list_action_t	proc_action,
		bool	flatten
	)

Concatenate a list of value boxes together.

All boxes will be removed from the list.

Parameters

[out]	tainted	If nonnull, will be set to true if any input boxes are tainted. bool pointed to must be initialised.
[out]	secret	If nonnull, will be set to true if any input boxes are secret.
[out]	sbuff	to write the result of the concatenation to.
[in]	list	to concatenate.
[in]	sep	Insert a separator between the values.
[in]	sep_len	Length of the separator.
[in]	e_rules	To apply to FR_TYPE_STRING types. Is not currently applied to any other box type.
[in]	proc_action	What to do with the boxes in the list once they've been processed.
[in]	flatten	If true and we encounter a FR_TYPE_GROUP, we concat the contents of its children together. If false, the contents will be cast to FR_TYPE_STRING.

Returns

>=0 the number of bytes written to the sbuff.
<0 how many additional bytes we would have needed to concat the next box.

Definition at line 5532 of file value.c.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ fr_value_box_list_concat_in_place()

int fr_value_box_list_concat_in_place	(	TALLOC_CTX *	ctx,
		fr_value_box_t *	out,
		fr_value_box_list_t *	list,
		fr_type_t	type,
		fr_value_box_list_action_t	proc_action,
		bool	flatten,
		size_t	max_size
	)

Concatenate a list of value boxes.

Note: Will automatically cast all fr_value_box_t to type specified.

Parameters

[in]	ctx	to allocate new value buffer in.
[out]	out	Where to write the resulting box.
[in]	list	to concatenate together.
[in]	type	May be FR_TYPE_STRING or FR_TYPE_OCTETS, no other types are supported.
[in]	proc_action	What to do with the boxes in the list once they've been processed.
[in]	flatten	If true and we encounter a FR_TYPE_GROUP, we concat the contents of its children together. If false, the contents will be cast to the given type.
[in]	max_size	of the value.

Returns

0 on success.
-1 on failure.

Definition at line 5725 of file value.c.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ fr_value_box_list_debug()

void fr_value_box_list_debug ( fr_value_box_list_t const * head )

Print a list of value boxes as info messages.

Note: Call directly from the debugger

Definition at line 6324 of file value.c.

Here is the call graph for this function:

◆ fr_value_box_list_escape_in_place()

int fr_value_box_list_escape_in_place	(	fr_value_box_list_t *	list,
		fr_value_box_escape_t	escape,
		fr_value_box_safe_for_t	safe_for,
		void *	uctx
	)

Escape a list of value boxes in place.

Note: Applies recursively to the children of group boxes.; on error, the list may be left in an inconsistent/partially escaped state.

Parameters

[in]	list	to escape.
[in]	escape	function to apply to the value box.
[in]	safe_for	the escaped value to check value boxes again. box has an escaped value that matches, it will not be re-escaped.
[in]	uctx	user context to pass to the escape function.

Returns

0 on success.
-1 on failure.

Definition at line 5930 of file value.c.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ fr_value_box_list_mark_safe_for()

void fr_value_box_list_mark_safe_for	(	fr_value_box_list_t *	list,
		fr_value_box_safe_for_t	safe_for
	)

Set the escaped flag for all value boxes in a list.

Note: Only operates on a single level.

Parameters

[in]	list	to operate on.
[in]	safe_for	value to set.

Definition at line 6261 of file value.c.

Here is the caller graph for this function:

◆ fr_value_box_list_taint()

void fr_value_box_list_taint ( fr_value_box_list_t * head )

Taint every list member (and their children)

Parameters

[in] head of list.

Definition at line 6150 of file value.c.

◆ fr_value_box_list_tainted()

bool fr_value_box_list_tainted ( fr_value_box_list_t const * head )

Check to see if any list members (or their children) are tainted.

Parameters

[in] head of list to check.

Returns

true if a list member is tainted.
false if no list members are tainted.

Definition at line 6134 of file value.c.

Here is the caller graph for this function:

◆ fr_value_box_list_untaint()

void fr_value_box_list_untaint ( fr_value_box_list_t * head )

Untaint every list member (and their children)

Parameters

[in] head of list.

Definition at line 6164 of file value.c.

Here is the caller graph for this function:

◆ fr_value_box_list_verify()

void fr_value_box_list_verify	(	char const *	file,
		int	line,
		fr_value_box_list_t const *	list
	)

Definition at line 6232 of file value.c.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ fr_value_box_mark_unsafe()

void fr_value_box_mark_unsafe ( fr_value_box_t * vb )

Mark a value-box as "unsafe".

This always succeeds, and there are no side effects.

Definition at line 6249 of file value.c.

◆ fr_value_box_mem_alloc()

int fr_value_box_mem_alloc	(	TALLOC_CTX *	ctx,
		uint8_t **	out,
		fr_value_box_t *	dst,
		fr_dict_attr_t const *	enumv,
		size_t	len,
		bool	tainted
	)

Pre-allocate an octets buffer for filling by the caller.

Note: Buffer will not be zeroed, as it's assumed the caller will be filling it.

Parameters

[in]	ctx	to allocate any new buffers in.
[out]	out	If non-null will be filled with a pointer to the new buffer.
[in]	dst	to assign new buffer to.
[in]	enumv	Aliases for values.
[in]	len	of data in the buffer. If 0, a zero length talloc buffer will be alloced. dst->vb_octets will NOT be NULL. You should use the length field of the box to determine if any value is assigned.
[in]	tainted	Whether the value came from a trusted source.

Returns

0 on success.
-1 on failure.

Definition at line 4320 of file value.c.

Here is the caller graph for this function:

◆ fr_value_box_mem_append()

int fr_value_box_mem_append	(	TALLOC_CTX *	ctx,
		fr_value_box_t *	dst,
		uint8_t const *	src,
		size_t	len,
		bool	tainted
	)

Append data to an existing fr_value_box_t.

Parameters

[in]	ctx	Where to allocate any talloc buffers required.
[in]	dst	value box to append to.
[in]	src	octets data to append.
[in]	len	length of octets data.
[in]	tainted	Whether src is tainted.

Returns

0 on success.
- -1 on failure.

Definition at line 4536 of file value.c.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ fr_value_box_mem_append_buffer()

int fr_value_box_mem_append_buffer	(	TALLOC_CTX *	ctx,
		fr_value_box_t *	dst,
		uint8_t const *	src,
		bool	tainted
	)

Append a talloc buffer to an existing fr_value_box_t.

Parameters

[in]	ctx	Where to allocate any talloc buffers required.
[in]	dst	value box to append to.
[in]	src	octets data to append.
[in]	tainted	Whether src is tainted.

Returns

0 on success.
- -1 on failure.

Definition at line 4586 of file value.c.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ fr_value_box_mem_realloc()

int fr_value_box_mem_realloc	(	TALLOC_CTX *	ctx,
		uint8_t **	out,
		fr_value_box_t *	dst,
		size_t	len
	)

Change the length of a buffer already allocated to a value box.

Note: Do not use on an uninitialised box.

Parameters

[in]	ctx	to realloc buffer in.
[out]	out	if non-null where to write a pointer to the new buffer.
[in]	dst	to realloc buffer for.
[in]	len	to realloc to.

Returns

0 on success.
- -1 on failure.

Definition at line 4353 of file value.c.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ fr_value_box_memdup()

int fr_value_box_memdup	(	TALLOC_CTX *	ctx,
		fr_value_box_t *	dst,
		fr_dict_attr_t const *	enumv,
		uint8_t const *	src,
		size_t	len,
		bool	tainted
	)

Copy a buffer to a fr_value_box_t.

Copy a buffer containing binary data, setting fields in the dst value box appropriately.

Parameters

[in]	ctx	to allocate any new buffers in.
[in]	dst	to assign new buffer to.
[in]	enumv	Aliases for values.
[in]	src	a buffer.
[in]	len	of data in the buffer. If 0, a zero length talloc buffer will be alloced. dst->vb_octets will NOT be NULL. You should use the length field of the box to determine if any value is assigned.
[in]	tainted	Whether the value came from a trusted source.

Returns

0 on success.
-1 on failure.

Definition at line 4417 of file value.c.

Here is the caller graph for this function:

◆ fr_value_box_memdup_buffer()

int fr_value_box_memdup_buffer	(	TALLOC_CTX *	ctx,
		fr_value_box_t *	dst,
		fr_dict_attr_t const *	enumv,
		uint8_t const *	src,
		bool	tainted
	)

Copy a talloced buffer to a fr_value_box_t.

Copy a buffer containing binary data, setting fields in the dst value box appropriately.

Parameters

[in]	ctx	to allocate any new buffers in.
[in]	dst	to assign new buffer to.
[in]	enumv	Aliases for values.
[in]	src	a buffer.
[in]	tainted	Whether the value came from a trusted source.

Returns

0 on success.
-1 on failure.

Definition at line 4475 of file value.c.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ fr_value_box_memdup_buffer_shallow()

void fr_value_box_memdup_buffer_shallow	(	TALLOC_CTX *	ctx,
		fr_value_box_t *	dst,
		fr_dict_attr_t const *	enumv,
		uint8_t const *	src,
		bool	tainted
	)

Assign a talloced buffer to a box, but don't copy it.

Adds a reference to the src buffer so that it cannot be freed until the ctx is freed.

Parameters

[in]	ctx	to allocate any new buffers in.
[in]	dst	to assign buffer to.
[in]	enumv	Aliases for values.
[in]	src	a talloced buffer.
[in]	tainted	Whether the value came from a trusted source.

Definition at line 4515 of file value.c.

Here is the caller graph for this function:

◆ fr_value_box_memdup_dbuff()

int fr_value_box_memdup_dbuff	(	TALLOC_CTX *	ctx,
		fr_value_box_t *	dst,
		fr_dict_attr_t const *	enumv,
		fr_dbuff_t *	dbuff,
		size_t	len,
		bool	tainted
	)

Definition at line 4442 of file value.c.

Here is the caller graph for this function:

◆ fr_value_box_memdup_shallow()

void fr_value_box_memdup_shallow	(	fr_value_box_t *	dst,
		fr_dict_attr_t const *	enumv,
		uint8_t const *	src,
		size_t	len,
		bool	tainted
	)

Assign a buffer to a box, but don't copy it.

Adds a reference to the src buffer so that it cannot be freed until the ctx is freed.

Caller should set dst->taint = true, where the value was acquired from an untrusted source.

Note: Will free any exiting buffers associated with the value box.

Parameters

[in]	dst	to assign buffer to.
[in]	enumv	Aliases for values.
[in]	src	a talloced buffer.
[in]	len	of buffer.
[in]	tainted	Whether the value came from a trusted source.

Definition at line 4497 of file value.c.

Here is the caller graph for this function:

◆ fr_value_box_network_length()

size_t fr_value_box_network_length ( fr_value_box_t const * value )

Get the size of the value held by the fr_value_box_t.

This is the length of the NETWORK presentation

Definition at line 1280 of file value.c.

Here is the caller graph for this function:

◆ fr_value_box_print()

ssize_t fr_value_box_print	(	fr_sbuff_t *	out,
		fr_value_box_t const *	data,
		fr_sbuff_escape_rules_t const *	e_rules
	)

Print one boxed value to a string.

This function should primarily be used when a fr_value_box_t is being serialized in some non-standard way, i.e. as a value for a field in a database, in all other instances it's better to use fr_value_box_print_quoted.

Note: - this function does NOT respect tainting! The escaping rules are ONLY for escaping quotation characters, CR, LF, etc.

Parameters

[in]	out	Where to write the printed string.
[in]	data	Value box to print.
[in]	e_rules	To apply to FR_TYPE_STRING types, for escaping quotation characters only. Is not currently applied to any other box type.

Definition at line 5301 of file value.c.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ fr_value_box_print_quoted()

ssize_t fr_value_box_print_quoted	(	fr_sbuff_t *	out,
		fr_value_box_t const *	data,
		fr_token_t	quote
	)

Print one boxed value to a string with quotes (where needed)

Parameters

[in]	out	Where to write the printed string.
[in]	data	Value box to print.
[in]	quote	To apply to FR_TYPE_STRING types. Is not currently applied to any other box type.

Definition at line 5489 of file value.c.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ fr_value_box_steal()

int fr_value_box_steal	(	TALLOC_CTX *	ctx,
		fr_value_box_t *	dst,
		fr_value_box_t *	src
	)

Copy value data verbatim moving any buffers to the specified context.

Parameters

[in]	ctx	to allocate any new buffers in.
[in]	dst	to copy value to.
[in]	src	to copy value from.

Returns

0 on success.
-1 on failure.

Definition at line 3807 of file value.c.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ fr_value_box_strdup()

int fr_value_box_strdup	(	TALLOC_CTX *	ctx,
		fr_value_box_t *	dst,
		fr_dict_attr_t const *	enumv,
		char const *	src,
		bool	tainted
	)

Copy a nul terminated string to a fr_value_box_t.

Parameters

[in]	ctx	to allocate any new buffers in.
[in]	dst	to assign new buffer to.
[in]	enumv	Aliases for values.
[in]	src	a nul terminated buffer.
[in]	tainted	Whether the value came from a trusted source.

Returns

0 on success.
-1 on failure.

Definition at line 3876 of file value.c.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ fr_value_box_strdup_shallow()

void fr_value_box_strdup_shallow	(	fr_value_box_t *	dst,
		fr_dict_attr_t const *	enumv,
		char const *	src,
		bool	tainted
	)

Assign a buffer containing a nul terminated string to a box, but don't copy it.

Note: Input string will not be duplicated.

Parameters

[in]	dst	to assign string to.
[in]	enumv	Aliases for values.
[in]	src	to copy string from.
[in]	tainted	Whether the value came from a trusted source.

Definition at line 3985 of file value.c.

Here is the caller graph for this function:

◆ fr_value_box_strdup_shallow_replace()

void fr_value_box_strdup_shallow_replace	(	fr_value_box_t *	vb,
		char const *	src,
		ssize_t	len
	)

Free the existing buffer (if talloced) associated with the valuebox, and replace it with a new one.

Note: Input string will not be duplicated.

Parameters

[in]	vb	to replace string in.
[in]	src	to assign string from.
[in]	len	of src.

Definition at line 4001 of file value.c.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ fr_value_box_strtrim()

int fr_value_box_strtrim	(	TALLOC_CTX *	ctx,
		fr_value_box_t *	vb
	)

Trim the length of the string buffer to match the length of the C string.

Parameters

[in]	ctx	to re-alloc the buffer in.
[in,out]	vb	to trim.

Returns

0 on success.
-1 on failure.

Definition at line 3902 of file value.c.

Here is the caller graph for this function:

◆ fr_value_box_to_key()

int fr_value_box_to_key	(	uint8_t **	out,
		size_t *	outlen,
		fr_value_box_t const *	value
	)

Get a key from a value box.

Parameters

[in,out]	out	- set to a small buffer on input. If the callback has more data than is available here, the callback can update "out" to point elsewhere
[in,out]	outlen	The number of bits available in the initial buffer. On output, the number of bits available in the key
[in]	value	the value box which contains the key

Returns

<0 on error
0 on success

Definition at line 2039 of file value.c.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ fr_value_box_to_network()

ssize_t fr_value_box_to_network	(	fr_dbuff_t *	dbuff,
		fr_value_box_t const *	value
	)

Encode a single value box, serializing its contents in generic network format.

The serialized form of fr_value_box_t may not match the requirements of your protocol completely. In cases where they do not, you should overload specific types in the function calling fr_value_box_to_network.

The general serialization rules are:

Octets are encoded in binary form (not hex).
Strings are encoded without the trailing \0 byte.
Integers are encoded big-endian.
Bools are encoded using one byte, with value 0x00 (false) or 0x01 (true).
Signed integers are encoded two's complement, with the MSB as the sign bit. Byte order is big-endian.
Network addresses are encoded big-endian.
IPv4 prefixes are encoded with 1 byte for the prefix, then 4 bytes of address.
IPv6 prefixes are encoded with 1 byte for the scope_id, 1 byte for the prefix, and 16 bytes of address.
Floats are encoded in IEEE-754 format with a big-endian byte order. We rely on the fact that the C standards require floats to be represented in IEEE-754 format in memory.
Dates are encoded as 16/32/64-bit unsigned UNIX timestamps.
time_deltas are encoded as 16/32/64-bit signed integers.

FR_TYPE_SIZE is not encodable, as it is system specific.

This function will not encode structural types (TLVs, VSAs etc...). These are usually specific to the protocol anyway.

All of the dictionary rules are respected. string/octets can have a fixed length (which is zero-padded if necessary), or can have an 8/16-bit "length" prefix.

Parameters

[out]	dbuff	Where to write serialized data.
[in]	value	to encode.

Returns

0 no bytes were written.
>0 the number of bytes written to out.
<0 the number of bytes we'd need in dbuff to complete the operation.

Definition at line 1359 of file value.c.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ fr_value_box_vasprintf()

int fr_value_box_vasprintf	(	TALLOC_CTX *	ctx,
		fr_value_box_t *	dst,
		fr_dict_attr_t const *	enumv,
		bool	tainted,
		char const *	fmt,
		va_list	ap
	)

Print a formatted string using our internal printf wrapper and assign it to a value box.

Parameters

[in]	ctx	to allocate any new buffers in.
[in]	dst	to assign new buffer to.
[in]	enumv	Aliases for values.
[in]	fmt	The printf format string to process.
[in]	tainted	Whether the value came from a trusted source.
[in]	ap	Substitution arguments.

Returns

0 on success.
-1 on failure.

Definition at line 3932 of file value.c.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ fr_value_box_verify()

void fr_value_box_verify	(	char const *	file,
		int	line,
		fr_value_box_t const *	vb
	)

Validation function to check that a fr_value_box_t is correctly initialised.

Definition at line 6177 of file value.c.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ fr_value_str_unescape()

size_t fr_value_str_unescape	(	fr_sbuff_t *	out,
		fr_sbuff_t *	in,
		size_t	inlen,
		char	quote
	)

Convert a string value with escape sequences into its binary form.

The quote character determines the escape sequences recognised.

Literal mode ("'" quote char) will unescape:

  - \\        - Literal backslash.
  - \<quote>  - The quotation char.

Expanded mode ('"' quote char) will also unescape:

  - \a        - Alert.
  - \b        - Backspace.
  - \e        - Escape character i.e. (\‍)
  - \r        - Carriage return.
  - \n        - Newline.
  - \t        - Tab.
  - \v        - Vertical tab
  - \<oct>    - An octal escape sequence.
  - \x<hex>   - A hex escape sequence.

Backtick mode ('‘’ quote char) identical to expanded mode.
Regex mode ('/') identical to expanded mode but two successive backslashes will be interpreted as an escape sequence, but not unescaped, so that they will be passed to the underlying regex library.
Verbatim mode ('\0' quote char) copies in to out verbatim.

Note: The resulting output may contain embedded \0s.; Unrecognised escape sequences will be copied verbatim.; In and out may point to the same underlying buffer.; Copying will stop early if an unescaped instance of the quoting char is found in the input buffer.

Parameters

[out]	out	Where to write the unescaped string.
[in]	in	The string to unescape.
[in]	inlen	Length of input string. Pass SIZE_MAX to copy all data in the input buffer.
[in]	quote	Character around the string, determines unescaping mode.

Returns

0 if input string was empty.
>0 the number of bytes written to out.

Definition at line 1083 of file value.c.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ fr_value_substr_unescape()

size_t fr_value_substr_unescape	(	fr_sbuff_t *	out,
		fr_sbuff_t *	in,
		size_t	inlen,
		char	quote
	)

Convert a string value with escape sequences into its binary form.

The quote character determines the escape sequences recognised.

Literal mode ("'" quote char) will unescape:

  - \\        - Literal backslash.
  - \<quote>  - The quotation char.

Expanded mode ('"' quote char) will also unescape:

  - \a        - Alert.
  - \b        - Backspace.
  - \e        - Escape character i.e. (\‍)
  - \r        - Carriage return.
  - \n        - Newline.
  - \t        - Tab.
  - \v        - Vertical tab
  - \<oct>    - An octal escape sequence.
  - \x<hex>   - A hex escape sequence.

Backtick mode ('‘’ quote char) identical to expanded mode.
Regex mode ('/') identical to expanded mode but two successive backslashes will be interpreted as an escape sequence, but not unescaped, so that they will be passed to the underlying regex library.
Verbatim mode ('\0' quote char) copies in to out verbatim.

Note: The resulting output may contain embedded \0s.; Unrecognised escape sequences will be copied verbatim.; In and out may point to the same underlying buffer.; Copying will stop early if an unescaped instance of the quoting char is found in the input buffer.

Parameters

[out]	out	Where to write the unescaped string.
[in]	in	The string to unescape.
[in]	inlen	Length of input string. Pass SIZE_MAX to copy all data in the input buffer.
[in]	quote	Character around the string, determines unescaping mode.

Returns

0 if input string was empty.
>0 the number of bytes written to out.

Definition at line 1156 of file value.c.

Here is the call graph for this function:

◆ fr_value_unbox_ipaddr()

int fr_value_unbox_ipaddr	(	fr_ipaddr_t *	dst,
		fr_value_box_t *	src
	)

Unbox an IP address performing a type check.

Parameters

[out]	dst	Where to copy the IP address to.
[in]	src	Where to copy the IP address from.

Returns

0 on success.
-1 on type mismatch.

Definition at line 3611 of file value.c.

Here is the call graph for this function:

Variable Documentation

◆ fr_value_box_field_sizes

size_t const fr_value_box_field_sizes[]

How many bytes wide each of the value data fields are.

This is useful when copying a value from a fr_value_box_t to a memory location passed as a void *.

Definition at line 149 of file value.c.

◆ fr_value_box_integer_max

uint64_t const fr_value_box_integer_max[]

static

Initial value:

= {
        [FR_TYPE_BOOL]                          = true,
        [FR_TYPE_UINT8]                         = UINT8_MAX,
        [FR_TYPE_UINT16]                        = UINT16_MAX,
        [FR_TYPE_UINT32]                        = UINT32_MAX,
        [FR_TYPE_UINT64]                        = UINT64_MAX,
 
        [FR_TYPE_INT8]                          = INT8_MAX,
        [FR_TYPE_INT16]                         = INT16_MAX,
        [FR_TYPE_INT32]                         = INT32_MAX,
        [FR_TYPE_INT64]                         = INT64_MAX,
 
        [FR_TYPE_DATE]                          = UINT64_MAX,
        [FR_TYPE_TIME_DELTA]                    = INT64_MAX,
 
        [FR_TYPE_SIZE]                          = SIZE_MAX,
 
        [FR_TYPE_MAX]                           = 0     
}

Definition at line 226 of file value.c.

◆ fr_value_box_integer_min

int64_t const fr_value_box_integer_min[]

static

Initial value:

= {
        [FR_TYPE_BOOL]                          = false,
        [FR_TYPE_UINT8]                         = 0,
        [FR_TYPE_UINT16]                        = 0,
        [FR_TYPE_UINT32]                        = 0,
        [FR_TYPE_UINT64]                        = 0,
 
        [FR_TYPE_INT8]                          = INT8_MIN,
        [FR_TYPE_INT16]                         = INT16_MIN,
        [FR_TYPE_INT32]                         = INT32_MIN,
        [FR_TYPE_INT64]                         = INT64_MIN,
 
        [FR_TYPE_DATE]                          = 0,
        [FR_TYPE_TIME_DELTA]                    = INT64_MIN,
 
        [FR_TYPE_SIZE]                          = 0,
 
        [FR_TYPE_MAX]                           = 0     
}

Definition at line 246 of file value.c.

◆ fr_value_box_network_sizes

size_t const fr_value_box_network_sizes[FR_TYPE_MAX+1][2]

static

Definition at line 109 of file value.c.

◆ fr_value_box_offsets

size_t const fr_value_box_offsets[]

Where the value starts in the fr_value_box_t.

Definition at line 189 of file value.c.

◆ fr_value_escape_backtick

fr_sbuff_escape_rules_t fr_value_escape_backtick

Initial value:

= {
        .name = "backtick",
        .chr = '\\',
        .subs = {
                ['%'] = '%',    
                ['\\'] = '\\',
                ['`'] = '`',    
                ['\a'] = 'a',
                ['\b'] = 'b',
                ['\n'] = 'n',
                ['\r'] = 'r',
                ['\t'] = 't',
                ['\v'] = 'v'
        },
        .esc = {
                SBUFF_CHAR_UNPRINTABLES_LOW,
                SBUFF_CHAR_UNPRINTABLES_EXTENDED
        },
        .do_utf8 = true,
        .do_oct = true
}

Definition at line 419 of file value.c.

◆ fr_value_escape_by_char

fr_sbuff_escape_rules_t* fr_value_escape_by_char[UINT8_MAX+1]

Initial value:

= {
        ['"']   = &fr_value_escape_double,
        ['\'']  = &fr_value_escape_single,
        ['/']   = &fr_value_escape_solidus,
        ['`']   = &fr_value_escape_backtick,
}

Definition at line 448 of file value.c.

◆ fr_value_escape_by_quote

fr_sbuff_escape_rules_t* fr_value_escape_by_quote[T_TOKEN_LAST]

Initial value:

= {
        [T_DOUBLE_QUOTED_STRING]        = &fr_value_escape_double,
        [T_SINGLE_QUOTED_STRING]        = &fr_value_escape_single,
        [T_SOLIDUS_QUOTED_STRING]       = &fr_value_escape_solidus,
        [T_BACK_QUOTED_STRING]          = &fr_value_escape_backtick,
}

Definition at line 441 of file value.c.

◆ fr_value_escape_double

fr_sbuff_escape_rules_t fr_value_escape_double

Initial value:

= {
        .name = "double",
        .chr = '\\',
        .subs = {
                ['"'] = '"',    
                ['%'] = '%',    
                ['\\'] = '\\',
                ['\a'] = 'a',
                ['\b'] = 'b',
                ['\n'] = 'n',
                ['\r'] = 'r',
                ['\t'] = 't',
                ['\v'] = 'v'
        },
        .esc = {
                SBUFF_CHAR_UNPRINTABLES_LOW,
                SBUFF_CHAR_UNPRINTABLES_EXTENDED
        },
        .do_utf8 = true,
        .do_oct = true
}

Definition at line 350 of file value.c.

◆ fr_value_escape_secret

fr_sbuff_escape_rules_t fr_value_escape_secret

Initial value:

= {
        .name = "secret",
        .subs = {
                [ 0 ... 255 ] = '.',
        },
}

Escape secret fields by simply mashing all data to '.

'

The length of the secret still leaks, but that is likely fine. Fixing that is more work.

Definition at line 381 of file value.c.

◆ fr_value_escape_single

fr_sbuff_escape_rules_t fr_value_escape_single

Initial value:

= {
        .name = "single",
        .chr = '\\',
        .subs = {
                ['\''] = '\'',  
                ['\\'] = '\\'
        },
        .do_utf8 = true,
}

Definition at line 388 of file value.c.

◆ fr_value_escape_solidus

fr_sbuff_escape_rules_t fr_value_escape_solidus

Initial value:

= {
        .name = "solidus",
        .chr = '\\',
        .subs = {
                ['%'] = '%',    
                ['/'] = '/',    
                ['\a'] = 'a',
                ['\b'] = 'b',
                ['\n'] = 'n',
                ['\r'] = 'r',
                ['\t'] = 't',
                ['\v'] = 'v'
        },
        .esc = {
                SBUFF_CHAR_UNPRINTABLES_LOW,
                SBUFF_CHAR_UNPRINTABLES_EXTENDED
        },
        .do_utf8 = true,
        .do_oct = true
}

Definition at line 398 of file value.c.

◆ fr_value_escape_unprintables

fr_sbuff_escape_rules_t fr_value_escape_unprintables

Initial value:

= {
        .name = "unprintables",
        .chr = '\\',
        .subs = {
                ['\\'] = '\\',
        },
        .esc = {
                SBUFF_CHAR_UNPRINTABLES_LOW,
                SBUFF_CHAR_UNPRINTABLES_EXTENDED
        },
        .do_utf8 = true,
        .do_oct = true
}

Definition at line 455 of file value.c.

◆ fr_value_unescape_backtick

fr_sbuff_unescape_rules_t fr_value_unescape_backtick

Initial value:

= {
        .name = "backtick",
        .chr = '\\',
        .subs = {
                ['%'] = '%',    
                ['\\'] = '\\',
                ['`'] = '`',    
                ['a'] = '\a',
                ['b'] = '\b',
                ['e'] = '\\',
                ['n'] = '\n',
                ['r'] = '\r',
                ['t'] = '\t',
                ['v'] = '\v'
        },
        .do_hex = true,
        .do_oct = true
}

Definition at line 317 of file value.c.

◆ fr_value_unescape_by_char

fr_sbuff_unescape_rules_t* fr_value_unescape_by_char[UINT8_MAX+1]

Initial value:

= {
        ['"']   = &fr_value_unescape_double,
        ['\'']  = &fr_value_unescape_single,
        ['/']   = &fr_value_unescape_solidus,
        ['`']   = &fr_value_unescape_backtick,
}

Definition at line 343 of file value.c.

◆ fr_value_unescape_by_quote

fr_sbuff_unescape_rules_t* fr_value_unescape_by_quote[T_TOKEN_LAST]

Initial value:

= {
        [T_DOUBLE_QUOTED_STRING]        = &fr_value_unescape_double,
        [T_SINGLE_QUOTED_STRING]        = &fr_value_unescape_single,
        [T_SOLIDUS_QUOTED_STRING]       = &fr_value_unescape_solidus,
        [T_BACK_QUOTED_STRING]          = &fr_value_unescape_backtick,
}

Definition at line 336 of file value.c.

◆ fr_value_unescape_double

fr_sbuff_unescape_rules_t fr_value_unescape_double

Initial value:

= {
        .name = "double",
        .chr = '\\',
        .subs = {
                ['"'] = '"',    
                ['%'] = '%',    
                ['\\'] = '\\',
                ['a'] = '\a',
                ['b'] = '\b',
                ['e'] = '\\',
                ['n'] = '\n',
                ['r'] = '\r',
                ['t'] = '\t',
                ['v'] = '\v'
        },
        .do_hex = true,
        .do_oct = true
}

Definition at line 266 of file value.c.

◆ fr_value_unescape_single

fr_sbuff_unescape_rules_t fr_value_unescape_single

Initial value:

= {
        .name = "single",
        .chr = '\\',
        .subs = {
                ['\''] = '\'',  
                ['\\'] = '\\'
        },
        .do_hex = false,
        .do_oct = false
}

Definition at line 285 of file value.c.

◆ fr_value_unescape_solidus

fr_sbuff_unescape_rules_t fr_value_unescape_solidus

Initial value:

= {
        .name = "solidus",
        .chr = '\\',
        .subs = {
                ['%'] = '%',    
                ['/'] = '/',    
                ['a'] = '\a',
                ['b'] = '\b',
                ['e'] = '\\',
                ['n'] = '\n',
                ['r'] = '\r',
                ['t'] = '\t',
                ['v'] = '\v'
        },
        .skip = {
                ['\\'] = '\\'   
        },
        .do_hex = true,
        .do_oct = true
}

Definition at line 296 of file value.c.

◆ v4_v6_map

uint8_t const v4_v6_map[]

static

Initial value:

= { 0x00, 0x00, 0x00, 0x00, 0x00, 0x00,

0x00, 0x00, 0x00, 0x00, 0xff, 0xff }

v4 to v6 mapping prefix

Part of the IPv6 range is allocated to represent IPv4 addresses.

Definition at line 2144 of file value.c.

◆ value_parse_rules_backtick_quoted

fr_sbuff_parse_rules_t const value_parse_rules_backtick_quoted

Initial value:

= {
        .escapes = &fr_value_unescape_backtick,
        .terminals = &FR_SBUFF_TERMS(
                L(""), L("\n"), L("\r"), L("`"))
}

Definition at line 565 of file value.c.

◆ value_parse_rules_backtick_unquoted

fr_sbuff_parse_rules_t const value_parse_rules_backtick_unquoted

Initial value:

= {
        .escapes = &fr_value_unescape_backtick
}

Definition at line 496 of file value.c.

◆ value_parse_rules_bareword_quoted

fr_sbuff_parse_rules_t const value_parse_rules_bareword_quoted

Initial value:

= {
        .escapes = &(fr_sbuff_unescape_rules_t){
                .chr = '\\',
                
                .subs = {
                        ['\t'] = '\t',
                        ['\n'] = '\n',
                        [' '] = ' '
                },
                .do_hex = false,
                .do_oct = false
        },
        .terminals = &FR_SBUFF_TERMS(
                L(""),
                L("\t"),
                L("\n"),
                L(" ")
        )
}

Definition at line 524 of file value.c.

◆ value_parse_rules_bareword_unquoted

fr_sbuff_parse_rules_t const value_parse_rules_bareword_unquoted

Initial value:

= {
 
}

Default formatting rules.

Control token termination, escaping and how the tmpl is printed.

Definition at line 480 of file value.c.

◆ value_parse_rules_double_quoted

fr_sbuff_parse_rules_t const value_parse_rules_double_quoted

Initial value:

= {
        .escapes = &fr_value_unescape_double,
        .terminals = &FR_SBUFF_TERMS(
                L(""), L("\n"), L("\r"), L("\""))
}

Definition at line 547 of file value.c.

◆ value_parse_rules_double_unquoted

fr_sbuff_parse_rules_t const value_parse_rules_double_unquoted

Initial value:

= {
        .escapes = &fr_value_unescape_double
}

Definition at line 484 of file value.c.

◆ value_parse_rules_quoted

fr_sbuff_parse_rules_t const* value_parse_rules_quoted[T_TOKEN_LAST]

Initial value:

= {
        [T_BARE_WORD]                   = &value_parse_rules_bareword_quoted,
        [T_DOUBLE_QUOTED_STRING]        = &value_parse_rules_double_quoted,
        [T_SINGLE_QUOTED_STRING]        = &value_parse_rules_single_quoted,
        [T_SOLIDUS_QUOTED_STRING]       = &value_parse_rules_solidus_quoted,
        [T_BACK_QUOTED_STRING]          = &value_parse_rules_backtick_quoted
}

Parse rules for quoted strings.

These parse rules should be used for internal parsing functions that are working with configuration files.

They include appropriate quote terminals to force functions parsing quoted strings to return when they reach a quote character.

Definition at line 579 of file value.c.

◆ value_parse_rules_quoted_char

fr_sbuff_parse_rules_t const* value_parse_rules_quoted_char[UINT8_MAX]

Initial value:

= {
        ['\0']                          = &value_parse_rules_bareword_quoted,
        ['"']                           = &value_parse_rules_double_quoted,
        ['\'']                          = &value_parse_rules_single_quoted,
        ['/']                           = &value_parse_rules_solidus_quoted,
        ['`']                           = &value_parse_rules_backtick_quoted
}

Definition at line 587 of file value.c.

◆ value_parse_rules_single_quoted

fr_sbuff_parse_rules_t const value_parse_rules_single_quoted

Initial value:

= {
        .escapes = &fr_value_unescape_single,
        .terminals = &FR_SBUFF_TERMS(
                L(""), L("\n"), L("\r"), L("'"))
}

Definition at line 553 of file value.c.

◆ value_parse_rules_single_unquoted

fr_sbuff_parse_rules_t const value_parse_rules_single_unquoted

Initial value:

= {
        .escapes = &fr_value_unescape_single
}

Definition at line 488 of file value.c.

◆ value_parse_rules_solidus_quoted

fr_sbuff_parse_rules_t const value_parse_rules_solidus_quoted

Initial value:

= {
        .escapes = &fr_value_unescape_solidus,
        .terminals = &FR_SBUFF_TERMS(
                L(""), L("\n"), L("\r"), L("/"))
}

Definition at line 559 of file value.c.

◆ value_parse_rules_solidus_unquoted

fr_sbuff_parse_rules_t const value_parse_rules_solidus_unquoted

Initial value:

= {
        .escapes = &fr_value_unescape_solidus
}

Definition at line 492 of file value.c.

◆ value_parse_rules_unquoted

fr_sbuff_parse_rules_t const* value_parse_rules_unquoted[T_TOKEN_LAST]

Initial value:

= {
        [T_BARE_WORD]                   = &value_parse_rules_bareword_unquoted,
        [T_DOUBLE_QUOTED_STRING]        = &value_parse_rules_double_unquoted,
        [T_SINGLE_QUOTED_STRING]        = &value_parse_rules_single_unquoted,
        [T_SOLIDUS_QUOTED_STRING]       = &value_parse_rules_solidus_unquoted,
        [T_BACK_QUOTED_STRING]          = &value_parse_rules_backtick_unquoted
}

Parse rules for non-quoted strings.

These parse rules should be used for processing escape sequences in data from external data sources like SQL databases and REST APIs.

They do not include terminals to stop parsing as it assumes the values are discrete, and not wrapped in quotes.

Definition at line 508 of file value.c.

◆ value_parse_rules_unquoted_char

fr_sbuff_parse_rules_t const* value_parse_rules_unquoted_char[UINT8_MAX]

Initial value:

= {
        ['\0']                          = &value_parse_rules_bareword_unquoted,
        ['"']                           = &value_parse_rules_double_unquoted,
        ['\'']                          = &value_parse_rules_single_unquoted,
        ['/']                           = &value_parse_rules_solidus_unquoted,
        ['`']                           = &value_parse_rules_backtick_unquoted
}

Definition at line 516 of file value.c.

Macros

Functions

Variables

Produce a #tmpl_t from a string or substring

Detailed Description

Macro Definition Documentation

◆ _VALUE_PRIVATE

◆ CAST_IP_FIX_COMBO

◆ COMPARE

◆ INFO_INDENT

◆ network_max_size

◆ network_min_size

◆ RETURN

◆ SIGN_BIT_HIGH

◆ SIGN_PROMOTE

Function Documentation

◆ _fr_value_box_debug()

◆ _fr_value_box_list_debug()

◆ _fr_value_box_mark_safe_for()

◆ fr_dbuff_set()

◆ fr_regex_cmp_op()

◆ FR_SBUFF_SET_RETURN()

◆ fr_value_box_asprintf()

◆ fr_value_box_bstr_alloc()

◆ fr_value_box_bstr_append_buffer()

◆ fr_value_box_bstr_realloc()

◆ fr_value_box_bstrdup_buffer()

◆ fr_value_box_bstrdup_buffer_shallow()

◆ fr_value_box_bstrn_append()

◆ fr_value_box_bstrndup()

◆ fr_value_box_bstrndup_dbuff()

◆ fr_value_box_bstrndup_shallow()

◆ fr_value_box_cast()

◆ fr_value_box_cast_in_place()

◆ fr_value_box_cast_integer_to_integer()

◆ fr_value_box_cast_to_bool()

◆ fr_value_box_cast_to_ethernet()

◆ fr_value_box_cast_to_float()

◆ fr_value_box_cast_to_integer()

◆ fr_value_box_cast_to_ipv4addr()

◆ fr_value_box_cast_to_ipv4prefix()

◆ fr_value_box_cast_to_ipv6addr()

◆ fr_value_box_cast_to_ipv6prefix()

◆ fr_value_box_cast_to_octets()

◆ fr_value_box_cast_to_strvalue()

◆ fr_value_box_cidr_cmp_op()

◆ fr_value_box_clear()

◆ fr_value_box_clear_value()

◆ fr_value_box_cmp()

◆ fr_value_box_cmp_op()

◆ fr_value_box_copy()

◆ fr_value_box_copy_meta()

◆ fr_value_box_copy_shallow()

◆ fr_value_box_debug()

◆ fr_value_box_escape_in_place()

◆ fr_value_box_fixed_size_from_octets()

◆ fr_value_box_flatten()

◆ fr_value_box_from_network()

◆ fr_value_box_from_numeric_substr()

◆ fr_value_box_from_str()

◆ fr_value_box_from_substr()

◆ fr_value_box_hash()

◆ fr_value_box_hton()

◆ fr_value_box_increment()

◆ fr_value_box_ipaddr()

◆ fr_value_box_is_truthy()

◆ fr_value_box_list_acopy()

◆ fr_value_box_list_aprint()

◆ fr_value_box_list_aprint_secure()

◆ fr_value_box_list_concat_as_octets()

◆ fr_value_box_list_concat_as_string()

◆ fr_value_box_list_concat_in_place()

◆ fr_value_box_list_debug()

◆ fr_value_box_list_escape_in_place()

◆ fr_value_box_list_mark_safe_for()

◆ fr_value_box_list_taint()

◆ fr_value_box_list_tainted()

◆ fr_value_box_list_untaint()

◆ fr_value_box_list_verify()

◆ fr_value_box_mark_unsafe()