# DK_STAT

DESCRIPTION |
Purpose | A `DK_STAT` is a return value from `libdk` functions, either as a direct return value or a returned parameter.
Possible Values | `DK_STAT_OK` -- successful completion `DK_STAT_BADSIG` -- signature did not match headers and body `DK_STAT_NOSIG` -- no signature present `DK_STAT_NOKEY` -- no key available for verifying `DK_STAT_CANTVRFY` -- can't get key for verifying `DK_STAT_SYNTAX` -- message is not in valid syntax `DK_STAT_NORESOURCE` -- resource unavailable `DK_STAT_INTERNAL` -- internal error
NOTES | `DK_STAT_NOKEY` is returned if the DNS query for a selector (public key) record returned with `NXDOMAIN`, i.e. the record does not exist; this should be considered a permanent failure. `DK_STAT_CANTVRFY` is returned if the DNS query for a selector (public key) record timed out or suffered some other kind of transient failure; verification can be re-attempted later. `DK_STAT_SYNTAX` is returned to indicate required data could not be extracted from the arriving message to be signed or verified, or if a selector (public key) record returned from a DNS query could not be parsed (e.g. corrupted, wrong format, etc.). `DK_STAT_NOSIG` can be returned early, i.e. from `dk_eoh()`, if no signature was found on a message which is being verified. See that function's description for further details. `DK_STAT_INTERNAL` can be returned on system error (e.g. `malloc()` failure), or if functions provided by this API are called in the incorrect order (e.g. `dk_getsig()` before `dk_eom()`, or `dk_eoh()` before `dk_header()`, etc.).

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