Option Name | Description |
DKIM_OPTS_ALWAYSHDRS |
data refers to a NULL-terminated
array of pointers to strings which name
headers that should be included in the header
lists of signatures even if they were not
present for signing. This list is empty by
default. |
DKIM_OPTS_CLOCKDRIFT |
data refers to a uint64_t
that contains the number of seconds of clock
drift that should be tolerated when determining
whether or not a signature either has expired
or was generated in the future. The default
is 300 seconds (five minutes). |
DKIM_OPTS_FIXEDTIME |
data refers to a uint64_t
that contains a fixed time specification
to use during signature generation. This
follows the same form as a time_t
but allows for larger integers. |
DKIM_OPTS_FLAGS |
data refers to an unsigned integer
which contains a bitwise-OR of desired
flags. See below for the list of known
flags. |
DKIM_OPTS_MUSTBESIGNED |
data refers to an ordered,
NULL-terminated array of header names which,
when verifying a message, must be covered
by a signature for the signature to be
considered valid. The default is to make
no such assertion. If data
refers to a NULL pointer, the default is
restored. |
DKIM_OPTS_QUERYINFO |
data refers to a string
in which query information is stored. See
dkim_query_t
for more information. |
DKIM_OPTS_QUERYMETHOD |
data refers to a
dkim_query_t
containing a value which should override
any q= value in signatures during
verifications. |
DKIM_OPTS_SENDERHDRS |
data refers to an ordered,
NULL-terminated array of header names which
should be searched when trying to determine
the ultimate sender of the message. The
default is to check Resent-Sender,
Resent-From, Sender and
From. The caller's list completely
replaces this list. If data
refers to a NULL pointer, the default is
restored. |
DKIM_OPTS_SIGNATURETTL |
data refers to a uint64_t
that contains the time-to-live, in seconds,
of signatures to be applied during signature
generation. |
DKIM_OPTS_SIGNHDRS |
data refers to an unordered,
NULL-terminated array of header field names.
Input header fields whose names match an
entry in this list will be signed.
Wildcarding using the asterisk ("*")
character, meaning "match zero or more
characters", is permitted.
The From header field is mandatory and
thus implicitly added to any list provided
by the caller.
The constant should_signhdrs may be
specified as the data, which contains
all of the header fields RFC4871 section 5.5
says should be signed.
The default is to sign all header fields.
If data refers to a NULL pointer,
the default is restored.
Attempting DKIM_OP_GETOPT on this
option returns an error as it is converted
internally to regular expressions and not
currently stored in a useable form. |
DKIM_OPTS_SKIPHDRS |
data refers to an unordered,
NULL-terminated array of header names which
are the ones that should be skipped when
processing a message for signing. The default
is to skip no headers.
The constant should_not_signhdrs may be
specified as the data, whicn contains
all of the headers RFC4871 section 5.5 says
should not be signed.
Wildcarding using the asterisk ("*")
character, meaning "match zero or more
characters", is permitted.
If data refers to a NULL pointer,
the default is restored.
Attempting DKIM_OP_GETOPT on this
option returns an error as it is converted
to regular expressions and not currently
stored in a useable form. |
DKIM_OPTS_TMPDIR |
data refers to a string which is
the directory libopendkim should use for
creating temporary files. |
DKIM_OPTS_TIMEOUT |
data refers to an unsigned integer
indicating the timeout, in seconds, to be
used when doing DNS queries to retrieve key
and policy records. |