---
name: "upscli_disconnect"
section: "3"
platform: "linux"
package: "nut"
version: "2.8.5-2"
release: "Arch Linux 2026-11-01"
platforms: ["linux"]
url: "https://new.carta.tech/upscli_disconnect"
---

# upscli\_disconnect(3)

Disconnect from a UPS server

## 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

[**upscli\_connect**(3)](/upscli_connect/3.md), [**upscli\_fd**(3)](/upscli_fd/3.md), [**upscli\_strerror**(3)](/upscli_strerror/3.md), [**upscli\_upserror**(3)](/upscli_upserror/3.md)