UPSCLI_DISCONNECT(3)
====================

NAME
----

upscli_disconnect - disconnect from a UPS server

SYNOPSIS
--------

 #include <upsclient.h>

 int upscli_disconnect(UPSCONN_t *ups);

DESCRIPTION
-----------
The *upscli_disconnect()* function takes the pointer 'ups' to a
`UPSCONN_t` state structure, shuts down the connection to the server, and 
frees dynamic memory used by the state structure.  The `UPSCONN_t` structure
is no longer valid after this function is called.

This function must be called, or your program will leak memory and
file descriptors.

RETURN VALUE
------------

The *upscli_disconnect()* function returns 0 on success, or -1 if an
error occurs.

SEE ALSO
--------
linkman:upscli_connect[3], linkman:upscli_fd[3], 
linkman:upscli_strerror[3], linkman:upscli_upserror[3]
