1UPSCLI_CONNECT(3)                 NUT Manual                 UPSCLI_CONNECT(3)
2
3
4

NAME

6       upscli_connect - Open a connection to a NUT upsd
7

SYNOPSIS

9       #include <upsclient.h>
10
11       int upscli_connect(UPSCONN_t *ups, const char *host, int port, int flags);
12

DESCRIPTION

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

RETURN VALUE

30       The upscli_connect() function modifies the UPSCONN_t structure and
31       returns 0 on success, or -1 if an error occurs.
32

SEE ALSO

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                 09/15/2011                 UPSCLI_CONNECT(3)
Impressum