network.h File Reference

#include <freeradius-devel/io/worker.h>
#include <freeradius-devel/util/log.h>

Include dependency graph for network.h:

Go to the source code of this file.

Data Structures
struct	fr_network_config_t

Typedefs
typedef struct fr_network_s	fr_network_t

Functions
void	fr_network (fr_network_t *nr)
	The main network worker function.
fr_network_t *	fr_network_create (TALLOC_CTX *ctx, fr_event_list_t *el, char const *nr, fr_log_t const *logger, fr_log_lvl_t lvl, fr_network_config_t const *config))
	Create a network.
int	fr_network_destroy (fr_network_t *nr)
	Stop a network thread in an orderly way.
int	fr_network_directory_add (fr_network_t *nr, fr_listen_t *li)
	Add a "watch directory" call to a network.
int	fr_network_exit (fr_network_t *nr)
	Signal a network thread to exit.
int	fr_network_listen_add (fr_network_t *nr, fr_listen_t *li)
	Add a fr_listen_t to a network.
int	fr_network_listen_delete (fr_network_t *nr, fr_listen_t *li)
	Delete a socket from a network.
int	fr_network_listen_inject (fr_network_t *nr, fr_listen_t *li, uint8_t const *packet, size_t packet_len, fr_time_t recv_time)
	Inject a packet for a listener to read.
size_t	fr_network_listen_outstanding (fr_network_t *nr, fr_listen_t *li)
	Get the number of outstanding packets.
void	fr_network_listen_read (fr_network_t *nr, fr_listen_t *li)
	Signal the network to read from a listener.
int	fr_network_listen_send_packet (fr_network_t *nr, fr_listen_t *parent, fr_listen_t *li, const uint8_t *buffer, size_t buflen, fr_time_t recv_time, void *packet_ctx))
	Send a packet to the worker.
void	fr_network_listen_write (fr_network_t *nr, fr_listen_t *li, uint8_t const *packet, size_t packet_len, void *packet_ctx, fr_time_t request_time)
	Inject a packet for a listener to write.
int	fr_network_sendto_worker (fr_network_t *nr, fr_listen_t *li, void *packet_ctx, uint8_t const *data, size_t data_len, fr_time_t recv_time)
int	fr_network_stats (fr_network_t const *nr, int num, uint64_t *stats)
void	fr_network_stats_log (fr_network_t const *nr, fr_log_t const *log)
int	fr_network_worker_add (fr_network_t *nr, fr_worker_t *worker)
	Add a worker to a network in a different thread.
void	fr_network_worker_add_self (fr_network_t *nr, fr_worker_t *worker)
	Add a worker to a network in the same thread.

Variables
fr_cmd_table_t	cmd_network_table []

---

Data Structure Documentation

fr_network_config_t

struct fr_network_config_t

Definition at line 45 of file network.h.

Data Fields
uint32_t	max_outstanding

Typedef Documentation

fr_network_t

typedef struct fr_network_s fr_network_t

Definition at line 32 of file network.h.

Function Documentation

fr_network()

void fr_network

(

fr_network_t *

nr

)

The main network worker function.

Parameters

[in]

nr

the network data structure to run.

Definition at line 1815 of file network.c.

Here is the call graph for this function:

Here is the caller graph for this function:

fr_network_create()

fr_network_t * fr_network_create	(	TALLOC_CTX *	ctx,
		fr_event_list_t *	el,
		char const *	name,
		fr_log_t const *	logger,
		fr_log_lvl_t	lvl,
		fr_network_config_t const *	config
	)

Create a network.

Parameters

[in]	ctx	The talloc ctx
[in]	el	The event list
[in]	name	Networker identifier.
[in]	logger	The destination for all logging messages
[in]	lvl	Log level
[in]	config	configuration structure.

Returns

• NULL on error
• fr_network_t on success

Definition at line 1903 of file network.c.

Here is the call graph for this function:

Here is the caller graph for this function:

fr_network_destroy()

int fr_network_destroy

(

fr_network_t *

nr

)

Stop a network thread in an orderly way.

Parameters

[in]

nr

the network to stop

Definition at line 1699 of file network.c.

Here is the call graph for this function:

Here is the caller graph for this function:

fr_network_directory_add()

int fr_network_directory_add	(	fr_network_t *	nr,
		fr_listen_t *	li
	)

Add a "watch directory" call to a network.

Parameters

nr	the network
li	the listener

Definition at line 290 of file network.c.

Here is the call graph for this function:

Here is the caller graph for this function:

fr_network_exit()

int fr_network_exit

(

fr_network_t *

nr

)

Signal a network thread to exit.

Note

Request to exit will be processed asynchronously.

Parameters

[in]

nr

the network data structure to manage

Returns

• 0 on success.
• -1 on failure.

Definition at line 1870 of file network.c.

