Structures and prototypes for maps. More...

#include <freeradius-devel/server/cf_util.h>
#include <freeradius-devel/server/tmpl.h>
#include <freeradius-devel/util/dlist.h>

Include dependency graph for map.h:

Go to the source code of this file.

Data Structures
struct	map_s
	Value pair map. More...

struct	vp_list_mod_s
	A list modification. More...

Macros
#define	MAP_LHS_TERMINALS
	Single character tokens used as terminals for the LHS operand.

#define	MAP_VERIFY(_x) fr_assert((_x)->lhs)

Typedefs
typedef struct map_s	map_t

typedef int(*	map_validate_t) (map_t map, void ctx)

typedef int(*	radius_map_getvalue_t) (TALLOC_CTX ctx, fr_pair_list_t out, request_t request, map_t const map, void *uctx)

typedef struct vp_list_mod_s	vp_list_mod_t

Functions
typedef	FR_DLIST_HEAD (map_list) map_list_t
	Given these are used in so many places, it's more friendly to have a proper type.

int	map_afrom_attr_str (TALLOC_CTX ctx, map_t out, char const raw, tmpl_rules_t const lhs_rules, tmpl_rules_t const rhs_rules)
	Convert a value pair string to valuepair map.

int	map_afrom_cp (TALLOC_CTX ctx, map_t out, map_t parent, CONF_PAIR cp, tmpl_rules_t const lhs_rules, tmpl_rules_t const *rhs_rules, bool edit)
	Convert CONFIG_PAIR (which may contain refs) to map_t.

int	map_afrom_cs (TALLOC_CTX ctx, map_list_t out, CONF_SECTION cs, tmpl_rules_t const lhs_rules, tmpl_rules_t const rhs_rules, map_validate_t validate, void uctx, unsigned int max))
	Convert a config section into an attribute map.

int	map_afrom_cs_edit (TALLOC_CTX ctx, map_list_t out, CONF_SECTION cs, tmpl_rules_t const lhs_rules, tmpl_rules_t const rhs_rules, map_validate_t validate, void uctx, unsigned int max))
	Convert a config section into an attribute map for editing.

int	map_afrom_fields (TALLOC_CTX ctx, map_t out, map_t parent_p, request_t request, char const lhs, char const op, char const rhs, tmpl_rules_t const lhs_rules, tmpl_rules_t const *rhs_rules, bool bare_word_only)
	Convert a fr_pair_t into a map.

ssize_t	map_afrom_substr (TALLOC_CTX ctx, map_t out, map_t parent_p, fr_sbuff_t in, fr_table_num_sorted_t const op_table, size_t op_table_len, tmpl_rules_t const lhs_rules, tmpl_rules_t const rhs_rules, fr_sbuff_parse_rules_t const p_rules))
	Parse sbuff into (which may contain refs) to map_t.

int	map_afrom_value_box (TALLOC_CTX ctx, map_t out, char const lhs, fr_token_t lhs_type, tmpl_rules_t const lhs_rules, fr_token_t op, fr_value_box_t rhs, bool steal_rhs_buffs)
	Convert a value box to a map.

int	map_afrom_vp (TALLOC_CTX ctx, map_t out, fr_pair_t vp, tmpl_rules_t const *rules)
	Convert a fr_pair_t into a map.

void	map_debug_log (request_t request, map_t const map, fr_pair_t const *vp))

int	map_list_afrom_cs (TALLOC_CTX ctx, map_list_t out, CONF_SECTION cs, tmpl_rules_t const t_rules, map_validate_t validate, void *uctx, unsigned int max)
	Convert a config section into a list of { a, b, c, d, ... }.

int	map_list_mod_apply (request_t request, vp_list_mod_t const vlm)
	Apply the output of map_to_list_mod to a request.

ssize_t	map_print (fr_sbuff_t out, map_t const map)
	Print a map to a string.

