SYNOPSIS |
#include <dk.h>
DK_STAT dk_options(
DK *dk,
int op,
int *opts
);
Sets or retrieves options to alter the behaviour of certain aspects
of the library's operation.
|
DESCRIPTION |
Called When |
dk_options() can be called at any time after acquiring
a transaction handle from either
dk_sign() or
dk_verify(). However, the impact
of certain options may not take effect after specific points in a
transaction. |
|
---|
ARGUMENTS |
Argument | Description |
dk |
Message-specific handle, returned by
dk_sign() or
dk_verify.
|
op |
Either DK_OP_SETOPT to set the current library
options, or DK_OP_GETOPT to retrieve the current library
options.
|
opts |
A pointer to an int which either contains the desired
set of new options (when op is DK_OP_SETOPT),
or should be updated to contain the current set of options
(when op is DK_OP_GETOPT).
|
|
NOTES |
- The supported options are:
- DK_OPTS_HDRLIST -- when signing, group like headers
together during canonicalization so that there is no duplication
in the header list ("h=") portion of the signature
- DK_OPTS_TMPFILES -- preserve temporary files on disk
for debugging purposes
- This function is a local addition to the formal API specification
and is experimental only. It may not appear in other implementations.
|