UPSCLI_CONNECT(3) Network UPS Tools (NUT) UPSCLI_CONNECT(3)NAMEupscli_connect - Open a connection to a NUT upsd
SYNOPSIS
#include <upsclient.h>
int upscli_connect(UPSCONN *ups, const char *host, int port, int flags);
DESCRIPTION
The upscli_connect() function takes the pointer ups to a
UPSCONN state structure and opens a TCP connection to the
host on the given port.
flags may be either UPSCLI_CONN_TRYSSL to try a SSL con-
nection, or UPSCLI_CONN_REQSSL to require a SSL connec-
tion.
If SSL mode is required, this function will only return
successfully if it is able to establish a SSL connection
with the server. Possible reasons for failure include no
SSL support on the server, and if upsclient itself hasn't
been compiled with SSL support.
You must call upscli_disconnect(3) when finished with a
connection, or your program will slowly leak memory and
file descriptors.
RETURN VALUE
The upscli_connect() function modifies the UPSCONN struc-
ture and returns 0 on success, or -1 if an error occurs.
SEE ALSOupscli_getvar(3), upscli_getlist(3), upscli_readline(3),
upscli_sendline(3), upscli_splitname(3), upscli_str-
error(3)
Wed Oct 16 2002 UPSCLI_CONNECT(3)