]> git.ipfire.org Git - thirdparty/freeradius-server.git/commitdiff
docs-v4: Integrity check on call page - added text about compatible names & added...
authornolade <nola.aunger@inkbridge.io>
Mon, 30 Mar 2026 18:41:36 +0000 (14:41 -0400)
committerAlan T. DeKok <aland@freeradius.org>
Wed, 1 Apr 2026 15:33:16 +0000 (11:33 -0400)
doc/antora/modules/reference/pages/unlang/call.adoc

index 87568c718d92a7fc1930385f63723010926bac5d..45968015beff8dcab8122ad21219244e94e92edb 100644 (file)
@@ -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.