int	map_to_list_mod (TALLOC_CTX ctx, vp_list_mod_t out, request_t request, map_t const map, fr_value_box_list_t lhs_result, fr_value_box_list_t *rhs_result)
	Evaluate a map creating a new map with TMPL_TYPE_ATTR LHS and TMPL_TYPE_DATA RHS.

int	map_to_request (request_t request, map_t const map, radius_map_getvalue_t func, void *ctx)
	Convert map_t to fr_pair_t (s) and add them to a request_t.

int	map_to_vp (TALLOC_CTX ctx, fr_pair_list_t out, request_t request, map_t const map, void *uctx))

Variables
fr_table_num_sorted_t const	map_assignment_op_table []

size_t	map_assignment_op_table_len

fr_sbuff_parse_rules_t const	map_parse_rules_bareword_quoted

fr_sbuff_parse_rules_t const *	map_parse_rules_quoted [T_TOKEN_LAST]

Detailed Description

Structures and prototypes for maps.

Id: 8b8ec96faafb79d13698b6a4e75be3e527f2c5b2

Copyright: 2015 The FreeRADIUS server project; 2015 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 map.h.

Data Structure Documentation

◆ vp_list_mod_s

struct vp_list_mod_s

A list modification.

Definition at line 99 of file map.h.

Collaboration diagram for vp_list_mod_s:

Data Fields
fr_dlist_t	entry	Entry into dlist.
map_t const *	map	Original map describing the change to be made.
map_list_t	mod	New map containing the destination (LHS) and values (RHS).

Macro Definition Documentation

◆ MAP_LHS_TERMINALS

#define MAP_LHS_TERMINALS

Value:

        ['-'] = true, \
        [':'] = true, \
        ['+'] = true, \
        ['<'] = true, \
        ['='] = true, \
        ['>'] = true, \
        ['~'] = true

Single character tokens used as terminals for the LHS operand.

Definition at line 51 of file map.h.

◆ MAP_VERIFY

#define MAP_VERIFY ( _x ) fr_assert((_x)->lhs)

Definition at line 108 of file map.h.

Typedef Documentation

◆ map_t

typedef struct map_s map_t

Definition at line 33 of file map.h.

◆ map_validate_t

typedef int(* map_validate_t) (map_t *map, void *ctx)

Definition at line 116 of file map.h.

◆ radius_map_getvalue_t

typedef int(* radius_map_getvalue_t) (TALLOC_CTX *ctx, fr_pair_list_t *out, request_t *request, map_t const *map, void *uctx)

Definition at line 117 of file map.h.

◆ vp_list_mod_t

typedef struct vp_list_mod_s vp_list_mod_t

Definition at line 34 of file map.h.

Function Documentation

◆ FR_DLIST_HEAD()

typedef FR_DLIST_HEAD ( map_list )

Given these are used in so many places, it's more friendly to have a proper type.

◆ map_afrom_attr_str()

int map_afrom_attr_str	(	TALLOC_CTX *	ctx,
		map_t **	out,
		char const *	vp_str,
		tmpl_rules_t const *	lhs_rules,
		tmpl_rules_t const *	rhs_rules
	)

Convert a value pair string to valuepair map.

Takes a valuepair string with list and request qualifiers and converts it into a map_t.

