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

tlsrpt_init_policy                2024-11-06             TLSRPT_INIT_POLICY(3)