NAME

libnutclient - Network UPS Tools high-level client access library

SYNOPSIS

Note
Two NUT websites

This version of the page reflects NUT release v2.8.0 with codebase commited ff16dabca at 2022-04-04T11:04:28+00:00

Options, features and capabilities in current development (and future releases) are detailed on the main site and may differ from ones described here.

#include <nutclient.h>
Refer to this file for more information.

DESCRIPTION

The Network UPS Tools (NUT) nutclient library provides a number of useful functions for programs to use when communicating with upsd(8). It provides high-level representation of NUT data through client connection, devices, variables and commands. Unlike upsclient(3), all low-level protocol details are hidden.

State is maintained across calls in an opaque structure called NUTCLIENT_t. Callers are expected to create one per client connection. These will be provided to most of the nutclient functions. The format of this structure is subject to change, and client programs must not reference elements within it directly.

NUTCLIENT_t represents the common connection information. Derived versions exist for each connection type (NUTCLIENT_TCP_t for TCP connection; actually the unique connection type, NUTCLIENT_TCP_t can be passed as NUTCLIENT_t parameter).

See the nutclient.h header for more information.

ERROR HANDLING

There is currently no specific mechanism around error handling.

SEE ALSO