# dkim_policy_getreportinfo()

[back to index]

SYNOPSIS

    #include <dkim.h>
    DKIM_STAT dkim_policy_getreportinfo(
    	DKIM *dkim,
            char *addrbuf,
            size_t addrlen,
            char *optsbuf,
            size_t optslen,
            char *smtpbuf,
            size_t smtplen,
    	u_int *interval
    );

Retrieve information required to generate a DKIM policy failure report. The calling application can use this information to generate an ARF (Abuse Reporting Format) or other report for use in reporting messages which violate a sender's published DKIM policy.

DESCRIPTION

Called When | `dkim_policy_getreportinfo()` is called after `dkim_eom()` and `dkim_policy()` when `dkim` is a verifying handle, i.e. one returned by an earlier call to `dkim_verify()`.

ARGUMENTS

Argument | Description
--- | ---
dkim | Message-specific handle, returned by `dkim_sign()` or `dkim_verify`. May not be NULL.
addrbuf | A buffer into which the destination address of the report, as extracted from the domain's policy record, will be written. Can be NULL if this information is not needed by the caller. Note that this only contains the local-part of the address; the domain should be extracted from the `From:` header of the message being evaluated.
addrlen | Number of bytes available at `addrbuf`.
optsbuf | A buffer into which a colon-separated list of report options desired by the requesting domain will be written. This is copied exactly as extracted from the domain's policy record. Can be NULL if this information is not needed by the caller.
optslen | Number of bytes available at `optsbuf`.
smtpbuf | A buffer into which an SMTP reply prefix will be written. This is copied exactly as extracted from the domain's policy record. Can be NULL if this information is not needed by the caller.
smtplen | Number of bytes available at `smtpbuf`.
interval | Requested report interval. Can be NULL if this information is not needed by the caller.

NOTES

- None.

Copyright (c) 2008 Sendmail, Inc. and its suppliers. All rights reserved.
Copyright (c) 2009, 2010, The OpenDKIM Project. All rights reserved.
By using this file, you agree to the terms and conditions set forth in the respective licenses.