'\" t
.\"     Title: tlsrpt_open
.\"    Author: Boris Lohner
.\" Generator: Asciidoctor 2.0.26
.\"      Date: 2026-09-01
.\"    Manual: tlsrpt_open
.\"    Source: tlsrpt_open
.\"  Language: English
.\"
.TH "TLSRPT_OPEN" "3" "2026-09-01" "tlsrpt_open" "tlsrpt_open"
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.ss \n[.ss] 0
.nh
.ad l
.de URL
\fI\\$2\fP <\\$1>\\$3
..
.als MTO URL
.if \n[.g] \{\
.  mso www.tmac
.  am URL
.    ad l
.  .
.  am MTO
.    ad l
.  .
.  LINKSTYLE blue R < >
.\}
.SH "NAME"
tlsrpt_open \- `tlsrpt_open` allocates and initializes the `struct tlsrpt_connection_t` object
.SH "SYNOPSIS"
.sp
#include <tlsrpt.h>
.sp
int tlsrpt_open(struct tlsrpt_connection_t** pcon, const char* socketname)
.SH "DESCRIPTION"
.sp
The function \f(CRtlsrpt_open\fP allocates and initializes the \f(CRstruct tlsrpt_connection_t\fP object.
This function creates the socket and initializes the destination socket address of the TLSRPT collectd.
There is no actual connection internally, the socket is a connection\-less datagram socket.
.SH "RETURN VALUE"
.sp
The tlsrpt_open function returns 0 on success and a combined error code on failure.
The combined error code can be analyzed with the \fItlsrpt_strerror\fP function.
.SH "SEE ALSO"
.sp
man:tlsrpt_close[3], man:tlsrpt_strerror[3], man:tlsrpt_error_code_is_internal[3]
.SH "AUTHOR"
.sp
Boris Lohner