[[chapter_pmgqm]]
ifdef::manvolnum[]
pmgqm(1)
========
:pmg-toplevel:

NAME
----

pmgqm - Quarantine Management Toolkit


SYNOPSIS
--------

include::pmgqm.1-synopsis.adoc[]


DESCRIPTION
-----------
endif::manvolnum[]
ifndef::manvolnum[]
pmgqm - Quarantine Management Toolkit
=====================================
:pmg-toplevel:
endif::manvolnum[]

Toolkit to manage spam and virus quarantine, and send spam report mails.

The possible timespans are `week`, `yesterday`, and `today`. The default
pmgspamreport.service is run at 00:05 every day and calls the `pmgqm` command
with the `--timespan yesterday` parameter.
This will send a spam report if at least one new spam mail was moved to the
quarantine since the beginning of the previous day.

The service can be edited, for example, to change the timespan to `today` or
`week`, with the following command:
----
systemctl edit pmgspamreport.service
----

The timer can be edited with the command below:
----
systemctl edit pmgspamreport.timer
----

Keep in mind that just adding another `OnCalendar` event will cause the report
to be sent out additionally at the specified time, if you want to prevent the
default mail at 00:05, you need to reset the `OnCalendar` setting - for example
to only send out the mails at 06:00:
----
[Timer]
OnCalendar=
OnCalendar=06:00
----

For details see the systemd man pages: `systemd.unit(5)`, `systemd.timer(5)`.

ifdef::manvolnum[]
include::pmg-copyright.adoc[]
endif::manvolnum[]