upscli_upserror(3)

upscli_upserror3

Get current error number for connection

Usage

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

Overview

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) which might not support a given command.

Some error messages have additional meanings, so you should use upscli_strerror(3) 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.

Releases

10 releases since Debian 5.0 (Lenny); the text changed 6 times.

  1. 5.0–6.0
  2. 7
  3. 8
  4. 9–11
  5. 12
  6. 13
  7. Arch

From nut 2.8.5-2 in Arch Linux 2026-11-01. Parsed by carta from the page's man source.