From: Nick Porter <nick@portercomputing.co.uk>
Date: Thu, 15 Feb 2024 15:47:31 +0000 (+0000)
Subject: More doxygen fixes
X-Git-Url: http://git.ipfire.org/cgi-bin/gitweb.cgi?a=commitdiff_plain;h=30264675be835f01733fe169d7d47f879bf34c0b;p=thirdparty%2Ffreeradius-server.git

More doxygen fixes
---

diff --git a/src/lib/unlang/call_env.c b/src/lib/unlang/call_env.c
index c1a5c18b1a2..9f4bcebb0b7 100644
--- a/src/lib/unlang/call_env.c
+++ b/src/lib/unlang/call_env.c
@@ -652,6 +652,7 @@ void call_env_parsed_free(call_env_parsed_head_t *parsed, call_env_parsed_t *ptr
  * @param[in] call_env_method	containing the call_env_pair_t to evaluate against the specified CONF_SECTION.
  * @param[in] t_rules		that control how call_env_pair_t are parsed.
  * @param[in] cs		to parse in the context of the call.
+ * @param[in] data		module / xlat instance data of the module / xlat allocating this call_env
  * @return
  *	- A new call_env_t on success.
  * 	- NULL on failure.
diff --git a/src/lib/unlang/call_env.h b/src/lib/unlang/call_env.h
index f6ca471acb9..f7438ae4763 100644
--- a/src/lib/unlang/call_env.h
+++ b/src/lib/unlang/call_env.h
@@ -134,6 +134,7 @@ DIAG_ON(attributes)
  * @param[out] out		Where to write the result of parsing.
  * @param[in] t_rules		we're parsing attributes with.  Contains the default dictionary and nested 'caller' tmpl_rules_t.
  * @param[in] ci		The #CONF_SECTION or #CONF_PAIR to parse.
+ * @param[in] data		module / xlat instance data of the module / xlat allocating this call_env
  * @param[in] rule		Parse rules - How the #CONF_PAIR or #CONF_SECTION should be converted.
  * @return
  *	- 0 on success.
diff --git a/src/lib/unlang/interpret.c b/src/lib/unlang/interpret.c
index 7d6e9c23dc0..d330a71aa1e 100644
--- a/src/lib/unlang/interpret.c
+++ b/src/lib/unlang/interpret.c
@@ -228,6 +228,7 @@ static int _local_variables_free(unlang_variable_ref_t *ref)
 
 /** Push the children of the current frame onto a new frame onto the stack
  *
+ * @param[out] p_result		set to RLM_MOULDE_FAIL if pushing the children fails
  * @param[in] request		to push the frame onto.
  * @param[in] default_rcode	The default result.
  * @param[in] do_next_sibling	Whether to only execute the first node in the #unlang_t program
@@ -1600,7 +1601,7 @@ static xlat_action_t unlang_interpret_xlat(TALLOC_CTX *ctx, fr_dcursor_t *out,
 	 */
 	if (strcmp(fmt, "rcode") == 0) {
 		if (fr_value_box_strdup(vb, vb, NULL, fr_table_str_by_value(rcode_table, request->rcode, "<INVALID>"), false) < 0) goto error;
-		
+
 		goto finish;
 	}
 
diff --git a/src/lib/util/dict_util.c b/src/lib/util/dict_util.c
index 622ba05c95d..50f1f3d3d8e 100644
--- a/src/lib/util/dict_util.c
+++ b/src/lib/util/dict_util.c
@@ -3773,6 +3773,7 @@ static int _fr_dict_autoload_talloc_free(fr_dict_autoload_talloc_t const *to_fre
  *	 to the dictionary are gone.
  *
  * @param[in] ctx	to bind the dictionary lifetime to.
+ * @param[out] out	pointer to the loaded dictionary.
  * @param[in] proto	to load.
  * @param[in] dependent to register this reference to.  Will be dupd.
  */
diff --git a/src/modules/rlm_ldap/profile.c b/src/modules/rlm_ldap/profile.c
index 0983b06e514..1ddbddd1404 100644
--- a/src/modules/rlm_ldap/profile.c
+++ b/src/modules/rlm_ldap/profile.c
@@ -121,7 +121,9 @@ static void ldap_map_profile_cancel(UNUSED request_t *request, UNUSED fr_signal_
  * sets of attributes to the request.
  *
  * @param[out] ret		Where to write the result of the query.
+ * @param[in] inst		LDAP module instance.
  * @param[in] request		Current request.
+ * @param[in] ttrunk		Trunk connection on which to run LDAP queries.
  * @param[in] dn		of profile object to apply.
  * @param[in] scope		to apply when looking up profiles.
  * @param[in] filter		to apply when looking up profiles.
diff --git a/src/modules/rlm_ldap/user.c b/src/modules/rlm_ldap/user.c
index 4292625697b..9adf846400d 100644
--- a/src/modules/rlm_ldap/user.c
+++ b/src/modules/rlm_ldap/user.c
@@ -240,6 +240,7 @@ ldap_access_state_t rlm_ldap_check_access(rlm_ldap_t const *inst, request_t *req
  * Checks to see if after the LDAP to RADIUS mapping has been completed that a reference password.
  *
  * @param[in] request		Current request.
+ * @param[in] inst_name		Name of LDAP module instance for debug messages.
  * @param[in] expect_password	Whether we should be expecting a password.
  * @param[in] ttrunk		the connection thread trunk.
  */
diff --git a/src/modules/rlm_linelog/rlm_linelog.c b/src/modules/rlm_linelog/rlm_linelog.c
index 8dd0f1aa2ee..9309445643a 100644
--- a/src/modules/rlm_linelog/rlm_linelog.c
+++ b/src/modules/rlm_linelog/rlm_linelog.c
@@ -320,6 +320,7 @@ static void *mod_conn_create(TALLOC_CTX *ctx, void *instance, fr_time_delta_t ti
  * - All other unprintables are escaped as @verbatim \<oct><oct><oct> @endverbatim.
  *
  * @param vb		Value box to escape.
+ * @param uctx		unused.
  */
 /*
  *	Escape unprintable characters.