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

# libnutclient\_devices(3)

Device related functions in Network UPS Tools high-level client access library

## NAME

libnutclient\_devices, nutclient\_get\_devices, nutclient\_has\_device, nutclient\_get\_device\_description - Device related functions in Network UPS Tools high-level client access library

## SYNOPSIS

```
        #include <nutclient.h>
        typedef void* NUTCLIENT_t;
        typedef char** strarr;
        strarr nutclient_get_devices(NUTCLIENT_t client);
        int nutclient_has_device(NUTCLIENT_t client, const char* dev);
        char* nutclient_get_device_description(NUTCLIENT_t client, const char* dev);
```

## DESCRIPTION

These functions allow to manage devices.

• The **nutclient\_get\_devices()** function retrieves the list of devices monitored by a client.

The returned strarr must be freed by *strarr\_free* (see [**libnutclient\_general**(3)](/libnutclient_general/3.md)).

• The **nutclient\_has\_device()** function tests if a device is monitored by a client.

• The **nutclient\_get\_device\_description()** function retrieves the device description.

The returned description string must be freed by [**free**(3)](/free/3.md).

Common arguments:

• *dev* is the device name.

## SEE ALSO

[**libnutclient**(3)](/libnutclient/3.md) [**libnutclient\_commands**(3)](/libnutclient_commands/3.md) [**libnutclient\_devices**(3)](/libnutclient_devices/3.md) [**libnutclient\_general**(3)](/libnutclient_general/3.md) [**libnutclient\_variables**(3)](/libnutclient_variables/3.md)