---
name: "dmarc_receive"
section: "1p"
platform: "linux"
package: "libmail-dmarc-perl"
version: "1.20240314-1"
release: "Debian 13 (Trixie)"
platforms: ["linux"]
url: "https://new.carta.tech/dmarc_receive"
---

# dmarc\_receive(1p)

receive aggregate reports via IMAP, mbox, or message file(s)

## NAME

dmarc\_receive - receive aggregate reports via IMAP, mbox, or message file(s)

## USAGE

```
 dmarc_receive [ --imap | --mbox | --file ]
```

## DESCRIPTION

This script processes incoming DMARC reports from IMAP, files, or a mbox formatted file.

### IMAP

To process reports with IMAP, you must configure the \[imap\] settings in mail-dmarc.ini. This program will:

```
 * log into the IMAP account
 * select the specified folder (INBOX, dmarc, etc)
 * for every unread (Unseen) message, search for DMARC reports
```

*IMAP Aggregate report*

IMAP aggregate reports are detected by the presence of zip or gzip attachments. When an aggregate report is detected:

```
 * the attachment is decompressed
 * the XML is parsed
 * the report is saved to the report store
 * the message is marked as read/seen
 * move message to [imap][a_done] folder (if defined)
```

*IMAP Forensic report*

IMAP forensic reports are detected by the presence of the content-types message/feedback-report and text/rfc822-headers. When a forensic report is detected it is moved to the \[imap\]\[f\_done\] IMAP folder.

### File as message

Accepts the filename of a file containing a mail message. The message is parsed and stored.

### Mbox

Accepts the filename of a mbox format file containing mail messages. The messages are parsed and stored.
