From: Nick Porter <nick@portercomputing.co.uk>
Date: Wed, 23 Apr 2025 11:22:46 +0000 (+0100)
Subject: Update sample perl module config
X-Git-Url: http://git.ipfire.org/cgi-bin/gitweb.cgi?a=commitdiff_plain;h=20e756c4e279430547ee760334c33a8fdf3a7dc0;p=thirdparty%2Ffreeradius-server.git

Update sample perl module config
---

diff --git a/raddb/mods-available/perl b/raddb/mods-available/perl
index d062702a40a..a1826df9096 100644
--- a/raddb/mods-available/perl
+++ b/raddb/mods-available/perl
@@ -13,10 +13,19 @@
 #  * Please see http://www.perl.org/docs.html for more information about the
 #  Perl language.
 #
-#  NOTE: Uncomment any `func_*` configuration items below which are
-#  included in your module. If the module is called for a section which
-#  does not have a function defined, it will return `noop`.
+#  NOTE: As of FreeRADIUS v4, the Perl subroutine names called when the `perl`
+#  module is called are automatically derived from the section in which
+#  they are called.
 #
+#  e.g. if `perl` is called in `recv Access-Request`, firstly a subroutine
+#  `recv_access_request` will be looked for.  If that does not exist, then
+#  a subroutine `recv` will be looked for.
+#
+#  This can be overridden by setting `func_recv_access_request` or `func_recv`
+#  to point to a different subroutine name.
+#
+#  In addition the option `func_detach` can be used to set a subroutine to call
+#  during shutdown.
 
 #
 #  ## Configuration Settings
@@ -78,18 +87,19 @@ perl {
 	perl_flags = "-T"
 
 	#
-	#  List of functions in the module to call. Uncomment and change if you
-	#  want to use function names other than the defaults.
+	#  func_detach:: Subroutine to call during server shutdown
 	#
-#	func_authenticate = authenticate
-#	func_authorize = authorize
-#	func_preacct = preacct
-#	func_accounting = accounting
-#	func_pre_proxy = pre_proxy
-#	func_post_proxy = post_proxy
-#	func_post_auth = post_auth
 #	func_detach = detach
 
+	#
+	#  Sample subroutine name overrides
+	#
+	#  These options cause the old FreeRADIUS v3 default subroutine
+	#  names to be used
+#	func_recv_access_request = authorize
+#	func_recv_accounting_request = preacct
+#	func_send = postauth
+
 	#
 	#  Control which attribute lists are replaced following calls to
 	#  the module.