Attribute string is in the format (where

<qu>

is a quotation char ['"]):

  [<list>.][<qu>]<attribute>[<qu>] <op> [<qu>]<value>[<qu>]

Parameters

[in]	ctx	where to allocate the map.
[out]	out	Where to write the new map.
[in]	vp_str	string to parse.
[in]	lhs_rules	rules for parsing LHS attribute references.
[in]	rhs_rules	rules for parsing RHS attribute references.

Returns

0 on success.
< 0 on error.

Definition at line 1428 of file map.c.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ map_afrom_cp()

int map_afrom_cp	(	TALLOC_CTX *	ctx,
		map_t **	out,
		map_t *	parent,
		CONF_PAIR *	cp,
		tmpl_rules_t const *	lhs_rules,
		tmpl_rules_t const *	input_rhs_rules,
		bool	edit
	)

Convert CONFIG_PAIR (which may contain refs) to map_t.

Treats the left operand as an attribute reference

<request>.<list>.<attribute>

Treatment of left operand depends on quotation, barewords are treated as attribute references, double quoted values are treated as expandable strings, single quoted values are treated as literal strings.

Return must be freed with talloc_free

Parameters

[in]	ctx	for talloc.
[in]	out	Where to write the pointer to the new map_t.
[in]	parent	the parent map
[in]	cp	to convert to map.
[in]	lhs_rules	rules for parsing LHS attribute references.
[in]	input_rhs_rules	rules for parsing RHS attribute references.
[in]	edit	treat the map as an edit

Returns

map_t if successful.
NULL on error.

Definition at line 105 of file map.c.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ map_afrom_cs()

int map_afrom_cs	(	TALLOC_CTX *	ctx,
		map_list_t *	out,
		CONF_SECTION *	cs,
		tmpl_rules_t const *	lhs_rules,
		tmpl_rules_t const *	rhs_rules,
		map_validate_t	validate,
		void *	uctx,
		unsigned int	max
	)

Convert a config section into an attribute map.

For "update" sections, Uses 'name2' of section to set default request and lists.

Parameters

[in]	ctx	for talloc.
[out]	out	Where to store the allocated map.
[in]	cs	the update section
[in]	lhs_rules	rules for parsing LHS attribute references.
[in]	rhs_rules	rules for parsing RHS attribute references.
[in]	validate	map using this callback (may be NULL).
[in]	uctx	to pass to callback.
[in]	max	number of mappings to process.

Returns

0 on success.
-1 on failure.

Definition at line 1131 of file map.c.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ map_afrom_cs_edit()

int map_afrom_cs_edit	(	TALLOC_CTX *	ctx,
		map_list_t *	out,
		CONF_SECTION *	cs,
		tmpl_rules_t const *	lhs_rules,
		tmpl_rules_t const *	rhs_rules,
		map_validate_t	validate,
		void *	uctx,
		unsigned int	max
	)

Convert a config section into an attribute map for editing.

Parameters

[in]	ctx	for talloc.
[out]	out	Where to store the allocated map.
[in]	cs	the update section
[in]	lhs_rules	rules for parsing LHS attribute references.
[in]	rhs_rules	rules for parsing RHS attribute references.
[in]	validate	map using this callback (may be NULL).
[in]	uctx	to pass to callback.
[in]	max	number of mappings to process.

Returns

0 on success.
-1 on failure.

Definition at line 1162 of file map.c.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ map_afrom_fields()

int map_afrom_fields	(	TALLOC_CTX *	ctx,
		map_t **	out,
		map_t **	parent_p,
		request_t *	request,
		char const *	lhs,
		char const *	op_str,
		char const *	rhs,
		tmpl_rules_t const *	lhs_rules,
		tmpl_rules_t const *	rhs_rules,
		bool	bare_word_only
	)

Convert a fr_pair_t into a map.

Parameters

[in]	ctx	where to allocate the map.
[out]	out	Where to write the new map (must be freed with talloc_free()).
[in,out]	parent_p	the parent map, updated for relative maps
[in]	request	the request
[in]	lhs	of map
[in]	op_str	operator for map
[in]	rhs	of map
[in]	lhs_rules	for parsing the LHS
[in]	rhs_rules	for parsing the RHS
[in]	bare_word_only	RHS is bare words, and nothing else.

Returns

0 on success.
-1 on failure.

Definition at line 2527 of file map.c.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ map_afrom_substr()

ssize_t map_afrom_substr	(	TALLOC_CTX *	ctx,
		map_t **	out,
		map_t **	parent_p,
		fr_sbuff_t *	in,
		fr_table_num_sorted_t const *	op_table,
		size_t	op_table_len,
		tmpl_rules_t const *	lhs_rules,
		tmpl_rules_t const *	rhs_rules,
		fr_sbuff_parse_rules_t const *	p_rules
	)

Parse sbuff into (which may contain refs) to map_t.

This function uses the legacy operator meanings. The maps created here should only be used with radius_legacy_map_cmp() and radius_legacy_map_apply()

The left operand MUST be an attribute reference

<request>.<list>.<attribute>

The op_table should be #cond_cmp_op_table for check items, and map_assignment_op_table for reply items.

Return must be freed with talloc_free

Parameters

[in]	ctx	for talloc.
[in]	out	Where to write the pointer to the new map_t.
[in,out]	parent_p	the parent map, updated for relative maps
[in]	in	the data to parse for creating the map.
[in]	op_table	for lhs OP rhs
[in]	op_table_len	length of op_table
[in]	lhs_rules	rules for parsing LHS attribute references.
[in]	rhs_rules	rules for parsing RHS attribute references.
[in]	p_rules	a list of terminals which will stop string parsing.

Returns

>0 on success.
<=0 on error.

Definition at line 461 of file map.c.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ map_afrom_value_box()

int map_afrom_value_box	(	TALLOC_CTX *	ctx,
		map_t **	out,
		char const *	lhs,
		fr_token_t	lhs_quote,
		tmpl_rules_t const *	lhs_rules,
		fr_token_t	op,
		fr_value_box_t *	rhs,
		bool	steal_rhs_buffs
	)

Convert a value box to a map.

This is mainly used in IO modules, where another function is used to convert between the foreign value type and internal values, and the destination attribute is provided as a string.

Parameters

[in]	ctx	for talloc
[out]	out	Where to store the head of the map.
[in]	lhs	of the operation
[in]	lhs_quote	type of the LHS string
[in]	lhs_rules	rules that control parsing of the LHS string.
[in]	op	the operation to perform
[in]	rhs	of the operation
[in]	steal_rhs_buffs	Whether we attempt to save allocs by stealing the buffers from the rhs fr_value_box_t.

Returns

map_t if successful.
NULL on error.

Definition at line 1378 of file map.c.

Here is the call graph for this function:

◆ map_afrom_vp()

int map_afrom_vp	(	TALLOC_CTX *	ctx,
		map_t **	out,
		fr_pair_t *	vp,
		tmpl_rules_t const *	rules
	)

Convert a fr_pair_t into a map.

Parameters

[in]	ctx	where to allocate the map.
[out]	out	Where to write the new map (must be freed with talloc_free()).
[in]	vp	to convert.
[in]	rules	to insert attributes into.

Returns

0 on success.
-1 on failure.

Definition at line 1459 of file map.c.

Here is the call graph for this function:

◆ map_debug_log()

void map_debug_log	(	request_t *	request,
		map_t const *	map,
		fr_pair_t const *	vp
	)

Definition at line 2441 of file map.c.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ map_list_afrom_cs()

int map_list_afrom_cs	(	TALLOC_CTX *	ctx,
		map_list_t *	out,
		CONF_SECTION *	cs,
		tmpl_rules_t const *	t_rules,
		map_validate_t	validate,
		void *	uctx,
		unsigned int	max
	)

Convert a config section into a list of { a, b, c, d, ... }.

Parameters

[in]	ctx	for talloc.
[out]	out	Where to store the allocated map.
[in]	cs	the update section
[in]	t_rules	rules for parsing the data.
[in]	validate	map using this callback (may be NULL).
[in]	uctx	to pass to callback.
[in]	max	number of mappings to process.

Returns

0 on success.
-1 on failure.

Definition at line 1347 of file map.c.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ map_list_mod_apply()

int map_list_mod_apply	(	request_t *	request,
		vp_list_mod_t const *	vlm
	)

Apply the output of map_to_list_mod to a request.

Parameters

request	to modify.
vlm	VP List Modification to apply.

Definition at line 914 of file map_async.c.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ map_print()

ssize_t map_print	(	fr_sbuff_t *	out,
		map_t const *	map
	)

Print a map to a string.

Parameters

[out]	out	Buffer to write string to.
[in]	map	to print.

Returns

The number of bytes written to the out buffer.
A number >= outlen if truncation has occurred.

Definition at line 2386 of file map.c.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ map_to_list_mod()

int map_to_list_mod	(	TALLOC_CTX *	ctx,
		vp_list_mod_t **	out,
		request_t *	request,
		map_t const *	original,
		fr_value_box_list_t *	lhs_result,
		fr_value_box_list_t *	rhs_result
	)

Evaluate a map creating a new map with TMPL_TYPE_ATTR LHS and TMPL_TYPE_DATA RHS.

This function creates maps for consumption by map_to_request.

Parameters

[in,out]	ctx	to allocate modification maps in.
[out]	out	Where to write the fr_pair_t (s), which may be NULL if not found
[in]	request	The current request.
[in]	original	the map. The LHS (dst) has to be TMPL_TYPE_ATTR.
[in]	lhs_result	of previous stack based rhs evaluation. Must be provided for rhs types: TMPL_TYPE_XLAT TMPL_TYPE_EXEC (in future)
[in]	rhs_result	of previous stack based rhs evaluation. Must be provided for rhs types: TMPL_TYPE_XLAT TMPL_TYPE_EXEC (in future) Once this function returns result will be invalidated even if this function errors.

Returns

0 on success.
-1 on failure.

Definition at line 248 of file map_async.c.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ map_to_request()

int map_to_request	(	request_t *	request,
		map_t const *	map,
		radius_map_getvalue_t	func,
		void *	ctx
	)

Convert map_t to fr_pair_t (s) and add them to a request_t.

Takes a single map_t, resolves request and list identifiers to pointers in the current request, then attempts to retrieve module specific value(s) using callback, and adds the resulting values to the correct request/list.

Parameters

request	The current request.
map	specifying destination attribute and location and src identifier.
func	to retrieve module specific values and convert them to fr_pair_t.
ctx	to be passed to func.

Returns

-1 if the operation failed.
-2 in the source attribute wasn't valid.
0 on success.

Definition at line 1869 of file map.c.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ map_to_vp()

int map_to_vp	(	TALLOC_CTX *	ctx,
		fr_pair_list_t *	out,
		request_t *	request,
		map_t const *	map,
		void *	uctx
	)

Variable Documentation

◆ map_assignment_op_table

fr_table_num_sorted_t const map_assignment_op_table[]

extern

Definition at line 363 of file map.c.

◆ map_assignment_op_table_len

size_t map_assignment_op_table_len

extern

Definition at line 379 of file map.c.

◆ map_parse_rules_bareword_quoted

fr_sbuff_parse_rules_t const map_parse_rules_bareword_quoted

extern

Definition at line 381 of file map.c.

◆ map_parse_rules_quoted

fr_sbuff_parse_rules_t const* map_parse_rules_quoted[T_TOKEN_LAST]

extern

Definition at line 425 of file map.c.

Data Structures

Macros

Typedefs

Functions

Variables

Detailed Description

Data Structure Documentation

◆ vp_list_mod_s

Macro Definition Documentation

◆ MAP_LHS_TERMINALS

◆ MAP_VERIFY

Typedef Documentation

◆ map_t

◆ map_validate_t

◆ radius_map_getvalue_t

◆ vp_list_mod_t

Function Documentation

◆ FR_DLIST_HEAD()

◆ map_afrom_attr_str()

◆ map_afrom_cp()

◆ map_afrom_cs()

◆ map_afrom_cs_edit()

◆ map_afrom_fields()

◆ map_afrom_substr()

◆ map_afrom_value_box()

◆ map_afrom_vp()

◆ map_debug_log()

◆ map_list_afrom_cs()

◆ map_list_mod_apply()

◆ map_print()

◆ map_to_list_mod()

◆ map_to_request()

◆ map_to_vp()

Variable Documentation

◆ map_assignment_op_table

◆ map_assignment_op_table_len

◆ map_parse_rules_bareword_quoted

◆ map_parse_rules_quoted