---
name: "tlsrpt_add_delivery_request_failure"
section: "3"
platform: "linux"
package: "libtlsrpt"
version: "0.5.1-1"
release: "Arch Linux 2026-11-01"
platforms: ["linux"]
url: "https://new.carta.tech/tlsrpt_add_delivery_request_failure"
---

# tlsrpt\_add\_delivery\_request\_failure(3)

adds a failure to the current policy

## NAME

tlsrpt\_add\_delivery\_request\_failure - adds a failure to the current policy

## SYNOPSIS

\#include \<tlsrpt.h\>

int tlsrpt\_add\_delivery\_request\_failure(struct tlsrpt\_dr\_t\* dr, tlsrpt\_failure\_t failure\_code, const char\* sending\_mta\_ip, const char\* receiving\_mx\_hostname, const char\* receiving\_mx\_helo, const char\* receiving\_ip, const char\* additional\_information, const char\* failure\_reason\_code)

## DESCRIPTION

The `tlsrpt_add_delivery_request_failure` function adds a failure to the current policy. Multiple failures can be added within a policy.

Some of the parameters may be NULL and in this case will be omitted in the datagram.

## RETURN VALUE

The tlsrpt\_add\_delivery\_request\_failure function returns 0 on success and a combined error code on failure. The combined error code can be analyzed with the *tlsrpt\_strerror* function.

## SEE ALSO

man:tlsrpt\_strerror\[3\], man:tlsrpt\_error\_code\_is\_internal\[3\]

## AUTHOR

Boris Lohner