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]
