36 lines
800 B
Text
36 lines
800 B
Text
|
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]
|