Option Name | Description |
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_MINKEYBITS |
data refers to a u_int
that contains the minimum number of bits
that are to be conisdered
acceptable. The default is 1024. |
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_OVERSIGNHDRS |
data refers to an unordered,
NULL-terminated array of pointers to
NULL-terminated strings that name
header fields which should be included in the
header lists ("h=" tags) of signatures once
more than the number of occurrences
that were signed. This prevents later handlers
from adding instances of those header fields
without invalidating the signature. This list
is empty by default. |
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_REQUIREDHDRS |
data refers to an ordered,
NULL-terminated array of header field names
that should be considered mandatory when
determining the validity of an input message
for signing. The default is to require a
From field only. The caller's list
completely replaces this list. If
data refers to a NULL pointer, the
default is restored. |
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 From only.
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 dkim_should_signhdrs may
be specified as the data, which
contains all of the header fields RFC6376
Section 5.4 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 dkim_should_not_signhdrs
may be specified as the data, which
contains all of the headers RFC6376 Section
5.4 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. |