dkim_sig_getreportinfo()

[back to index]

SYNOPSIS 
#include <dkim.h>
DKIM_STAT dkim_sig_getreportinfo(
	DKIM *dkim,
	DKIM_SIGINFO *sig,
        int *hfd,
        int *bfd,
        char *addrbuf,
        size_t addrlen,
        char *optsbuf,
        size_t optslen,
        char *smtpbuf,
        size_t smtplen,
	u_int *interval
);
Retrieve information required to generate a signature verification failure report. The calling application can use this information to generate an ARF (Abuse Reporting Format) or other report for use in determining the cause of interoperability problems between implementations.
DESCRIPTION
Called When dkim_sig_getreportinfo() is called after dkim_eom() when dkim is a verifying handle, i.e. one returned by an earlier call to dkim_verify().
ARGUMENTS
ArgumentDescription
dkim Message-specific handle, returned by dkim_verify. May not be NULL.
sig A pointer to a DKIM_SIGINFO handle about which a report should be generated. May not be NULL.
hfd A pointer to an integer that will be updated to contain a file descriptor referencing a file which contains the canonicalized version of the message headers that failed to verify. Can be NULL if this information is not needed by the caller.
bfd A pointer to an integer that will be updated to contain a file descriptor referencing a file which contains the canonicalized version of the message body that failed to verify. Can be NULL if this information is not needed by the caller.
addrbuf A buffer into which the destination address of the report, as extracted from the domain's key 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 signature which failed.
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 key 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 the sender-requested SMTP error prefix string, if any, will be written. This is copied exactly as extracted from the domain's key 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) 2005, 2007, 2008 Sendmail, Inc. and its suppliers. All rights reserved.
Copyright (c) 2009, 2010, The Trusted Domain Project. All rights reserved.
By using this file, you agree to the terms and conditions set forth in the respective licenses.