dkim_add_xtag()

[back to index]

SYNOPSIS
#include <dkim.h>
DKIM_STAT dkim_add_xtag(
	DKIM *dkim,
        const char *tag,
        const char *value);
);
Requests that the named tag and value be added to the signature header field when it gets generated by dkim_getsighdr().
DESCRIPTION
Called When dkim_add_xtag() can be called at any time prior to calling dkim_eom().
ARGUMENTS
ArgumentDescription
dkim Message-specific signing handle, returned by dkim_sign().
tag A pointer to a null-terminated string that specifies the tag name to be added to the signature. This must not be a tag that is already supported by the library, as those are generated automatically. It must also meet the syntax rules of RFC6376 Section 3.2.
value A pointer to a null-terminated string that specifies the tag value to be added to the signature. It must meet the syntax rules of RFC6376 Section 3.2.
RETURN VALUES
  • DKIM_STAT_OK -- success
  • DKIM_STAT_INVALID -- dkim referred to a verifying header rather than a signing header, or one of the provided values contained a syntax error, or the tag named is one already supported by the library, or the named tag has already been added to the signature
  • DKIM_STAT_NORESOURCE -- out of memory
  • DKIM_STAT_NOTIMPLEMENT -- feature is not implemented for this installation
NOTES
  • It is legal to include whitespace in values according to RFC6376 Section 3.2. However, this will interefere with the automatic wrapping and formatting of the signature performed by the library. A mechanism to indicate valid line break points will be included in a future release.

Copyright (c) 2007 Sendmail, Inc. and its suppliers. All rights reserved.
Copyright (c) 2011, The Trusted Domain Project. All rights reserved.
By using this file, you agree to the terms and conditions set forth in the respective licenses.