[exim-cvs] Docs: usability of malware ACL condition

Gitweb: https://git.exim.org/exim.git/commitdiff/9300a61f79604940f3b0c6fbc4b72f1a3c882caf

Commit:     9300a61f79604940f3b0c6fbc4b72f1a3c882caf
Parent:     be427508c032dc0d47036eb5fea0139e0c63e9e5
Author:     Jeremy Harris <jgh146exb@???>
AuthorDate: Sat Sep 21 22:22:50 2019 +0100
Committer:  Jeremy Harris <jgh146exb@???>
CommitDate: Sat Sep 21 22:22:50 2019 +0100

    Docs: usability of malware ACL condition
---
 doc/doc-docbook/spec.xfpt | 13 ++++++++++++-
 1 file changed, 12 insertions(+), 1 deletion(-)

diff --git a/doc/doc-docbook/spec.xfpt b/doc/doc-docbook/spec.xfpt
index e4dfb98..51c4e01 100644
--- a/doc/doc-docbook/spec.xfpt
+++ b/doc/doc-docbook/spec.xfpt
@@ -30892,7 +30892,9 @@ the next &%local_parts%& test.
.cindex "&ACL;" "virus scanning"
.cindex "&ACL;" "scanning for viruses"
This condition is available only when Exim is compiled with the
-content-scanning extension. It causes the incoming message to be scanned for
+content-scanning extension
+and only after a DATA command.
+It causes the incoming message to be scanned for
viruses. For details, see chapter &<<CHAPexiscan>>&.

.vitem &*mime_regex&~=&~*&<&'list&~of&~regular&~expressions'&>
@@ -32680,6 +32682,15 @@ It supports a &"generic"& interface to scanners called via the shell, and
specialized interfaces for &"daemon"& type virus scanners, which are resident
in memory and thus are much faster.

+.new
+Since message data needs to have arrived,
+the condition may be only called in ACL defined by
+&%acl_smtp_data%&,
+&%acl_smtp_data_prdr%&,
+&%acl_smtp_mime%& or
+&%acl_smtp_dkim%&
+.wen
+
A timeout of 2 minutes is applied to a scanner call (by default);
if it expires then a defer action is taken.