dk_options()

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

Copyright (c) 2004, 2006 Sendmail, Inc. and its suppliers. All rights reserved.
By using this file, you agree to the terms and conditions set forth in the LICENSE.