1UPSCLI_CONNECT(3) NUT Manual UPSCLI_CONNECT(3)
2
3
4
6 upscli_connect - Open a connection to a NUT upsd
7
9 #include <upsclient.h>
10
11 int upscli_connect(UPSCONN_t *ups, const char *host, int port, int flags);
12
14 The upscli_connect() function takes the pointer ups to a UPSCONN_t
15 state structure and opens a TCP connection to the host on the given
16 port.
17
18 flags may be either UPSCLI_CONN_TRYSSL to try a SSL connection, or
19 UPSCLI_CONN_REQSSL to require a SSL connection.
20
21 If SSL mode is required, this function will only return successfully if
22 it is able to establish a SSL connection with the server. Possible
23 reasons for failure include no SSL support on the server, and if
24 upsclient itself hasn’t been compiled with SSL support.
25
26 You must call upscli_disconnect(3) when finished with a connection, or
27 your program will slowly leak memory and file descriptors.
28
30 The upscli_connect() function modifies the UPSCONN_t structure and
31 returns 0 on success, or -1 if an error occurs.
32
34 upscli_disconnect(3), upscli_fd(3), upscli_splitaddr(3),
35 upscli_splitname(3), upscli_ssl(3), upscli_strerror(3),
36 upscli_upserror(3)
37
38
39
40Network UPS Tools 2.7.3. 03/02/2016 UPSCLI_CONNECT(3)