Here is the call graph for this function:

Here is the caller graph for this function:

fr_network_listen_add()

int fr_network_listen_add	(	fr_network_t *	nr,
		fr_listen_t *	li
	)

Add a fr_listen_t to a network.

Parameters

nr	the network
li	the listener

Definition at line 236 of file network.c.

Here is the call graph for this function:

Here is the caller graph for this function:

fr_network_listen_delete()

int fr_network_listen_delete	(	fr_network_t *	nr,
		fr_listen_t *	li
	)

Delete a socket from a network.

MUST be called only by the listener itself!.

Parameters

nr	the network
li	the listener

Definition at line 271 of file network.c.

Here is the call graph for this function:

Here is the caller graph for this function:

fr_network_listen_inject()

int fr_network_listen_inject	(	fr_network_t *	nr,
		fr_listen_t *	li,
		uint8_t const *	packet,
		size_t	packet_len,
		fr_time_t	recv_time
	)

Inject a packet for a listener to read.

Parameters

nr	the network
li	the listener where the packet is being injected
packet	the packet to be injected
packet_len	the length of the packet
recv_time	when the packet was received.

Returns

• <0 on error
• 0 on success

Definition at line 410 of file network.c.

Here is the call graph for this function:

Here is the caller graph for this function:

fr_network_listen_outstanding()

size_t fr_network_listen_outstanding	(	fr_network_t *	nr,
		fr_listen_t *	li
	)

Get the number of outstanding packets.

Parameters

nr	the network
li	the listener that the packet was "read" from

Returns

• <0 on error
• the number of outstanding packets

Definition at line 823 of file network.c.

Here is the call graph for this function:

Here is the caller graph for this function:

fr_network_listen_read()

void fr_network_listen_read	(	fr_network_t *	nr,
		fr_listen_t *	li
	)

Signal the network to read from a listener.

Parameters

nr	the network
li	the listener to read from

Definition at line 336 of file network.c.

Here is the call graph for this function:

Here is the caller graph for this function:

fr_network_listen_send_packet()

int fr_network_listen_send_packet	(	fr_network_t *	nr,
		fr_listen_t *	parent,
		fr_listen_t *	li,
		const uint8_t *	buffer,
		size_t	buflen,
		fr_time_t	recv_time,
		void *	packet_ctx
	)

Send a packet to the worker.

MUST only be called from the network thread.

Parameters

nr	the network
parent	the parent listener
li	the listener that the packet was "read" from. Can be "parent"
buffer	the packet to send
buflen	size of the packet to send
recv_time	of the packet
packet_ctx	for the packet

Returns

• <0 on error
• 0 on success

Definition at line 781 of file network.c.

Here is the call graph for this function:

Here is the caller graph for this function:

fr_network_listen_write()

void fr_network_listen_write	(	fr_network_t *	nr,
		fr_listen_t *	li,
		uint8_t const *	packet,
		size_t	packet_len,
		void *	packet_ctx,
		fr_time_t	request_time
	)

Inject a packet for a listener to write.

Parameters

nr	the network
li	the listener where the packet is being injected
packet	the packet to be written
packet_len	the length of the packet
packet_ctx	The packet context to write
request_time	when the packet was received.

Definition at line 362 of file network.c.

Here is the call graph for this function:

Here is the caller graph for this function:

fr_network_sendto_worker()

int fr_network_sendto_worker	(	fr_network_t *	nr,
		fr_listen_t *	li,
		void *	packet_ctx,
		uint8_t const *	data,
		size_t	data_len,
		fr_time_t	recv_time
	)

Definition at line 1048 of file network.c.

Here is the call graph for this function:

Here is the caller graph for this function:

fr_network_stats()

int fr_network_stats	(	fr_network_t const *	nr,
		int	num,
		uint64_t *	stats
	)

Definition at line 2028 of file network.c.

fr_network_stats_log()

void fr_network_stats_log	(	fr_network_t const *	nr,
		fr_log_t const *	log
	)

Definition at line 2044 of file network.c.

Here is the call graph for this function:

Here is the caller graph for this function:

fr_network_worker_add()

int fr_network_worker_add	(	fr_network_t *	nr,
		fr_worker_t *	worker
	)

Add a worker to a network in a different thread.

Parameters

nr	the network
worker	the worker

Definition at line 305 of file network.c.

Here is the call graph for this function:

Here is the caller graph for this function:

fr_network_worker_add_self()

void fr_network_worker_add_self	(	fr_network_t *	nr,
		fr_worker_t *	worker
	)

Add a worker to a network in the same thread.

Parameters

nr	the network
worker	the worker

Definition at line 325 of file network.c.

Here is the call graph for this function:

Here is the caller graph for this function:

Variable Documentation

cmd_network_table

fr_cmd_table_t cmd_network_table[]

extern

Definition at line 2111 of file network.c.