referral.c File Reference

Functions to handle ldap referrals. More...

#include <freeradius-devel/ldap/base.h>

Include dependency graph for referral.c:

Go to the source code of this file.

Functions
static int	_fr_ldap_referral_free (fr_ldap_referral_t *referral)
	Clear up a fr_ldap_referral_t. More...
static void	_ldap_referral_send (UNUSED fr_trunk_t *trunk, UNUSED fr_trunk_state_t prev, UNUSED fr_trunk_state_t state, void *uctx)
	Callback to send LDAP referral queries when a trunk becomes active. More...
fr_ldap_referral_t *	fr_ldap_referral_alloc (TALLOC_CTX *ctx, request_t *request)
	Allocate a new structure to handle an LDAP referral, setting the destructor. More...
int	fr_ldap_referral_follow (fr_ldap_thread_t *t, request_t *request, fr_ldap_query_t *query)
	Follow an LDAP referral. More...
int	fr_ldap_referral_next (fr_ldap_thread_t *t, request_t *request, fr_ldap_query_t *query)
	Follow an alternative LDAP referral. More...

Detailed Description

Functions to handle ldap referrals.

Id

202481613a47404389e4d4f9c22afbc90abe0e2c

Author

Nick Porter nick..nosp@m.port.nosp@m.er@ne.nosp@m.twor.nosp@m.kradi.nosp@m.us.c.nosp@m.om

Copyright

2021 The FreeRADIUS Server Project.

Definition in file referral.c.

Function Documentation

_fr_ldap_referral_free()

static int _fr_ldap_referral_free ( fr_ldap_referral_t *  referral )

static

Clear up a fr_ldap_referral_t.

If there is a parsed referral_url, that must be freed using libldap's ldap_free_urldesc

Definition at line 34 of file referral.c.

Here is the caller graph for this function:

_ldap_referral_send()

static void _ldap_referral_send ( UNUSED fr_trunk_t *  trunk, UNUSED fr_trunk_state_t  prev, UNUSED fr_trunk_state_t  state, void *  uctx  )

static

Callback to send LDAP referral queries when a trunk becomes active.

Definition at line 67 of file referral.c.

Here is the call graph for this function:

Here is the caller graph for this function:

fr_ldap_referral_alloc()

fr_ldap_referral_t* fr_ldap_referral_alloc	(	TALLOC_CTX *	ctx,
		request_t *	request
	)

Allocate a new structure to handle an LDAP referral, setting the destructor.

Parameters

[in]	ctx	to allocate the referral in
[in]	request	the LDAP query relates to.

Returns

• a new referral structure on success
• NULL on failure

Definition at line 49 of file referral.c.

Here is the call graph for this function:

Here is the caller graph for this function:

fr_ldap_referral_follow()

int fr_ldap_referral_follow	(	fr_ldap_thread_t *	t,
		request_t *	request,
		fr_ldap_query_t *	query
	)

Follow an LDAP referral.

The returned list of LDAP referrals should already be in query->referrals. We check all the possible referrals and look for one where there already is an active trunk connection.

Parameters

t	Thread running the query.
request	related to the query.
query	whose result was one or more referral URLs.

Returns

• 0 on success.
• < 0 on failure.

Definition at line 112 of file referral.c.

Here is the call graph for this function:

Here is the caller graph for this function:

fr_ldap_referral_next()

int fr_ldap_referral_next	(	fr_ldap_thread_t *	t,
		request_t *	request,
		fr_ldap_query_t *	query
	)

Follow an alternative LDAP referral.

If an initial chase of an LDAP referral results in an error being returned this function can be used to attempt one of the other referral URLs given in the initial query results.

The initial use of fr_ldap_referral_follow may have launched trunks for any referral URLs which parsed successfully, so this starts by looking for the first which has an active state and sends the query that way.

If no active trunks match the remaining servers listed in referrals then new trunks are launched with watchers to send the query on the first active trunk.

Parameters

t	Thread running the query.
request	the query relates to.
query	whose referrals are being chased.

Returns

• 0 on success.
• < 0 on failure.

Definition at line 309 of file referral.c.

Here is the call graph for this function:

Here is the caller graph for this function: