Scroll to navigation

TLSRPT_INIT_POLICY(3) tlsrpt_init_policy TLSRPT_INIT_POLICY(3)

NAME

tlsrpt_init_policy - initializes a new policy within an existing delivery request

SYNOPSIS

#include <tlsrpt.h>

int tlsrpt_init_policy(struct tlsrpt_dr_t* dr, tlsrpt_policy_type_t policy_type, * const char* policydomainname)

DESCRIPTION

The tlsrpt_init_policy function initializes a new policy within an existing delivery request. A delivery request must contain at least one policy.

The policy must be properly completed by calls to some of the following functions and a final call to tlsrpt_finish_policy.


Note

An unfinished policy after some properly finished policies will result in the whole delivery request datagram to fail and not being sent out at all, so the other already completed policies won´t be reported either!

RETURN VALUE

The tlsrpt_init_policy 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

tlsrpt_finish_policy(3), tlsrpt_strerror(3), tlsrpt_error_code_is_internal(3)

AUTHOR(S)

Boris Lohner

Author(s).
2024-11-06 tlsrpt_init_policy