---
name: "upscli_upserror"
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_upserror"
---

# upscli\_upserror(3)

Get current error number for connection

## NAME

upscli\_upserror - Get current error number for connection

## SYNOPSIS

```
        #include <upsclient.h>
        int upscli_upserror(UPSCONN_t *ups);
```

## DESCRIPTION

The **upscli\_upserror**() function takes the pointer *ups* to a UPSCONN\_t state structure and returns the value of the internal error number, if any.

This is typically used to check for certain error values like UPSCLI\_ERR\_UNKCOMMAND. That specific error can be used for detecting older versions of [**upsd**(8)](/upsd/8.md) which might not support a given command.

Some error messages have additional meanings, so you should use [**upscli\_strerror**(3)](/upscli_strerror/3.md) to obtain readable error messages.

## RETURN VALUE

The **upscli\_upserror**() function returns one of the UPSCLI\_ERR\_\* values from upsclient.h, or *0* if no error has occurred.

## SEE ALSO

[**upscli\_readline**(3)](/upscli_readline/3.md), [**upscli\_sendline**(3)](/upscli_sendline/3.md), [**upscli\_strerror**(3)](/upscli_strerror/3.md)