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  connection,  or
       UPSCLI_CONN_REQSSL to require a SSL connection.

       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  structure  and
       returns 0 on success, or -1 if an error occurs.

SEE ALSO

       upscli_disconnect(3), upscli_fd(3), upscli_splitaddr(3),  upscli_split-
       name(3), upscli_ssl(3), upscli_strerror(3), upscli_upserror(3)



                                Mon Jan 22 2007              UPSCLI_CONNECT(3)