From: Alan T. DeKok <aland@freeradius.org>
Date: Thu, 19 Nov 2020 19:37:26 +0000 (-0500)
Subject: update documentation
X-Git-Tag: release_3_0_22~336
X-Git-Url: http://git.ipfire.org/gitweb.cgi?a=commitdiff_plain;h=5e865b35cdc817f765f06455620deb8a8e69f2cc;p=thirdparty%2Ffreeradius-server.git

update documentation

to make it excruciatingly clear what to do
---

diff --git a/raddb/mods-available/detail b/raddb/mods-available/detail
index e91e12d0b4d..ccf65f9c839 100644
--- a/raddb/mods-available/detail
+++ b/raddb/mods-available/detail
@@ -31,6 +31,15 @@ detail {
 	#  be ONE "listen" section reading detail files from a
 	#  particular directory.
 	#
+	#  The configuration below puts the detail files into separate
+	#  directories for each client.  If you are reading the detail
+	#  files via the "listen" section, just use one directory.
+	#
+	#  e.g. filename = ${radacctdir}/reader1/detail-%Y%m%d
+	#
+	#  AND use a separate directory (reader2, reader3, etc.) for each
+	#  reader.
+	#
 	filename = ${radacctdir}/%{%{Packet-Src-IP-Address}:-%{Packet-Src-IPv6-Address}}/detail-%Y%m%d
 
 	#
diff --git a/raddb/sites-available/copy-acct-to-home-server b/raddb/sites-available/copy-acct-to-home-server
index eb1c6bfc120..cd085e099a3 100644
--- a/raddb/sites-available/copy-acct-to-home-server
+++ b/raddb/sites-available/copy-acct-to-home-server
@@ -69,6 +69,12 @@ server copy-acct-to-home-server {
 		#  a common naming scheme for detail files, then you can
 		#  have many detail file writers, and only one reader.
 		#
+		#  Do NOT copy the "filename" configuration from the
+		#  "detail" module here.  It won't work.  Instead, use
+		#  file globbing (or wildcards), such as:
+		#
+		#	filename = ${radacctdir}/reader1/detail-*
+		#
 		filename = ${radacctdir}/detail
 
 		#