| 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.
|