add documentation for RAR support

While clamav and our stack do support handling RAR archives, both need
packages from `non-free` installed in order to work.

Adding the 2 packages to the appropriate places would still
require a reference to the sources.list entry of how to get the `non-free`
archive area enabled and that way we can reference one place to answer how
to enable RAR support

Signed-off-by: Stoiko Ivanov <s.ivanov@proxmox.com>

diff --git a/asciidoc/asciidoc-pmg.conf b/asciidoc/asciidoc-pmg.conf
index eb3e8b758fb91d717c4b4460bf7d5666b41e05bf..d10debfc0c5a44679092172fbc8446740aa038b7 100644 (file)
--- a/asciidoc/asciidoc-pmg.conf
+++ b/asciidoc/asciidoc-pmg.conf
@@ -18,6 +18,7 @@ postfix_beforequeue=http://www.postfix.org/SMTPD_PROXY_README.html[Postfix Befor
 systemd=https://www.freedesktop.org/wiki/Software/systemd/[systemd]
 clamav=https://www.clamav.net[ClamAV(R)]
 debian=https://www.debian.org[Debian]
+debian_nonfree_archive_area=https://www.debian.org/doc/debian-policy/ch-archive#the-non-free-archive-area[Debian's non-free archive area]
 tts=http://www.template-toolkit.org[Template Toolkit]
 dkim_rfc=https://tools.ietf.org/html/rfc6376[RFC 6376]
 ifndef::docinfo1[]

diff --git a/pmg-installation.adoc b/pmg-installation.adoc
index 5887fd2ba2c188d2addecae05e7075327b1f5d85..2f819117831ff9239b91a890f7b40e31c0962e12 100644 (file)
--- a/pmg-installation.adoc
+++ b/pmg-installation.adoc
@@ -403,3 +403,25 @@ f3f6c5a3a67baf38ad178e5ff1ee270c  /etc/apt/trusted.gpg.d/proxmox-ve-release-6.x.
 ----
 
 
+Other Repository Sources
+~~~~~~~~~~~~~~~~~~~~~~~~
+
+Certain software cannot be made available in the `main` and `contrib`
+areas of the {debian} archives, since it does not adhere to the Debian
+Free Software Guidelines (DFSG). These are distributed in the
+{debian_nonfree_archive_area}. For {pmg} two packages from the `non-free` area
+are needed in order to support the RAR archive format:
+
+* `p7zip-rar` for matching xref:pmg_mailfilter_what[Archive Objects] in the
+  xref:chapter_mailfilter[Rule system]
+
+* `libclamunrar` for detecting viruses in RAR archives.
+
+.sources.list.entry for `non-free`
+----
+deb http://deb.debian.org/debian/ buster non-free
+deb http://security.debian.org/debian-security buster/updates non-free
+deb http://deb.debian.org/debian/ buster-updates non-free
+----
+
+