From: nolade <nola.aunger@inkbridge.io>
Date: Mon, 30 Mar 2026 18:41:36 +0000 (-0400)
Subject: docs-v4: Integrity check on call page - added text about compatible names & added... 
X-Git-Url: http://git.ipfire.org/gitweb.cgi?a=commitdiff_plain;h=dd8face2e64cdc3bbdbf70a434fbf766420f0353;p=thirdparty%2Ffreeradius-server.git

docs-v4: Integrity check on call page - added text about compatible names & added note for rcode results from multiple calls.
---

diff --git a/doc/antora/modules/reference/pages/unlang/call.adoc b/doc/antora/modules/reference/pages/unlang/call.adoc
index 87568c718d9..45968015bef 100644
--- a/doc/antora/modules/reference/pages/unlang/call.adoc
+++ b/doc/antora/modules/reference/pages/unlang/call.adoc
@@ -15,7 +15,9 @@ will continue being processed in the original virtual server.
 <server>::  The virtual server which will process the request.
 +
 The called virtual server must have the same `namespace` value as the
-calling virtual server.
+calling virtual server. Enforcing the same `namespace` prevents calls
+to a virtual server with an incompatible protocol during compile or
+run-times.
 +
 The called virtual server will execute the request as if it had
 been received from the network.  For example, if the packet is a
@@ -29,7 +31,15 @@ statements]_ from inside of the `call` section are executed.
 The return code of the `call` statement is taken from the final return
 code of the called virtual server.
 
-The `call` keyword will take the _current_ request and send it through
+[NOTE]
+
+====
+The statments inside of a `call { ... }` execute after the called
+server returns. Execution of these statements returns an rcode that
+becomes the `call` rcode, overriding the rcode of the called server.
+====
+
+The `call` keyword takes the _current_ request and sends it through
 the named virtual server.  This means that the called virtual server
 can edit the request list, reply list, session-state list, etc.
 
@@ -48,5 +58,5 @@ subrequest Packet-Type Relay-Message reply.Relay-Message {
 }
 ----
 
-// Copyright (C) 2021 Network RADIUS SAS.  Licenced under CC-by-NC 4.0.
+// Copyright (C) 2026 Network RADIUS SAS.  Licenced under CC-by-NC 4.0.
 // This documentation was developed by Network RADIUS SAS.