map.h File Reference

#include <freeradius-devel/server/signal.h>
#include <freeradius-devel/server/request.h>
#include <freeradius-devel/server/map.h>
#include <freeradius-devel/server/map_proc.h>
#include <freeradius-devel/unlang/interpret.h>

Include dependency graph for map.h:

Go to the source code of this file.

Typedefs
typedef void(*	unlang_map_signal_t) (map_ctx_t const *mpctx, request_t *request, fr_signal_t action)
	A callback when the request gets a fr_signal_t.

Functions
unlang_action_t	unlang_map_yield (request_t *request, map_proc_func_t resume, unlang_map_signal_t signal, fr_signal_t sigmask, void *rctx)
	Yield a request back to the interpreter from within a module.

Detailed Description

Id

f44c18ce56082f6ad0e75157106dcd74cc5fb167

Copyright

2025 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.

Typedef Documentation

unlang_map_signal_t

typedef void(* unlang_map_signal_t) (map_ctx_t const *mpctx, request_t *request, fr_signal_t action)

A callback when the request gets a fr_signal_t.

Note

The callback is automatically removed on unlang_interpret_mark_runnable().

Parameters

[in]	mpctx	calling context for the map function.
[in]	request	The current request.
[in]	action	which is signalling the request.

Definition at line 43 of file map.h.

Function Documentation

unlang_map_yield()

unlang_action_t unlang_map_yield	(	request_t *	request,
		map_proc_func_t	resume,
		unlang_map_signal_t	signal,
		fr_signal_t	sigmask,
		void *	rctx
	)

Yield a request back to the interpreter from within a module.

This passes control of the request back to the unlang interpreter, setting callbacks to execute when the request is 'signalled' asynchronously, or whatever timer or I/O event the module was waiting for occurs.

Note

The module function which calls unlang_module_yield should return control of the C stack to the unlang interpreter immediately after calling unlang_module_yield. A common pattern is to use return unlang_module_yield(...).

Parameters

[in]	request	The current request.
[in]	resume	Called on unlang_interpret_mark_runnable().
[in]	signal	Called on unlang_action().
[in]	sigmask	Set of signals to block.
[in]	rctx	to pass to the callbacks.

Returns

• UNLANG_ACTION_YIELD.

Definition at line 344 of file map.c.

Here is the call graph for this function:

Here is the caller graph for this function: