NOTES |
- DKIM_STAT_NOKEY is returned if the DNS query for a selector
(public key) record returned with NXDOMAIN, i.e. the record
does not exist; this should be considered a permanent failure.
- DKIM_STAT_CANTVRFY is returned if the DNS query for a selector
(public key) record timed out or suffered some other kind of transient
failure; verification can be re-attempted later.
- DKIM_STAT_SYNTAX is returned to indicate required data could
not be extracted from the arriving message to be signed or verified,
or if a selector (public key) record returned from a DNS query could
not be parsed (e.g. corrupted, wrong format, etc.).
- DKIM_STAT_NOSIG can be returned early, i.e. from
dkim_eoh(), if no signature was found
on a message which is being verified. See that function's description
for further details.
- DKIM_STAT_INTERNAL can be returned on system error (e.g.
malloc() failure), or if functions provided by this API are
called in the incorrect order (e.g. dkim_getsig() before
dkim_eom(), or dkim_eoh() before dkim_header(),
etc.).
- DKIM_STAT_REVOKED is returned when a key found in a signature
has been revoked and thus is no longer valid.
- DKIM_STAT_INVALID is returned when a function in this library
is called with at least one invalud parameter.
- DKIM_STAT_NOTIMPLEMENT is returned when an attempt is made
to use a feature that is not yet implemented.
- DKIM_STAT_KEYFAIL is returned when a key retrieval operation
failed for some transient reason; the caller should try again later
|